Comment utiliser l'API de Sitata pour déterminer les restrictions de parcours pour les voyageurs ?

Rédigé par Madeline Sharpe

22 décembre 2020

Technologie

Beaucoup d'entre nous ne le savent pas, mais les premiers centres de Sitata ont été construits pour la détection précoce des maladies. De ce fait, notre fondateur a une charte de TedX à partir de 2016 concernant pour quelle raison devons-nous avertir les voyageurs afin de prévenir la propagation de la maladie ?. Il ne faut pas s'étonner dès lors que nous soyons entrés dans le COVID-19 lorsque nous avons été informés d'un groupe inhabituel de cas de neumonie au début du mois de décembre 2019. El 2 de enero de 2020, nuestro equipo de salud determinó que debíamos emitir notre première publicité à l'intention de nos visiteurs et de nos partenaires commerciaux. ¡Esto fue días antes incluso de la Organización Mundial de la Salud !

Au cours de l'inévitable inondation radioactive, nous avons connu une épidémie. La maladie s'étendait si rapidement qu'il était clair que la réponse globale serait insuffisante dans la plupart des cas. Chaque pays a promulgué son propre ensemble de réglementations et de règles pour contrôler la propagation. Cela entraînerait inévitablement des perturbations dans les voyages à travers le monde et constituerait une énorme source de confusion pour tous ceux qui souhaitent encore voyager. Nous avions raison et nous avons proposé de faire quelque chose à ce sujet. Sitata a été l'une des premières entreprises au monde à créer une API dédiée et un service de supervision pour les modifications des restrictions de transit et des conditions d'entrée résultant de la directive COVID-19. Avec un système logiciel avancé pour la détection d'événements et une équipe dédiée d'analystes, nous disposions déjà des outils et des processus adéquats pour y parvenir.

Depuis le lancement de ce nouveau service, nous avons trouvé une grande variété d'organisations qui exploitent les données au profit de leurs propres clients, y compris Eddy Travels, Flight Centre, et Etihad Airways ; ¡y en a d'autres que nous annoncerons bientôt ! Afin d'aider un plus grand nombre d'organisations axées sur les voyages à bénéficier de cette offre, nous avons rédigé en détail une série d'exemples pour expliquer comment utiliser l'API dans divers cas d'utilisation. Nous espérons que ces explications vous aideront à mettre en œuvre vos propres initiatives.

Conditions d'entrée

Il ne fait aucun doute que les premières questions qu'un voyageur se pose sont "Peut-on entrer ici ?" et "Sera-t-on placé dans la rue ?". Nous avons créé l'ensemble des données des conditions d'entrée pour répondre aux questions difficiles "oui/non" relatives à l'entrée dans un pays ou une région.

Au moment de rédiger le présent rapport, cet ensemble de données comprenait les 10 catégories distinctes suivantes :

  • ¿Puede un residente entrar en el país ?
  • Un étranger peut-il entrer dans le pays ?
  • Est-il permis de voyager à travers le pays ?
  • ¿Se requiere una prueba a la llegada (brote de la enfermedad) ?
  • ¿Se permite un certificado de prueba (brote de una enfermedad) ?
  • Faut-il une cure d'amaigrissement à l'arrivée (date d'apparition de la maladie) ? Faut-il une vaccination ?
  • Faut-il une assurance ?
  • ¿Se requiere un certificado de prueba ?
  • ¿Se requiere un formulario de inscripción ? (salud u otro)

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

  • Oui, sauf exception
  • Non
  • Non, sauf exceptions

Bien que la plupart des valeurs soient "oui" et "non", la situation sur le terrain n'est pas toujours aussi simple. Il existe parfois des règles vraiment extravagantes et locales que certains gouvernements ont mises en place et qui exigent des types de valeurs "avec des exceptions"

Un requisito de entrada est surtout un registre qui documente un ensemble de normes imposées par un agent contre un ou plusieurs pays ou régions. L'acteur peut être un pays, un état ou même une municipalité dans notre architecture de données. En général, Sitata couvre les données au niveau du pays à l'heure actuelle. Néanmoins, nous disposons de quelques registres nationaux/provinciaux pour des régions sélectionnées telles que les États-Unis et d'autres pays.

Tout registre dont l'entrée est située en dessous du champ origine_pays_division_id o origine_pays_région_id es uno que es de nivel estatal o municipal, respectivamente. Si vous souhaitez obtenir plus de données, veuillez prendre contact avec nous. con nosotros et nous pourrons parler de son cas d'utilisation.

Veuillez prendre le temps de vous familiariser avec la structure des données et les exigences d'entrée en consultant la page suivante nos documents sur l'API ici.

Une partie un peu confuse de la structure des données est l'utilisation que nous faisons du terme "données"."origen" Esto es confuso porque a menudo los desarrolladores piensan que el origen es el lugar de origen o de partida. Cependant, ce que nous voulons dire par origine est en réalité l'origine de la réglementation 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 nous l'avons vu dans la documentation, il existe différentes formes de récupération des données de l'API. Nous vous présentons ci-après quelques-uns des cas d'utilisation les plus courants.

Comment obtenir les exigences entre deux pays ?

Il existe plusieurs manières d'effectuer cette demande. La version la plus simple consiste à utiliser le bouton destino y salida les paramètres. Ces paramètres acceptent les codes suivants ISO 3166-1 alfa-2 como entradas

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.

¿Y si quiero datos a nivel estatal ?

Sitata dispose de données au niveau national pour certaines régions. L'utilisateur sait qu'une entrée particulière est pour un état si elle est división_país_original Le champ a une valeur. Il est également possible de filtrer pour récupérer uniquement les données de niveau d'état en utilisant la fonction de filtrage des données. división_país_destino parámetro. Espera un valor ISO_3166-2. Par exemple, US-TX pour Texas, États-Unis.

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

Observez qu'il serait plus simple d'effectuer une consultation par pays et ensuite de filtrer les données des États pour vérifier si ces données existent, et de les utiliser si elles existent.

Comment obtenir les exigences entre deux aéroports ?

Tout comme dans le cas des pays, l'API de Sitata peut fournir des résultats entre deux aéroports. Les paramètres aeropuerto de salida y aeropuerto de destino utiliser les codes de la OACI o de la IATA pour filtrer les résultats. La réponse comprendra toutes les restrictions (au niveau du pays et de l'État) nécessaires pour comprendre le voyageur qui quitte le pays d'origine et se rend 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 pour comprendre le rôle du voyageur qui se rend du pays d'origine au pays de destination.

¿Y si sólo tengo información de la ciudad ?

Sitata a décidé de ne pas prendre en compte les consultations portant sur un nom de ville en particulier, car cela pourrait donner lieu à des conflits et à des confusions. Nous avons donc choisi d'adapter la consultation de notre API aux coordonnées de latitude et de longitude, ce qui n'a pas créé d'ambiguïté dans nos résultats. Les paramètres sont les suivants départ_lat, départ_lng, destination_lat...y.. 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 réservez vos villes aux emplacements et aux consultations basés sur les coordonnées, notre API répondra avec toutes les restrictions (au niveau du pays et de l'état) nécessaires pour comprendre pour le voyageur qui vend du pays de départ et qui se rend au pays d'arrivée.

Données complémentaires

Pour certains types d'exigences d'entrée, il peut y avoir des données additionnelles associées dans un camp de type de métadonnées appelé extras. Ce champ est une cartographie claire/valeur de plusieurs bits d'information supplémentaires pour une demande particulière.

¿Cuál es el número de días de cuarentena ?

Cette entrée de données est soumise à l'obligation d'entrée. tipo 5. En esta entrada, el extras La carte contient un champ appelé días_de_cuarentena que contendrá un número entero para el número de días de cuarentena impuestos.

¿Cuál es el número de horas antes de la entrada para una prueba de covidio negativa ?

Cette entrée de données est soumise à l'obligation d'entrée. tipo 8. En esta entrada, el extras La carte contient un champ appelé heures_d'entrée que contendrá un número entero para el número de horas que se permite una prueba covid negativa antes de la entrada.

Nous savons

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 risquent de rencontrer sur leur chemin. Si vous avez un cas d'utilisation particulier que nous n'abordons pas, Veuillez nous contacter pour plus d'informations.

Espera... ¡hay más !

Cette entrée fait partie d'une série de deux parties qui explique comment interagir avec l'API de Sitata pour les conditions d'entrée et les informations sur les restrictions de voyage. Jusqu'à présent, nous avons parlé des conditions d'entrée, qui représentent les exigences les plus strictes 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 d'un pays. Une chose est de savoir comment entrer dans un pays, une autre est de savoir s'il est possible de se déplacer dans le pays, de visiter les plages ou s'il y a une obligation de quitter le pays.

Restez en contact avec le deuxième article qui sera publié dans notre recueil de données sur la restriction de circulation. Pista - es casi idéntico, así que siempre puedes echar un vistazo a nuestra documentation de la API mientras tanto.

N'hésitez pas à nous suivre et à nous aimer :
Venezuela’s Political Crisis: A Nation in Turmoil

Venezuela’s Political Crisis: A Nation in Turmoil

Disclaimer: The views, thoughts, and opinions expressed in this article are solely those of the author and do not necessarily reflect the views, opinions, or positions of any other individual, organization, or entity. The Situation The political crisis in Venezuela...

The Hezbollah Pager Explosions

The Hezbollah Pager Explosions

The Incident  On 17 September, during the afternoon hours, hundreds of pagers used by Hezbollah militants exploded in Lebanon and Syria. At least nine people were killed and over 3,000 others were injured in Lebanon. According to Saberin News, seven people were...