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 fondateur a donné une conférence TedX en 2016 sur la détection précoce des maladies. pourquoi il faut avertir les voyageurs pour éviter la propagation des maladies. Il n'est donc pas surprenant que nous nous soyons intéressés au COVID-19 lorsqu'il 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éterminé que nous devions émettre des notre premier avertissement à nos voyageurs et à nos partenaires commerciaux. C'était bien avant l'Organisation mondiale de la santé !

Au cours 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 adopterait son propre ensemble de réglementations et de règles pour contrôler la propagation. Cela aurait inévitablement des répercussions sur les voyages dans le monde entier et serait une source de confusion énorme pour ceux qui souhaiteraient 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 et un service de surveillance dédiés aux modifications des restrictions de voyage et des conditions d'entrée résultant du COVID-19. Avec un système logiciel avancé pour la détection des événements et une équipe d'analystes dédiée, nous avions déjà tous les bons outils et processus en place pour le faire.

Depuis le lancement de ce nouveau service, plusieurs organisations ont profité des données pour leurs propres clients, notamment Eddy Travels, Flight Centre et Etihad Airways, et d'autres seront bientôt annoncées ! Afin d'aider un plus grand nombre d'organisations axées sur le voyage à bénéficier de cette offre, nous avons écrit en détail ci-dessous un certain nombre d'exemples pour expliquer comment utiliser l'API pour une variété de cas d'utilisation. J'espère que ces explications vous aideront à lancer vos propres initiatives.

Conditions d'admission

Il ne fait aucun doute que les premières questions qu'un voyageur se pose sont "puis-je aller là-bas ?" et "serai-je mis en quarantaine". 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é dans le pays ?
• Un test est-il exigé à l'arrivée (épidémie) ?
• Un certificat de test est-il autorisé (épidémie) ?
• Une quarantaine est-elle requise à l'arrivée (épidémie) ? Une vaccination est-elle nécessaire ?
• Assurance requise ?
• Certificat d'essai 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 les différents gouvernements ont mises en place et qui nécessitent les types de valeurs "avec des exceptions".

Une condition d'entrée est essentiellement un enregistrement documentant 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 national. Cependant, nous disposons de quelques enregistrements d'états/provinces pour des régions sélectionnées telles que les Etats-Unis et d'autres.

Tout enregistrement comportant une entrée dans le champ origine_pays_division_id ou origine_pays_région_id est une donnée au niveau de l'État ou de la municipalité, respectivement. Si vous souhaitez obtenir des données plus détaillées, veuillez contacter nous contacter et nous pourrons discuter de votre cas d'utilisation.

Veuillez prendre le temps de vous familiariser avec la structure des données relatives aux conditions d'entrée en prenant les mesures suivantes consultez notre documentation sur l'API ici.

Une partie de la structure des données qui prête un peu à confusion est l'utilisation du terme "origine." Cela prête à confusion car les développeurs pensent souvent que l'origine est le lieu d'origine ou le lieu de départ. Cependant, ce que nous entendons par origine est en fait l'origine de la règle imposée aux autres, c'est-à-dire le pays ou la région qui a créé la restriction.

Un autre point important à noter est le fonctionnement de la liste des pays concernés. Si le champ affected_countries est vide, il doit être interprété comme une règle globale, c'est-à-dire que tous les pays sont concernés.

Quelques exemples

Comme vous avez pu le constater dans la documentation, il existe un certain nombre de façons d'extraire des données de l'API. Nous allons voir ci-dessous quelques-uns des cas d'utilisation les plus courants.

Comment récupérer les besoins entre deux pays ?

Il existe plusieurs façons d'effectuer ce type de demande. La version la plus simple consiste à utiliser la fonction destination et départ paramètres. Ces paramètres acceptent ISO 3166-1 alpha-2 en tant que données d'entrée.

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

La réponse comprendra toutes les exigences (au niveau du pays et de l'État) nécessaires à la compréhension du voyageur quittant le pays de départ et se rendant dans le pays de destination.

Que faire si je souhaite obtenir 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 concerne un État si l'icône origine_pays_division a une valeur. Vous pouvez également filtrer pour ne récupérer que les données au niveau de l'État à l'aide de la fonction destination_country_division paramètre. Il attend un ISO_3166-2 valeur. Par exemple, US-TX pour 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 de telles données existent, et de les utiliser le cas échéant.

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

Tout comme pour les pays, l'API Sitata peut renvoyer des résultats entre deux aéroports. Les paramètres aéroport de départ et aéroport de destination utiliser soit OACI ou 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 à la compréhension du voyageur quittant le pays de départ et se rendant dans le pays de destination.

Que se passe-t-il si je n'ai que des informations sur la ville ?

Sitata a choisi de ne pas accepter les requêtes par nom de ville particulier, car cela pourrait entraîner des conflits et des confusions. Au lieu de cela, nous avons choisi d'interroger 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, départ_lng, destination_latet destination_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 transformez vos villes en lieux et que vous effectuez une requête basée sur les coordonnées, notre API répondra avec toutes les restrictions (au niveau du pays et de l'État) nécessaires pour comprendre le voyageur qui part du pays de départ et qui se rend dans le pays de destination.

Données supplémentaires

Pour certains types de conditions d'entrée, il peut y avoir des données associées supplémentaires dans un champ de type métadonnées appelé extras. Ce champ est un mappage clé/valeur de divers éléments d'information supplémentaires pour un besoin particulier.

Quel est le nombre de jours de quarantaine ?

Cette saisie de données relève de la condition d'entrée type 5. Dans cette entrée, le extras contiendra un champ appelé jours_de_quarantaine 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 relève de la condition d'entrée type 8. Dans cette entrée, le extras contiendra un champ appelé heures_d'entrée qui contiendra un nombre entier correspondant au nombre d'heures pendant lesquelles un test covid négatif est autorisé avant l'entrée.

Faites-nous part de vos commentaires

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 chemin. Si vous avez un cas d'utilisation particulier que nous ne traitons pas, faites-le nous savoir !

Attendez... il y a plus !

Cet article fait partie d'une série en deux parties qui explique comment interagir avec l'API Sitata pour obtenir des 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 d'exigences (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 savoir s'il est possible de se déplacer dans le pays, de visiter les plages ou s'il y a un couvre-feu obligatoire.

Restez à l'écoute pour le deuxième article qui approfondira notre ensemble de données sur les restrictions de voyage. Indice : il est presque identique, vous pouvez donc toujours jeter un coup d'œil à notre Documentation de l'API dans l'intervalle.

N'hésitez pas à nous suivre et à nous aimer :