
Mulți dintre voi nu știu, dar primele fundații Sitata au fost construite pentru detectarea precoce a bolilor. En fait, notre fondatrice a organisé un discours TedX à partir de 2016 sur les motive pentru care trebuie să ne ferim de călători pentru a preveni propagarea bolilor. Prin urmare, nu este surprinzător faptul că am aflat de existența COVID-19, care a fost semnalat ca un grup inhabitual de cazuri de pneumonie la începutul lunii decembrie 2019. Le 2 janvier 2020, notre équipe de santé a décidé que nous devions émettre un primul avertisment 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 eu une révélation. Boala s-a răspândit atât de rapid încât era clar pentru noi că răspunsul mondial ar fi mai degrabă haotic. Fiecare țară urma să își promulge propriile reglementări și reguli pentru a controla propagarea. În mod inevitabil, acest lucru va face ravagii în întreaga lume și va fi o sursă enormă de confuzie pentru cei care vor dori să călătorească. Am avut dreptate și am decis să facem ceva pentru a ne reveni. Sitata a fost una dintre primele întreprinderi din lume care a creat un 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 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 profitat de date în beneficiul 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 că aceste explicații vă vor ajuta să vă demarați propriile inițiative.
Primele întrebări pe care și le pune un călător sunt fără niciun dubiu: "Puis-je y aller ?" și "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" privind intrarea într-o țară sau într-o regiune.
Au moment de la rédaction du présent document, cet ensemble de données comprenait les dix catégories distinctes suivantes :
Fiecare categorie poate avea una dintre următoarele valori :
Dacă marea majoritate a valorilor sunt "da" și "nu", situația pe teren nu este întotdeauna la fel de simplă. Parfois, il existe des règles vraiment bizarres et folles que divers gouvernements ont mises en place et qui nécessitent les types de valeurs "avec exceptions"
Une condition d'entrée est essentiellement un document qui documente un ensemble de règles imposées par un acteur à l'encontre d'un ou de plusieurs autres pays ou régions. L'acteur peut être un pays, un État ou même une municipalité dans notre architecture de données. În ansamblu, Sitata acoperă în prezent datele la nivel de țară. Toutefois, nous disposons de quelques enregistrements d'états/provinces pour certaines régions, comme les États-Unis et d'autres
Orice înregistrare care conține o intrare sub câmp origine_plati_diviziune_id
ou origine_pays_région_id
est un niveau qui se situe respectivement au niveau de l'État ou au niveau municipal. Dacă doriți să dispuneți de date mai detaliate, vă rugăm ne contactați și vom discuta despre cazul dumneavoastră de utilizare.
Vă rugăm să vă familiarizați cu structura datelor din condițiile de intrare în consultant documentele noastre API aici.
Une partie de la structure des données est légèrement déroutante, à savoir notre utilisation du terme"origine" Cette confusion est due au fait que les développeurs considèrent souvent l'origine comme étant le lieu d'origine ou le lieu de départ. Or, ce que nous entendons par "origine" est en fait l'origine de la règle imposée à d'autres, c'est-à-dire le pays ou la région qui a créé la restriction.
Un alt punct important de reținut este modul în care funcționează lista noastră de țări afectate. Dacă affected_countries este gol, ar trebui interpretat ca o regulă globală, adică toate țările sunt afectate.
Așa cum ați putut constata în documentație, există mai multe modalități de recuperare a datelor API. În continuare, vom trece în revistă câteva dintre cazurile de utilizare cele mai curente.
Il existe plusieurs façons de faire ce type de demande. Versiunea cea mai simplă constă în utilizarea destinație
et plecare
parametri. Acești parametri acceptă codurile ISO 3166-1 alfa-2 ca antreuri
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 înțelegerea călătorului care pleacă din țara de plecare și călătorește către țara de destinație.
Sitata dispune de date la nivel de stat pentru anumite regiuni. Veți ști că o intrare specială este pentru un stat dacă origine_plati_diviziune
a une valeur. De asemenea, puteți filtra pentru a nu recupera decât datele la nivelul stării, utilizând câmpul destinație_plăți_diviziune
parametru. Il attend une valeur ISO_3166-2. De exemplu, US-TX pentru Texas, États-Unis.
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 căutare pe țară, apoi să filtrați datele pe stat pentru a vedea dacă aceste date există și să le utilizați dacă există.
La fel ca în cazul țărilor, API Sitata poate trimite rezultatele între două aeroporturi. Parametrii plecare_aeroport
et destinație_aeroport
utilizarea codurilor de l'OACI ou de l'IATA pour filtrer les résultats. La réponse comprendra toutes les restrictions (au niveau du pays et de l'État) nécessaires à la compréhension du voyageur partant du pays de départ correspondant et se rendant dans le pays de destination.
GET https://www.sitata.com/api/v2/entry_requirements?departure_airport=MUC&destination_airport=BOM
La réponse comprendra toutes les restrictions (au niveau du pays et de l'État) nécessaires à comprendre pour le voyageur qui part du pays de départ et se rend dans le pays de destination.
Sitata a ales să nu răspundă solicitărilor referitoare la un nume de oraș special, deoarece acest lucru ar putea genera conflicte și confuzii. În loc de aceasta, am ales să acceptăm solicitările API-ului nostru prin coordonate de latitudine și longitudine, ceea ce nu produce nicio ambiguitate în ansamblul nostru de rezultate. Parametrii sunt următorii plecare_lat
, plecare_lng
, destinație_lat
et 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 problemele legate de locații și solicitările legate de coordonate, API-ul nostru va răspunde cu 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.
Pour certains types de conditions d'entrée, il peut y avoir des données supplémentaires associées dans un champ de type de métadonnées appelé plusuri
. Acest câmp este o cartografiere cheie/valoare a diverselor elemente de informații suplimentare pentru o cerință specială
Această saisie de données est soumise à l'obligation de saisie tip 5. În această intrare, le plusuri
la cartographie contiendra un champ appelé quarantaine_days
qui contiendra un nombre entier pour le nombre de jours de quarantaine imposés.
Această saisie de données est soumise à l'obligation de saisie tip 8. În această intrare, le plusuri
la cartographie contiendra un champ appelé entry_hours
qui contiendra un nombre entier pour le nombre d'heures pendant lesquelles un test covid négatif est autorisé avant l'entrée.
Nous pensons que nous disposons d'un outil très robust qui répondra probablement à tous vos besoins pour aider vos voyageurs à comprendre ce qu'ils sont susceptibles de rencontrer en cours de route. Dacă aveți un caz particular de utilizare pe care nu îl vom descrie, spuneți-ne savoir !
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 privind condițiile de intrare și restricțiile de călătorie. Jusqu'à présent, nous avons parlé des conditions d'entrée qui décrivent les types de conditions strictes de type oui/non nécessaires pour entrer dans un pays ou une région, mais nous n'avons pas non plus parlé de ce qui se passe à l'intérieur du pays. C'est une chose de savoir comment entrer dans un pays, c'en est une autre de comprendre s'il est possible de se déplacer dans le pays ou de visiter les plages ou s'il y a un couvre-feu obligatoire.
Restez à l'écoute pour le deuxième article qui approfondira notre série de données sur les restrictions de voyage. Astuce : il est presque identique, vous pouvez donc toujours consulter notre documentație privind API en attendant.