Hvordan bruke API-ene til Sitata for å bestemme reisebegrensninger for reisende

Skrevet av Madeline Sharpe

22. desember 2020

Teknologi

Beaucoup d'entre vous ne le savent peut-être pas, mais les premières fondations de Sitata ont été construites pour la détection précoce des maladies. En fait, notre fondatrice a organisé un discours TedX à partir de 2016 sur les raisons pour lesquelles nous devons avertir les voyageurs afin de prévenir la propagation des maladies. Il n'est donc pas surprenant que nous ayons appris l'existence du COVID-19, qui a été signalé comme un groupe inhabituel de cas de pneumonie au début du mois de décembre 2019. Le 2 janvier 2020, notre équipe de santé a décidé que nous devions émettre un premier avertissement à nos voyageurs et partenaires commerciaux. 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. La maladie se propageait si rapidement qu'il était clair pour nous que la réponse mondiale serait au mieux chaotique. Chaque pays allait promulguer ses propres règlements et règles pour contrôler la propagation. Cela allait inévitablement faire des ravages dans le monde entier et être une énorme source de confusion pour ceux qui souhaitaient encore voyager. Nous avions raison et nous avons décidé de faire quelque chose pour y remédier. Sitata var en av de første bedriftene i verden som opprettet en egen API og en tjeneste for å følge med på endringer i reiserestriksjoner og innreisevilkår som følge av covid-19. Takket være et avansert system for hendelsesdeteksjon og et team av spesialiserte analytikere har vi allerede alle verktøyene og prosessene som trengs for å lykkes.

Depuis le lancement de ce nouveau service, plusieurs organisations ont tiré profit des données au profit de leurs propres clients, notamment Eddy Travels, Flight Centre et Etihad Airways ; d'autres informations seront bientôt annoncées ! Afin d'aider un plus grand nombre d'organisations axées sur les voyages à tirer profit de cette offre, nous avons rédigé en détail ci-dessous un certain nombre d'exemples pour expliquer comment utiliser l'API pour divers cas d'utilisation. J'espère que ces explications vous aideront à faire démarrer vos propres initiatives.

Betingelser for innreise

Les premiers 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. Nous avons créé l'ensemble de données sur les conditions d'entrée pour répondre aux questions difficiles du type "oui/non" concernant l'entrée dans un pays ou une région.

Au moment de la rédaction du présent document, cet ensemble de données comprenait les dix catégories distinctes suivantes :

  • Un résident peut-il entrer dans le pays ?
  • Un étranger peut-il entrer dans le pays ?
  • Le transit est-il autorisé à travers le pays ?
  • Un test est-il exigé à l'arrivée (apparition d'une maladie) ?
  • Un certificat de test est-il autorisé (apparition d'une maladie) ?
  • Er en karantene nødvendig ved ankomst (forekomst av en sykdom)? Une vaccination est-elle nécessaire ?
  • Forsikringskrav ?
  • Certificat de test requis ?
  • Formulaire d'inscription requis ? (santé ou autre)

Chaque catégorie peut avoir l'une des valeurs suivantes :

  • Oui
  • Oui, avec des exceptions
  • Ikke
  • Non, sauf unntak

Si la grande majorité des valeurs sont "oui" et "non", la situation sur le terrain n'est pas toujours aussi simple. 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" (noen ganger finnes det virkelig merkelige og gale regler som ulike regjeringer har innført, og som krever "unntak").

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. Samlet sett dekker Sitata for tiden data på landnivå. Toutefois, nous disposons de quelques enregistrements d'états/provinces pour certaines régions, comme les États-Unis et d'autres.

Tout enregistrement comportant une entrée sous le champ origine_pays_division_id ou origine_pays_région_id est un niveau qui se situe respectivement au niveau de l'État ou au niveau municipal. Si vous souhaitez disposer de données plus granulaires, veuillez nous contacter et nous pourrons discuter de votre cas d'utilisation.

Veuillez prendre le temps de vous familiariser avec la structure des données des conditions d'entrée en consultant nos dokumenter API her.

Une partie de la structure des données est légèrement déroutante, à savoir notre utilisation du terme"opprinnelse" 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.

Et annet viktig punkt å merke seg er hvordan listen over berørte land fungerer. Hvis affected_countries er tom, skal det tolkes som en global regel, dvs. at alle land er berørt.

Noen eksempler

Comme vous avez pu le constater dans la documentation, il existe plusieurs façons de récupérer les données de l'API. Ci-dessous, nous allons passer en revue quelques-uns des cas d'utilisation les plus courants.

Comment obtenir les exigences entre deux pays ?

Il existe plusieurs façons de faire ce type de demande. La version la plus simple consiste à utiliser le destinasjon et départ paramètres. Ces paramètres acceptent les codes ISO 3166-1 alfa-2 comme entrées

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

Svaret vil omfatte alle krav (på land- og delstatsnivå) som er nødvendige å forstå for den reisende som reiser fra avgangslandet og til bestemmelseslandet.

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

Sitata dispose de données au niveau de l'État pour certaines régions. Vous saurez qu'une entrée particulière est pour un État si le origine_pays_division a une valeur. Vous pouvez également filtrer pour ne récupérer que les données au niveau de l'état en utilisant le champ destination_pays_division paramètre. Il attend une valeur ISO_3166-2. Par exemple, US-TX pour le Texas, États-Unis.

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

Notez qu'il pourrait être plus simple d'effectuer une recherche par pays, puis de filtrer les données par État pour voir si ces données existent, et de les utiliser si elles existent.

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

Tout comme pour les pays, l'API Sitata peut renvoyer les résultats entre deux aéroports. Les paramètres départ_aéroport et destinasjon_aéroport utiliser les codes 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.

Et si je n'ai que des informations sur la ville ?

Sitata har valgt å ikke svare på forespørsler som gjelder et bestemt stedsnavn, da dette kan føre til konflikter og forvirring. I stedet har vi valgt å akseptere API-forespørsler med bredde- og lengdegradskoordinater, noe som ikke gir noen tvetydighet i resultatene. Parametrene er følgende départ_lat, departure_lng, destinasjon_latet destinasjon_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

Si vous résolvez vos villes en fonction des lieux et des requêtes en fonction des coordonnées, notre API répondra avec toutes les restrictions (au niveau du pays et de l'État) nécessaires à la compréhension du voyageur qui part du pays de départ et se rend dans le pays de destination.

Tilleggsinformasjon

Pour certaines 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é Statister. Ce champ est un mappage clé/valeur de divers éléments d'information supplémentaires pour une exigence particulière.

Quel est le nombre de jours de quarantaine?

Cette saisie de données est soumise à l'obligation de saisie type 5. Dans cette entrée, le Statister 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 ?

Cette saisie de données est soumise à l'obligation de saisie type 8. Dans cette entrée, le Statister 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.

Faites-nous savoir

Nous pensons que nous disposons d'un outil très robuste qui répondra probablement à tous vos besoins pour aider vos voyageurs à comprendre ce qu'ils sont susceptibles de rencontrer en cours de route. Si vous avez un cas d'utilisation particulier que nous ne traitons pas, faites-le nous savoir !

Attendez... il y a plus !

Cette entrée fait partie d'une série de deux parties qui expliquent comment interagir avec l'API Sitata pour les informations sur les conditions d'entrée et les restrictions de voyage. 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 documentation sur l'API en ledsager.

Vennligst følg og lik oss:

Relaterte artikler

From Metro to Marathon: Transportation Tips for The Paris Olympics

From Metro to Marathon: Transportation Tips for The Paris Olympics

Millions of people are expected to visit Paris for the 2024 Summer Olympic and Paralympic Games from 26 July to 11 August and 28 August to 8 September. Are you also gearing up to witness the games this year and looking for a perfect travel guide? Consider it done,...

Høypatogen fugleinfluensa - H5N1

Høypatogen fugleinfluensa - H5N1

Det finnes en stamme av influensaviruset H5N1 som er svært dødelig for ville fugler og tamme høns (kyllinger, ender osv.). Den har forårsaket store utbrudd i tamme kyllingflokker de siste tiårene. I sjeldne tilfeller har dette viruset smittet mennesker som...