Hvordan bruke Sitata sine API-er for å fastslå reiserestriksjoner for reisende

Mange av dere vet kanskje ikke dette, men de aller første grunnvollene for Sitata ble lagt for tidlig sykdomsoppdagelse. Vår grunnlegger holdt faktisk et TedX-foredrag så tidlig som i 2016 om hvorfor vi må advare reisende for å forhindre spredning av sykdommer. Så det var ingen overraskelse at vi lærte om COVID-19, som ble rapportert som en uvanlig gruppe med lungebetennelsestilfeller tidlig i desember 2019. Den 2. januar 2020 bestemte vårt helseteam at vi måtte sende ut et tidlig varsel til våre reisende og forretningspartnere. Dette var flere dager før selv Verdens helseorganisasjon!

Under de uunngåelige etterspillene fikk vi en åpenbaring. Sykdommen spredte seg så raskt at det var klart for oss at den globale responsen i beste fall ville bli kaotisk. Hvert land kom til å innføre sine egne forskrifter og regler for å kontrollere spredningen. Dette ville uunngåelig skape kaos over hele verden og være en enorm kilde til forvirring for de som fremdeles ønsket å reise. Vi hadde rett, og vi bestemte oss for å gjøre noe med det. Sitata var et av de første selskapene i verden til å lage et dedikert API og en tjeneste for å spore endringer i reiserestriksjoner og innreisekrav som følge av COVID-19. Takket være et avansert programvaresystem for hendelsesoppdagelse og et team med spesialiserte analytikere, hadde vi allerede alle verktøyene og prosessene på plass for å oppnå dette.

Siden lanseringen av denne nye tjenesten har flere organisasjoner dratt nytte av dataene til fordel for sine egne kunder, inkludert Eddy Travels, Flight Centre og Etihad Airways; flere kunngjøringer kommer snart! For å hjelpe flere reiserettede organisasjoner med å dra nytte av dette tilbudet, har vi nedenfor skrevet i detalj en rekke eksempler for å forklare hvordan du bruker API-et for ulike bruksområder. Forhåpentligvis vil disse forklaringene hjelpe deg i gang med dine egne initiativer.

Innreisekrav

De første spørsmålene en reisende uten tvil stiller seg er: “Kan jeg dra dit?” og “Blir jeg satt i karantene?”, så det er et godt sted å starte. Vi opprettet datasettet for innreisekrav for å besvare de vanskelige ja/nei-spørsmålene om innreise til et land eller en region.

På tidspunktet for skriving inkluderte dette datasettet følgende ti distinkte kategorier:

• Kan en innbygger komme inn i landet?
• Kan en utlending komme inn i landet?
• Er gjennomreise gjennom landet tillatt?
• Kreves det test ved ankomst (sykdomsoppblussing)?
• Er testattest tillatt (sykdomsoppblussing)?
• Kreves det karantene ved ankomst (sykdomsoppblussing)?
• Kreves det vaksinasjon?
• Kreves det forsikring?
• Kreves det testattest?
• Kreves det registreringsskjema? (helse eller annet)

Hver kategori kan ha en av følgende verdier:

• Ja
• Ja, med unntak
• Nei
• Nei, med unntak

Selv om de aller fleste verdiene er “ja” og “nei”, er situasjonen på bakken ikke alltid så enkel. Noen ganger finnes det virkelig bisarre og sprø regler som ulike regjeringer har innført, og som krever “med unntak”-typene verdier.

Et innreisekrav er i bunn og grunn et dokument som beskriver et sett med regler pålagt av en aktør mot ett eller flere andre land eller regioner. Aktøren kan være et land, en stat eller til og med en kommune i vår datamodell. Totalt sett dekker Sitata for tiden data på landsnivå. Vi har imidlertid noen få oppføringer på stat/provinsnivå for enkelte regioner, som USA og andre.

Enhver oppføring som har en verdi i feltet **origin_country_division_id** eller **origin_country_region_id** er på henholdsvis statnivå eller kommunenivå. Hvis du ønsker mer detaljerte data, kan du kontakte oss så kan vi diskutere ditt bruksområde.

Ta deg tid til å bli kjent med datastrukturen for innreisekrav ved å se på vår API-dokumentasjon her.

En del av datastrukturen kan være litt forvirrende, nemlig vår bruk av begrepet “origin” (opprinnelse). Denne forvirringen oppstår fordi utviklere ofte tenker på opprinnelse som stedet reisen starter eller avreise fra. Det vi mener med “origin” er faktisk opprinnelsen til regelen som pålegges andre, det vil si landet eller regionen som har opprettet restriksjonen.

Et annet viktig poeng å merke seg er hvordan vår liste over berørte land fungerer. Hvis affected_countries er tom, skal det tolkes som en global regel, dvs. alle land er berørt.

Noen eksempler

Som du kanskje har sett i dokumentasjonen, finnes det flere måter å hente data fra API-et på. Nedenfor går vi gjennom noen av de vanligste bruksområdene.

Hvordan får jeg kravene mellom to land?

Det er flere måter å gjøre en slik forespørsel på. Den enkleste versjonen er å bruke parametrene **destination** og **departure**. Disse parameterne aksepterer ISO 3166-1 alpha-2-koder som input.

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

Responsen vil inkludere alle krav (på lands- og statsnivå) som er nødvendige å forstå for reisenden som reiser fra avreiselandet til destinasjonslandet.

Hva om jeg vil ha data på statnivå?

Sitata har data på statnivå for enkelte regioner. Du vil vite at en bestemt oppføring gjelder for en stat hvis origin_country_division har en verdi. Du kan også filtrere for kun å hente data på statnivå ved å bruke parameteren **destination_country_division**. Den forventer en ISO_3166-2-verdi. 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 å søke etter land, og deretter filtrere dataene etter stat for å se om slike data finnes, og bruke dem hvis de gjør det.

Hvordan får jeg kravene mellom to flyplasser?

Akkurat som for land, kan Sitata API-et returnere resultater mellom to flyplasser. Parametrene departure_airport og destination_airport bruker ICAO- eller IATA-koder for å filtrere resultatene. Responsen vil inkludere alle restriksjoner (på lands- og statsnivå) som er nødvendige å forstå for reisenden som reiser fra det tilsvarende avreiselandet til destinasjonslandet.

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

Responsen vil inkludere alle restriksjoner (på lands- og statsnivå) som er nødvendige å forstå for reisenden som reiser fra avreiselandet til destinasjonslandet.

Hva om jeg bare har informasjon om by?

Sitata har valgt å ikke svare på forespørsler basert på et spesifikt bynavn, da dette kan føre til konflikter og forvirring. I stedet har vi valgt å akseptere forespørsler til vårt API basert på bredde- og lengdegradskoordinater, noe som ikke produserer noen tvetydighet i vårt resultatsett. Parameterne er departure_lat, departure_lng, destination_lat og 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

Hvis du løser byene dine basert på steder og spørringer basert på koordinater, vil vårt API svare med alle restriksjoner (på lands- og statsnivå) som er nødvendige å forstå for reisenden som reiser fra avreiselandet til destinasjonslandet.

Tilleggsinformasjon

For visse typer innreisekrav kan det være tilknyttet tilleggsdata i et metadata-type felt kalt extras. Dette feltet er en nøkkel/verdi-mapping av ulike elementer med tilleggsinformasjon for et spesifikt krav.

Hvor mange dager med karantene?

Denne dataoppføringen er knyttet til innreisekrav type 5. I denne oppføringen vil **extras**-mappingen inneholde et felt kalt quarantine_days som vil inneholde et heltall for antall pålagte karantenedøgn.

Hvor mange timer før innreise for en negativ covid-test?

Denne dataoppføringen er knyttet til innreisekrav type 8. I denne oppføringen vil **extras**-mappingen inneholde et felt kalt entry_hours som vil inneholde et heltall for antall timer en negativ covid-test er gyldig før innreise.

Gi oss beskjed

Vi tror vi har et svært robust verktøy som sannsynligvis vil dekke alle dine behov for å hjelpe dine reisende med å forstå hva de sannsynligvis vil møte på veien. Hvis du har et spesifikt bruksområde vi ikke dekker, gi oss beskjed!

Vent… det er mer!

Denne oppføringen er del én av en to-delt serie som forklarer hvordan du samhandler med Sitata API-et for informasjon om innreisekrav og reiserestriksjoner. Så langt har vi snakket om innreisekrav som beskriver de strenge ja/nei-type betingelsene som kreves for å komme inn i et land eller en region, men vi har heller ikke snakket om hva som skjer innenfor landet. Det er én ting å vite hvordan man kommer inn i et land, det er en annen å forstå om det er mulig å bevege seg rundt i landet eller besøke strendene, eller om det er påbudt portforbud.

Følg med i del to som vil dykke dypere inn i vårt datasett for reiserestriksjoner. Hint: det er nesten identisk, så du kan alltid sjekke vår API-dokumentasjon mens du venter.