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

Geschreven door Madeline Sharpe

22 december 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. En fait, notre fondatrice organiseerde vanaf 2016 een TedX discours over de redenen waarom wij de reizigers moeten tegenhouden 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 onze medische afdeling besloten dat wij een eerste waarschuwing aan 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 wereldwijde reactie veel chaotischer was. Elk land vaardigde zijn eigen regels en voorschriften uit om de verspreiding tegen te gaan. Dit zou onvermijdelijk verwoestingen aanrichten in de hele wereld en een enorme bron van verwarring zijn voor degenen die nog meer wilden reizen. We hebben een reden en we hebben besloten iets te doen om het te verhelpen. Sitata is een van de eerste ondernemingen in de wereld die een API heeft ontwikkeld en een opvolgingsdienst voor wijzigingen in de reisbeperkingen en toegangsvoorwaarden naar aanleiding van COVID 19. Dankzij een geavanceerd logistiek systeem voor het opsporen van gebeurtenissen en een gespecialiseerd team van analisten, beschikken wij nu al over alle hulpmiddelen en processen die nodig zijn om te kunnen werken.

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 een zo groot mogelijk aantal reisorganisaties te helpen van dit aanbod te profiteren, hebben we hieronder een aantal voorbeelden uitgewerkt om uit te leggen hoe de API in verschillende gevallen kan worden gebruikt. Ik hoop dat deze uitleg u helpt bij het ontplooien van uw eigen initiatieven.

Voorwaarden voor toegang

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. Wij hebben het geheel van gegevens over de toegangsvoorwaarden samengesteld om antwoord te geven op moeilijke vragen van het type "oui/non" betreffende de toegang tot een land of regio.

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

  • Kan 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, avec des exceptions
  • Niet
  • Non, sauf exceptions

Als de grote meerderheid van de waarden "oui" en "non" is, is de situatie op het terrein niet altijd even eenvoudig. Soms bestaan er zeer bizarre en dwingende regels die verschillende regeringen hebben ingevoerd en die vereisen dat de soorten waarden "met uitzonderingen" worden toegepast.

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 omvat Sitata momenteel de gegevens op landenniveau. Voor bepaalde regio's, zoals de Verenigde Staten en andere, beschikken wij over enkele gegevens van staten/provincies.

Elke enregistratie die een ingang bevat onder de titel origine_pays_division_id of origine_pays_région_id is een niveau dat zich respectievelijk op het niveau van de staat of van de gemeente bevindt. Indien u over meer uitgebreide gegevens wenst te beschikken, kunt u nous contacter en we kunnen praten over uw geval van gebruik.

Veuillez prendre le temps de vous familiariser avec la structure des données des conditions d'entrée en consultant nos documents API ici.

Een deel van de structuur van de gegevens is zeer onduidelijk, zoals ons gebruik van de term"origine" Deze verwarring is te wijten aan het feit dat de ontwikkelaars vaak de oorsprong beschouwen als de plaats van oorsprong of de plaats van vertrek. Of, wat wij onder "oorsprong" verstaan, is in feite de oorsprong van de regeling die aan anderen wordt opgelegd, namelijk het land of de regio die de beperking heeft ingesteld.

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

Enkele voorbeelden

Zoals u in de documentatie kunt 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 meest eenvoudige versie is het gebruik van de bestemming en départ paramètres. Deze parameters accepteren de volgende codes ISO 3166-1 alfa-2 comme entrés

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

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

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

Sitata beschikt over 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 een waarde. U kunt ook filteren om de gegevens op niveau van de staat niet op te halen en gebruik te maken van het kanaal bestemming_betaalt_afdeling paramètre. Hij heeft een waarde ISO_3166-2. Bijvoorbeeld, US-TX voor Texas, États-Unis.

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

Merk op dat het eenvoudiger zou kunnen zijn een onderzoek per land uit te voeren, en vervolgens de gegevens per staat te filteren om te zien of deze gegevens bestaan, en ze te gebruiken als ze bestaan.

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

Evenals voor de landen kan de API Sitata de resultaten tussen twee luchthavens weergeven. De parameters départ_aéroport en bestemming_haven gebruik de codes de l''OACI of de l'IATA om de resultaten te filteren. Het antwoord omvat alle beperkingen (op het niveau van het land en van de staat) die noodzakelijk zijn voor het begrip van de reiziger die uit het land van vertrek vertrekt en in het land van bestemming verblijft.

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.

En als ik geen informatie heb over de stad?

Sitata heeft ervoor gekozen niet in te gaan op aanvragen met 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 de volgende départ_lat, vertrek_lng, bestemming_laten 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 soorten toegangsvoorwaarden kan het zijn dat er aanvullende gegevens worden verzameld in een bepaald type métadonnage. extra's. Dit is een overzicht van de verschillende elementen van aanvullende informatie voor een bijzondere eis.

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 extra's la cartographie contiendra un champ appelé quarantaine_dagen die een grote som bevat voor het aantal opgelegde dagen.

Wat is het aantal uren voor de ingang van een covidale 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é ingangsuren die een volledig getal bevat voor het aantal uren gedurende welke een covidale test is toegestaan vóór de binnenkomst.

Faites-nous savoir

Wij denken dat wij beschikken over een zeer krachtig instrument dat waarschijnlijk beantwoordt aan al uw behoeften om uw reizigers te helpen begrijpen wat zij 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 wij gesproken over de toegangsvoorwaarden die de strenge voorwaarden van het type oui/non-noncessaires beschrijven om een land of regio binnen te komen, maar wij hebben nog niet gesproken over wat er in het binnenland 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 dat onze reeks gegevens over reisbeperkingen beschrijft. Astuce : il est presque identique, vous pouvez donc consulter toujours notre documentatie over de API en verzorger.

Volg en like ons:

Verwante artikelen

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