
Mange av dere vet kanskje ikke at Sitata ble grunnlagt for å forebygge sykdommer. Vår grunnlegger organiserte i 2016 en TedX-forelesning om grunner til at vi bør avverge at reisende reiser for å hindre spredning av sykdommer. Det er derfor ikke overraskende at vi har fått vite at det finnes en COVID-19, som ble signalisert som en gruppe med lungebetennelse i begynnelsen av desember 2019. Den 2. januar 2020 besluttet vår helseavdeling at vi skulle sende ut en første advarsel til våre reisende og kommersielle partnere. C'était quelques jours avant même l'Organisation mondiale de la santé!
Under de uunngåelige retombéene har vi fått en åpenbaring. Sykdommen spredte seg så raskt at det var klart for oss at den globale responsen ville bli kaotisk. Hvert land skulle promulgere sine egne lover og regler for å kontrollere spredningen. Dette ville uunngåelig føre til ødeleggelser i hele verden og være en enorm kilde til forvirring for dem som ønsket å reise videre. Nous avions raison et nous avons décidé de faire quelque chose pour y remédier. Sitata var den første i verden til å lage et dedikert API og en tjeneste for oppfølging av endringer i reiserestriksjoner og innreisebetingelser som følge av COVID-19. Takket være et avansert system for registrering av hendelser og et team av spesialiserte analytikere, har vi allerede alle nødvendige verktøy og prosesser for å komme i mål.
Siden lanseringen av denne nye tjenesten har flere organisasjoner fått utbytte av dataene til fordel for sine egne kunder, blant annet Eddy Travels, Flight Centre og Etihad Airways ; d'autres informations seront bientôt annoncées ! For å hjelpe et større antall organisasjoner som er rettet mot reiser med å dra nytte av dette tilbudet, har vi skrevet et visst antall eksempler nedenfor for å forklare hvordan du bruker API for forskjellige tilfeller av bruk. Jeg håper at disse forklaringene vil hjelpe deg med å starte dine egne initiativer.
De første spørsmålene en reisende stiller seg er uten tvil: "Puis-je y aller?" og "Serai-je mis en quarantaine", c'est donc un bon point de départ. Vi har laget en samling av data om innreisevilkår for å kunne svare på vanskelige spørsmål av typen "ja/nei" om innreise i et land eller en region.
Da dette dokumentet ble utarbeidet, bestod denne samlingen av opplysninger av følgende ti kategorier
Hver kategori kan ha en av følgende verdier :
Hvis den store majoriteten av verdiene er "ja" og "nei", er situasjonen i terrenget ikke alltid like enkel. Noen ganger finnes det virkelig bisarre og underlige regler som ulike regjeringer har innført, og som krever at verdiene er "med unntak"
Et inngangsvilkår er i hovedsak et dokument som dokumenterer et sett av regler pålagt av en aktør overfor et eller flere andre land eller regioner. Aktøren kan være et land, en stat eller en kommune i vår dataarkitektur. Sitata dekker for øyeblikket alle data på landsnivå. Toutefois, nous disposons 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
er et nivå som ligger henholdsvis på statlig eller kommunalt nivå. Hvis du ønsker å ha mer omfattende opplysninger, vennligst nous contacter et nous pourrons discuter de votre cas d'utilisation.
Ta deg tid til å gjøre deg kjent med strukturen på opplysningene om inngangsvilkårene til konsulenten våre dokumenter API her.
En del av datastrukturen er litt uoversiktlig, for eksempel vår bruk av begrepet"opprinnelse" Denne forvirringen skyldes at utviklerne ofte betrakter opprinnelsen som opprinnelsessted eller utgangssted. Eller, 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.
Et annet viktig poeng er hvordan listen over berørte land fungerer. Hvis affected_countries er tom, skal den tolkes som en global regel, dvs. at alle land påvirkes.
Som du har sett i dokumentasjonen, finnes det flere måter å hente data fra API-et på. Vi vil her gå gjennom noen av de mest vanlige brukstilfellene.
Det finnes flere måter å gjøre denne typen forespørsler på. Den enkleste versjonen er å bruke reisemål
et départ
parametere. Disse parameterne godtar kodene ISO 3166-1 alpha-2 som entrées
GET https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination=IN
Svaret skal inneholde alle krav (på land- og delstatsnivå) som er nødvendige for å forstå hva som gjelder for den reisende som reiser fra avreiselandet til destinasjonslandet.
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 opprinnelse_betaler_divisjon
a une valeur. Du kan også filtrere for å gjenopprette dataene på tilstandsnivå ved å bruke feltet destinasjon_betaler_inndeling
paramètre. Il attend une valeur ISO_3166-2. For eksempel US-TX for Texas, USA.
GET https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination_country_division=IN-AP
Merk at det kan være enklere å gjøre en søk på land, og deretter filtrere dataene på stat for å se om de finnes, og bruke dem hvis de finnes.
API Sitata kan, som for andre land, vise resultatene mellom to lufthavner. Parameterne départ_aéroport
et destinasjon_aéroport
utiliser les codes de l'OACI ou de l'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 à comprendre pour le voyageur qui part du pays de départ et se rend dans le pays de destination.
Sitata har valgt å ikke svare på forespørsler som gjelder en bestemt by, fordi det kan føre til konflikter og forvirring. I stedet for dette har vi valgt å akseptere forespørslene fra vår API via koordinater for breddegrad og lengdegrad, noe som ikke gir noen tvetydighet i våre resultater. Parameterne er følgende départ_lat
, avgang_lng
, destinasjon_lat
et destinasjon_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
Hvis du løser dine byer i henhold til steder og krav i henhold til koordinater, svarer vår API med alle restriksjoner (på lands- og statsnivå) som er nødvendige for å forstå en reisende som forlater avreiselandet og kommer til bestemmelseslandet.
For visse typer inngangsvilkår kan det finnes tilleggsopplysninger knyttet til en type métadonnées-gruppe kalt Ekstrautstyr
. Dette feltet er en kartlegging av nøkkel/verdi av ulike elementer av tilleggsinformasjon for et spesielt behov
Denne dataregistreringen er underlagt registreringsplikt type 5. Dans cette entrée, le Ekstrautstyr
kartografien inneholder en champ kalt quarantaine_days
qui contiendra un nombre entier pour le nombre de jours de quarantaine imposés.
Denne dataregistreringen er underlagt registreringsplikt type 8. Dans cette entrée, le Ekstrautstyr
kartografien inneholder en champ kalt entry_hours
som inneholder et helt tall for antall timer i løpet av hvilke en test covid négatif est autorisé avant l'entrée.
Vi tror at vi har et svært robust verktøy som sannsynligvis vil svare på alle dine behov for å hjelpe dine reisende til å forstå hva de kan møte underveis på reisen. Hvis du har et spesielt brukstilfelle som vi ikke har behandlet, kan du kontakte oss savoir!
Denne inngangen er en del av en serie på to deler som forklarer hvordan du kan samhandle med API Sitata for å få informasjon om innreisevilkår og reisebegrensninger. Til nå har vi snakket om innreisevilkår som beskriver hvilke typer strenge innreisevilkår som er nødvendige for å reise inn i et land eller en region, men vi har ikke snakket om hva som skjer på innsiden av landet. 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.
Se også vår andre artikkel som gir deg mer informasjon om reiserestriksjoner. Astuce : il est presque identique, vous pouvez donc toujours consulter notre dokumentasjon om API en ledsager.