sitata-logo

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

10 september 2024
Reisbeperkingen API

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 redenen waarom we de reizigers moeten waarschuwen om de verspreiding van ziekten te voorkomen. Il n'est donc pas surprenant que nous ayons appris l'existence du COVID-19, qui a été signalé comme un groupe inhabitant de cas de pneumonie au début du mois de décembre 2019. Op 2 januari 2020 heeft Notre équipe de santé besloten dat we een eerste waarschuwing voor onze reizigers en commerciële partners. 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. De ziekte verspreidde zich zo snel dat het voor ons duidelijk was dat de reactie wereldwijd chaotischer zou worden. Elk land vaardigde zijn eigen regels uit om de verspreiding tegen te gaan. Dit zou onvermijdelijk verwoestingen aanrichten in de hele wereld en een enorme bron van verwarring zijn voor iedereen die nog meer wilde reizen. We hebben een reden en we hebben besloten iets te doen om het te verhelpen. Sitata is een van de eerste bedrijven ter wereld die een API heeft ontwikkeld en een opvolgingsdienst voor wijzigingen aan reisbeperkingen en toegangsvoorwaarden naar aanleiding van COVID-19. Dankzij een geavanceerd logiciel systeem voor het vastleggen van gebeurtenissen en een gespecialiseerd team van analisten, beschikken wij nu al over alle benodigde hulpmiddelen en processen om te kunnen reageren.

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! Om nog meer organisaties die zich richten op reizen te laten profiteren van dit aanbod, hebben we hieronder een aantal voorbeelden uitgewerkt om uit te leggen hoe je de API kunt gebruiken in verschillende gebruiksgevallen. Ik hoop dat deze uitleg u helpt bij het ontplooien van uw eigen initiatieven.

Toegangsvoorwaarden

De eerste vragen die een reiziger zich stelt zijn zonder twijfel: "Puis-je y aller?" en "Serai-je mis en quarantaine", c'est donc un bon point de départ. We hebben het geheel van gegevens over de toegangsvoorwaarden samengesteld om antwoord te kunnen geven op moeilijke vragen van het type "oui/non" over de toegang tot een land of regio.

Op het moment dat dit document werd opgesteld, bevatte dit ensemble van gegevens de volgende zes verschillende categorieën:

  • Mag een ingezetene het land binnenkomen?
  • Mag een buitenlander het land binnenkomen?
  • Is de doorvoer door het hele land toegestaan?
  • 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) ? Is vaccinatie noodzakelijk?
  • Zekerheid nodig?
  • Testcertificaat nodig?
  • Inschrijvingsformulier nodig? (gezondheid of andere)

Elke categorie kan een van de volgende waarden hebben:

  • Oui
  • Oui, met uitzonderingen
  • Niet
  • Non, sauf exceptions

Si la grande majorité des valeurs sont "oui" et "non", la situation sur le terrain n'est pas toujours aussi simple. Soms bestaan er zeer bizarre en volgzame regels die verschillende regeringen hebben ingevoerd en die de soorten waarden "met uitzonderingen" vereisen.

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'actor peut être un pays, un État ou même une municipalité dans notre architecture de données. In het geheel houdt Sitata zich op dit moment bezig met données op landenniveau. Toch beschikken we voor bepaalde regio's, zoals de Verenigde Staten en andere, over enkele gegevens van staten/provincies.

Alle registraties die een ingang onder het scherm bevatten oorsprong_betaalt_afdeling_id of origine_pays_région_id est un niveau qui se situe respectivement au niveau de l'État ou au niveau municipal. Als u over meer gegevens wilt beschikken, kunt u het volgende doen nous contacter et nous pourrons discuter de votre cas d'utilisation.

Neem de tijd om u vertrouwd te maken met de structuur van de 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"oorsprong" Cette confusion est due au fait que les développés considèrent souvent l'origine comme étant le lieu d'origine ou le lieu de départ. Of, 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.

Een ander belangrijk punt om op te merken is hoe onze lijst met betrokken landen werkt. Als affected_countries leeg is, moet het worden geïnterpreteerd als een globale regel. Dat wil zeggen dat alle landen worden beïnvloed.

Enkele voorbeelden

Zoals u in de documentatie hebt kunnen lezen, bestaan er verschillende manieren om de gegevens van de API op te halen. Ci-dessous, nous allons passer en revue quelques-uns des cas d'utilisation les plus courants.

Comment obtenir les exigences entre les deux pays?

Er zijn verschillende manieren om deze aanvraag in te dienen. De eenvoudigste versie is het gebruik van de bestemming et vertrek parameters. Deze parameters accepteren de volgende codes ISO 3166-1 alfa-2 zoals ingangen

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

Het antwoord zal alle vereisten (op land- en staatsniveau) bevatten die nodig zijn om de reiziger die vertrekt uit het land van vertrek en naar het land van bestemming reist, te begrijpen.

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

Sitata beschikt over gegevens op het niveau van de staat voor bepaalde regio's. Vous saurez qu'une entrée particulière est pour un État si le oorsprong_betaalt_afdeling een waarde. Vous pouvez également filtrer pour ne récupérer que les données au niveau de l'état en utilisant le champ bestemming_betaalt_afdeling paramètre. Hij heeft een waarde ISO_3166-2. Bijvoorbeeld US-TX voor Texas, Verenigde Staten.

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 les deux aéroports?

Net als voor andere landen kan de API Sitata de resultaten tussen twee luchthavens weergeven. Parameters vertrekhaven et bestemming_haven gebruik de codes van l'OACI of de l'IATA om de resultaten te filteren. 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 heeft ervoor gekozen om niet te reageren op aanvragen die uitgaan van een specifieke plaatsnaam, omdat dit tot conflicten en verwarring kan leiden. Au lieu de cela, nous avons choisi d'accepter les demandes de notre API par coordonnées de latitude et de longitude, ce qui ne produit aucune ambiguïté dans notre ensemble de résultats. De parameters zijn als volgt départ_lat, vertrek_lng, bestemminget bestemming_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.

Aanvullende informatie

Voor bepaalde toegangscondities kunnen aanvullende gegevens worden gevonden in een type metadonnage dat als volgt wordt aangeduid extra's. Dit is een overzicht van verschillende aanvullende informatie voor een specifieke toepassing

Wat is het aantal dagen dat de quarantaine duurt?

Cette saisie de données est soumise à l'obligation de saisie type 5. Dans cette entrée, le extra's la cartographie contiendra un champ appelé quarantaine_dagen qui contiendra un nombre entier pour le nombre de jours de quarantaine imposés.

Wat is het aantal uren voor de start van een covid-négatif-test?

Cette saisie de données est soumise à l'obligation de saisie type 8. Dans cette entrée, le extra's la cartographie contiendra un champ appelé binnenkomst_uren qui contiendra un nombre entier pour le nombre d'heures pendant lesquelles un test covid négatif est autorisé avant l'entrée.

Laat het ons weten

Wij zijn van mening dat we beschikken over een zeer krachtig hulpmiddel dat waarschijnlijk voldoet aan al uw behoeften om reizigers te helpen te begrijpen wat ze onderweg kunnen tegenkomen. Als u een specifiek geval van gebruik hebt dat wij niet behandelen, laat het ons dan weten. 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. Tot nu toe hebben we het gehad over de voorwaarden voor binnenkomst die de strenge voorwaarden van het type oui/non nécessaires beschrijven om een land of regio binnen te komen, maar we hebben het nog niet gehad over wat er binnen een land gebeurt. C'est une chose de savoir comment entrer dans un pays, c'en est une autre de comprendre si il est possible de se déplacer dans le pays ou de visiter les plages ou si il y a un couvre-feu obligatoire.

Lees het tweede artikel over onze informatie over reisbeperkingen. Let op: hij is vrijwel identiek, u kunt dus altijd onze documentatie over de API en verzorger.

Reisverzekering en hulp die je helpt een betere reis hebben

Zie waarom duizenden reizigers Sitata kiezen als ze op reis gaan

Copyright © 2025 Sitata Inc.
We've detected you might be speaking a different language. Do you want to change to:
en_US English
en_US English
es_ES Español
fr_FR Français
it_IT Italiano
de_DE Deutsch
hu_HU Magyar
ro_RO Română
ar العربية
pl_PL Polski
pt_PT Português
nl_NL Nederlands
sv_SE Svenska
fi Suomi
nb_NO Norsk bokmål
da_DK Dansk
Close and do not switch language