logo-ul sitata

Cum se utilizează API de la Sitata pentru a determina restricțiile de călătorie pentru călători

10 septembrie 2024
Restricții de călătorie API

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.

Condiții de intrare

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 :

  • Un rezident poate intra în țară?
  • Un străin poate intra în țară?
  • Tranzitul este autorizat în întreaga țară?
  • Un test este necesar la sosirea (apariția unei boli)?
  • Un certificat de testare este autorizat (apariția unei boli)?
  • O carantină este necesară la sosire (apariția unei boli)? O vaccinare este necesară?
  • Assurance requise ?
  • Certificat de testare necesar?
  • Formulaire d'inscription requis ? (sănătate sau altul)

Fiecare categorie poate avea una dintre următoarele valori :

  • Da
  • Da, cu unele excepții
  • Nu
  • Nu, cu excepția excepțiilor

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.

Câteva exemple

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.

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

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.

Et si je veux des données au niveau de l'État ?

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ă.

Cum pot obține cerințele între două aeroporturi?

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.

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

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_latet 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.

Informații suplimentare

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ă

Quel est le nombre de jours de quarantaine ?

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.

Quel est le nombre d'heures avant l'entrée pour un test covid négatif ?

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.

Fă-ne să știm

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 !

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 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.

Asigurare de călătorie și asistență care vă ajută să aveți o călătorie mai bună

Vedeți de ce mii de călători aleg Sitata atunci când călătoresc

Copyright © 2025 Sitata Inc.
We've detected you might be speaking a different language. Do you want to change to:
en_US English
en_US English
es_ES Español
fr_FR Français
it_IT Italiano
de_DE Deutsch
hu_HU Magyar
ro_RO Română
ar العربية
pl_PL Polski
pt_PT Português
nl_NL Nederlands
sv_SE Svenska
fi Suomi
nb_NO Norsk bokmål
da_DK Dansk
Close and do not switch language