Comentar o API de Sitata pour déterminer les restrictions de voyage pour les voyageurs

Escrito por Madeline Sharpe

Dezembro 22, 2020

Technologie

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. Na verdade, não é mais do que uma organização de um disco TedX a partir de 2016 sobre os raisons pour lesquelles nous devons avertir les voyageurs afin de prévenir la propagation des maladies. Il n'est donc pas surpriseenant 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 primeiro 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. Graças a um sistema de registo avançado de detecção de eventos e a uma equipa de analistas especializados, temos à disposição todas as nossas necessidades e processos necessários para o seu desenvolvimento.

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.

Condições de entrada

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. Nós criamos o conjunto de données sobre as condições de entrada para responder às questões difíceis do tipo "oui/non" relativas à entrada num país ou numa região.

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 nécessaire de la nécessaire de la nécessaire de la nécessaire de la nécessaire de la nécessaire ?
  • Pedido de garantia ?
  • Certificat de test requis ?
  • Formulário de inscrição necessário ? (santé ou autre)

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

  • Oui
  • Oui, avec des exceptions
  • Não
  • Não, excepções sauf

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

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. Desde o seu conjunto, Sitata couvre actuellement les données au niveau des pays. Para tal, dispomos 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 contacto de nous 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 documentos 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. Ou, 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.

Outro ponto importante a salientar é como funciona a nossa lista de condados afectados. Se os países afectados estão vazios, deve ser interpretado como uma regra global, ou seja, todos os países são afectados.

Exemplos de Quelques

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, we allons passer en revue quelques-uns des cas d'utilisation les plus courants.

Comente 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 destino 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

A resposta incluirá todos os requisitos (a nível de país e de estado) necessários para que o viajante que parte do país de partida e viaja para o país de destino.

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 originine_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 destino_paga_divisão paramètre. Il attend une valeur ISO_3166-2. Por exemplo, 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 elles existent.

Comente 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 destino_aéroport utiliser les codes de l'OACI ou de l'IATA pour filtrer les résultats. A resposta compreende todas as restrições (ao nível do país e do Estado) necessárias à compreensão do viajante que faz parte do país de destino.

GET https://www.sitata.com/api/v2/entry_requirements?departure_airport=MUC&destination_airport=BOM

A resposta compreende todas as restrições (ao nível do país e do Estado) necessárias para o viajante que parte do país de destino.

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. Os parâmetros são os seguintes départ_lat, partida_lng, destino_latet destino_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

Se você resolver as suas vilas em função dos direitos de autor e dos pedidos em função das coordenadas, não é a API que responde a todas as restrições (ao nível do país e do Estado) necessárias à compreensão do viajante que parte do país de destino.

Informações suplentes

Para que certos tipos de condições de entrada, a peut e 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 tipo 5. Dans cette entrée, le extras la cartographie contiendra un champ appelé dias_de_quarantaine que 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 tipo 8. Dans cette entrée, le extras la cartographie contiendra un champ appelé entrada_horas 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 robustement qui répondra probablement à tous vos besoins pour aider vos voyageurs à comprendre ce qu'ils sont susceptibles de rencontrer en cours de route. Se você tiver um caso de utilização, em particular que não nos trairia, faça-nos savoir !

Participantes... 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 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. Astuça : il est presque identique, vous pouvez donc toujours consulter notre documentação sobre l'API pt assistente.

Por favor, siga e como nós:

Artigos relacionados

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

Gripe aviária altamente patogénica - H5N1

Gripe aviária altamente patogénica - H5N1

Existe uma estirpe do vírus da gripe denominada H5N1 que é altamente letal para as aves selvagens e para as aves domésticas (galinhas, patos, etc.). Nas últimas décadas, causou grandes surtos em bandos de galinhas domésticas. Em raras ocasiões, este vírus infectou seres humanos que...

Uma antevisão dos Jogos Olímpicos de Paris 2024

Uma antevisão dos Jogos Olímpicos de Paris 2024

Os Jogos da XXXIII Olimpíada, também conhecidos como Jogos Olímpicos e Paraolímpicos de verão de 2024, estão programados para se realizarem em Paris, França, de 26 de julho a 11 de agosto e de 28 de agosto a 8 de setembro, simultaneamente. Os torneios decorrerão em locais emblemáticos de Paris...