Comment utiliser les API de Sitata pour déterminer les restrictions de voyage pour les voyageurs

Written by Madeline Sharpe

décembre 22, 2020

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 a été l’une des premières entreprises au monde à créer une API dédiée et un service de suivi des changements apportés aux restrictions de voyage et aux conditions d’entrée suite à COVID-19. Grâce à un système logiciel avancé de détection des événements et à une équipe d’analystes spécialisés, nous disposions déjà de tous les outils et processus nécessaires pour y parvenir.

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.

Conditions d’entrée

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. 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) ?
  • Une quarantaine est-elle nécessaire à l’arrivée (apparition d’une maladie) ? Une vaccination est-elle nécessaire ?
  • Assurance requise ?
  • 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
  • Non
  • Non, sauf exceptions

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 »

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. Dans l’ensemble, Sitata couvre actuellement les données au niveau des pays. 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 documents API ici.

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.

Quelques exemples

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 destination et départ paramètres. Ces paramètres acceptent les codes ISO 3166-1 alpha-2 comme entrées

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

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 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/travel_restrictions?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 destination_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/travel_restrictions?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 a choisi de ne pas répondre aux demandes portant sur un nom de ville particulier, car cela pourrait entraîner des conflits et des confusions. Au lieu de cela, nous avons choisi d’accepter les requêtes de notre API par coordonnées de latitude et de longitude, ce qui ne produit aucune ambiguïté dans notre ensemble de résultats. Les paramètres sont les suivants départ_lat, departure_lng, destination_latet destination_lng.

GET https://www.sitata.com/api/v2/travel_restrictions?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.

Informations supplémentaires

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é extras. 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 extras 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 extras 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 attendant.

Other Articles

Aucun résultat

La page demandée est introuvable. Essayez d'affiner votre recherche ou utilisez le panneau de navigation ci-dessus pour localiser l'article.

0 Comments

0 commentaires

Soumettre un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Stay Up to Date With The Latest News & Updates

Travel Protection For Any Traveller

We keep you safe when you travel with real-time notifications about travel disruptions and easy access to help.

Join Our Newsletter

Follow Us

Connect with us on social media and stay up to date with our latest updates.