Mulți dintre voi nu știți poate că nu știți, dar primele fundații Sitata au fost construite pentru detectarea precoce a bolilor. De fapt, fondatoarea noastră a organizat un discurs TedX în 2016 despre motivele pentru care trebuie să ne ferim de călători pentru a preveni răspândirea bolilor. Prin urmare, nu este surprinzător că am aflat de existența COVID-19, care a fost semnalat ca un grup de cazuri de pneumonie la începutul lunii decembrie 2019. La 2 ianuarie 2020, echipa noastră de sănătate a decis că vom emite un prima avertizare pentru călătorii și partenerii noștri comerciali. C'était quelques jours avant même l'Organisation mondiale de la santé !

Lors des inévitables retombées, nous avons avut o revelație. Boala se propaga atât de rapid încât era clar pentru noi că răspunsul mondial va fi cel mai haotic. Fiecare țară urma să își promulge propriile reglementări și norme pentru a controla propagarea. Acest lucru va face inevitabil ravagii în întreaga lume și va fi o sursă enormă de confuzie pentru cei care doresc să mai călătorească. Aveam un motiv și am hotărât să facem ceva pentru a ne salva. Sitata a fost una dintre primele întreprinderi din lume care a creat o API dedicată și un serviciu de monitorizare a modificărilor aduse restricțiilor de călătorie și condițiilor de intrare în urma COVID-19. Datorită unui sistem software avansat de detectare a evenimentelor și a unei echipe de analiști specializați, dispunem deja de toate instrumentele și procesele necesare pentru a ajunge acolo.

De la lansarea acestui nou serviciu, mai multe organizații au extras profitul datelor în folosul propriilor clienți, în special Eddy Travels, Flight Centre și Etihad Airways; alte informații vor fi anunțate în curând! Pentru a ajuta un număr mai mare de organizații axate pe călătorii să profite de această ofertă, am redactat în detaliu mai jos un anumit număr de exemple pentru a explica cum să utilizați API-ul în diverse cazuri de utilizare. Sperăm că aceste explicații vă vor ajuta să vă dezvoltați propriile inițiative.

Condiții de intrare

Les premières questions qu'un voyageur se pose sont sans aucun doute : "Puis-je y aller ?" et "Serai-je mis en quarantaine", c'est donc un bon point de départ. Am creat un ansamblu de date privind condițiile de intrare pentru a răspunde la întrebările dificile de tipul "da/nu" referitoare la intrarea într-o țară sau o regiune.

La momentul redactării prezentului document, acest ansamblu de date cuprindea cele zece categorii distincte următoare :

• Un rezident poate intra în țară?
• Un străin poate intra în țară?
• Tranzitul este autorizat în întreaga țară?
• Un test este necesar la sosire (apariția unei boli)?
• Un certificat de testare este autorizat (apariția unei boli)?
• Une quarantaine est-elle nécessaire à l'arrivée (apparition d'une maladie)? Este necesară o vaccinare?
• Asigurare necesară?
• Certificat de test necesar ?
• Formularul de înscriere necesar ? (sănătate sau altceva)

Fiecare categorie poate avea una dintre valorile următoare :

• Oui
• Oui, avec des exceptions
• Non
• Non, sauf excepții

Dacă marea majoritate a valorilor sunt "da" și "nu", situația pe teren nu este întotdeauna la fel de simplă. Uneori, există reguli cu adevărat bizare și nebunești pe care diverse guverne le-au pus în aplicare și care necesită tipuri de valori "cu excepții".

Une condition d'entrée est essentiellement un document care conține un ansamblu de norme impuse de un actor față de unul sau mai multe alte țări sau regiuni. În arhitectura noastră de date, actorul poate fi o țară, un stat sau chiar o municipalitate. În ansamblu, Sitata acoperă în prezent datele la nivel de țară. Cu toate acestea, dispunem de câteva înregistrări de state/provincii pentru anumite regiuni, cum ar fi Statele Unite și altele.

Orice înregistrare care conține o intrare în câmp origine_pays_division_id ou origine_pays_région_id este un nivel care se situează respectiv la nivelul statului sau la nivelul municipal. Dacă doriți să dispuneți de date mai detaliate, vă rugăm să vă adresați la ne contactați și vom discuta cu dumneavoastră despre cazul dumneavoastră de utilizare.

Vă rugăm să vă luați timpul necesar pentru a vă familiariza cu structura datelor din condițiile de intrare în calitate de consultant. nos documents API ici.

Une partie de la structure des données est légèrement déroutante, à savoir notre utilisation du terme"origine" Această confuzie se datorează faptului că dezvoltatorii consideră adesea originea ca fiind locul de origine sau locul de plecare. Or, ceea ce înțelegem prin "origine" este de fapt originea reglementării impuse altora, adică țara sau regiunea care a creat restricția.

Un alt aspect important de reținut este modul în care funcționează lista țărilor afectate. Dacă affected_countries este goală, aceasta trebuie interpretată ca o regulă globală, adică toate țările sunt afectate.

Câteva exemple

După cum ați putut constata în documentație, există mai multe moduri de a recupera datele din API. În cele ce urmează, vom trece în revistă câteva dintre cele mai frecvente cazuri de utilizare.

Cum se obțin cerințele între două țări?

Există mai multe modalități de a face acest tip de cerere. Versiunea cea mai simplă constă în a utiliza destinație și départ parametri. Acești parametri acceptă codurile ISO 3166-1 alfa-2 ca intrări

GET https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination=IN

Răspunsul va include toate cerințele (la nivel de țară și de stat) necesare pentru a înțelege pentru călătorul care pleacă din țara de plecare și se deplasează în țara de destinație.

Și dacă vreau date la nivel de stat?

Sitata dispune de date la nivel de stat pentru anumite regiuni. Puteți verifica dacă o intrare particulară este pentru un stat dacă origine_pays_division a une valeur. Puteți, de asemenea, să filtrați pentru a nu mai recupera decât datele la nivel de stare, utilizând câmpul destinația_diviziune_de_plată paramètre. Se așteaptă o valoare ISO_3166-2. De exemplu, US-TX pentru Texas, Statele Unite.

GET https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination_country_division=IN-AP

Rețineți că ar putea fi mai simplu să efectuați o cercetare pe țări, apoi să filtrați datele pe state pentru a vedea dacă există aceste date și să le utilizați dacă există.

Comment puis-je obtenir les exigences entre deux aéroports?

La fel ca în cazul țărilor, API Sitata poate trimite rezultatele între două aeroporturi. Parametrii départ_aéroport și destination_aéroport utiliser les codes de l'OACI ou de l'IATA pentru a filtra rezultatele. Răspunsul cuprinde toate restricțiile (la nivel de țară și de stat) necesare pentru înțelegerea călătorului care pleacă din țara de plecare și se întoarce în țara de destinație.

GET https://www.sitata.com/api/v2/entry_requirements?departure_airport=MUC&destination_airport=BOM

Răspunsul cuprinde toate restricțiile (la nivel de țară și de stat) necesare pentru călătorul care pleacă din țara de plecare și se întoarce în țara de destinație.

Și dacă nu am decât informații despre oraș?

Sitata a ales să nu răspundă la cererile privind un nume de oraș anume, deoarece acest lucru ar putea genera conflicte și confuzii. În loc de aceasta, am ales să acceptăm cererile API-ului nostru prin coordonate de latitudine și longitudine, ceea ce nu produce nicio ambiguitate în ansamblul nostru de rezultate. Parametrii sunt următorii départ_lat, plecare_lng, destinație_latși destinație_lng.

GET https://www.sitata.com/api/v2/entry_requirements?departure_lat=48.13743&departure_lng=11.57549&destination_lat=19.0760&destination_lng=72.8777

Dacă vă rezolvați orașele în funcție de locații și cererile în funcție de coordonate, API-ul nostru răspunde cu toate restricțiile (la nivelul țării și al statului) necesare pentru înțelegerea călătorului care pleacă din țara de plecare și se întoarce în țara de destinație.

Informații suplimentare

Pentru anumite tipuri de condiții de intrare, se pot avea date suplimentare asociate într-un câmp de tip de metadonați numit figuranți. Acest câmp este o hartă cheie/valoare a diverselor elemente de informații suplimentare pentru o cerință particulară.

Care este numărul de zile de patruzeci?

Această înregistrare de date este supusă obligației de înregistrare. tip 5. În această intrare, le figuranți la cartographie contiendra un câmp numit quarantaine_days care conține un număr întreg pentru numărul de zile de patruzeci de zile impuse.

Care este numărul de ore înainte de intrare pentru un test covid negativ?

Această înregistrare de date este supusă obligației de înregistrare. tip 8. În această intrare, le figuranți la cartographie contiendra un câmp numit orele_de_intrare care conține un număr întreg pentru numărul de ore în timpul cărora este autorizat un test negativ de covidă înainte de intrare.

Fă-ne să știm

Credem că dispunem de un instrument foarte robust care răspunde probabil tuturor nevoilor dumneavoastră pentru a vă ajuta călătorii să înțeleagă ceea ce sunt susceptibili să întâlnească în timpul călătoriei. Dacă aveți un caz special de utilizare pe care nu îl tratăm, vă rugăm să ne spuneți savoir !

Attendez... il y a plus!

Această intrare face parte dintr-o serie de două părți care explică cum să interacționați cu API Sitata pentru informații despre condițiile de intrare și restricțiile de călătorie. Până în prezent, am vorbit despre condițiile de intrare care descriu tipurile de condiții stricte de tip da/nu sunt necesare pentru a intra într-o țară sau o regiune, dar nu am mai vorbit despre ceea ce se întâmplă în interiorul țării. Este vorba despre o chestiune de a ști cum să intrați într-o țară, dar este o altă chestiune de a înțelege dacă este posibil să vă deplasați în țară sau să vizitați plajele sau dacă există un couvre-feu obligatoriu.

Rămâneți cu noi pentru cel de-al doilea articol, care prezintă seria noastră de date despre restricțiile de călătorie. Astuce : este aproape identic, puteți consulta întotdeauna articolul nostru documentație despre API en attendant.

Vă rugăm să ne urmăriți și să ne dați like: