Mange av dere vet kanskje ikke dette, men Sitatas tidlige grunnlag ble bygget for tidlig sykdomsoppdagelse. Faktisk har grunnleggeren vår en TedX-forelesning fra 2016 som handler om hvorfor vi må advare reisende for å bidra til å forhindre sykdomsspredning. Det bør derfor ikke komme som noen overraskelse at vi plukket opp covid-19 da det ble rapportert som en uvanlig klynge av tilfeller av lungebetennelse tidlig i desember 2019. Innen 2. januar 2020 bestemte helseteamet vårt at vi skulle utstede vår første advarsel til våre reisende og forretningspartnere. Dette var dager før til og med Verdens helseorganisasjon!

Under det uunngåelige nedfallet 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 ville innføre sine egne forskrifter og regler for hvordan spredningen skulle kontrolleres. Dette ville uunngåelig skape kaos i den globale reisetrafikken og være en stor kilde til forvirring for dem som fortsatt ø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 som opprettet en egen API og overvåkingstjeneste for endringene i reiserestriksjoner og innreisekrav som følge av covid-19. Med et avansert programvaresystem for hendelsesdeteksjon og et dedikert team av analytikere hadde vi allerede alle de riktige verktøyene og prosessene på plass for å gjøre dette.

Siden lanseringen av denne nye tjenesten har vi hatt en rekke organisasjoner som har benyttet seg av dataene til fordel for sine egne kunder, inkludert Eddy Travels, Flight Centre og Etihad Airways, og flere vil bli annonsert snart! For å hjelpe flere reisefokuserte organisasjoner med å dra nytte av dette tilbudet, har vi skrevet i detalj nedenfor en rekke eksempler for å forklare hvordan du bruker API-en for en rekke bruksområder. Jeg håper disse forklaringene hjelper deg med å komme i gang med dine egne initiativer.

Opptakskrav

De første spørsmålene en reisende stiller er uten tvil "kan jeg reise dit?" og "vil jeg bli satt i karantene", så dette er et godt sted å begynne. Vi har laget datasettet om innreisekrav for å svare på spørsmål av typen "ja/nei" om innreise til et land eller en region.

I skrivende stund inkluderte dette datasettet følgende 10 forskjellige kategorier:

• Kan en innbygger reise inn i landet?
• Kan en utlending reise inn i landet?
• Er transitt gjennom landet tillatt?
• Kreves det en test ved ankomst (sykdomsutbrudd)?
• Er et testsertifikat tillatt (sykdomsutbrudd)?
• Kreves det karantene ved ankomst (sykdomsutbrudd)? Er det nødvendig med vaksinasjon?
• Kreves det forsikring?
• Testsertifikat påkrevd?
• Påkrevd påmeldingsskjema (helse eller annet)

Hver kategori kan ha en av følgende verdier:

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

Selv om de aller fleste verdiene er "ja" og "nei", er ikke situasjonen på bakken alltid så enkel. Noen ganger er det virkelig rare og sprø regler som ulike regjeringer har innført, noe som nødvendiggjør verditypene "med unntak".

Et oppføringskrav er i hovedsak en post som dokumenterer et sett med regler som en aktør har pålagt 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 dataarkitektur. I det store og hele dekker Sitata for øyeblikket data på landnivå. Vi har imidlertid noen delstats-/provinsregistre for utvalgte regioner som USA og andre.

Enhver post som har en oppføring under feltet origin_country_division_id eller origin_country_region_id er enten på statlig eller kommunalt nivå. Hvis du vil ha mer detaljerte data tilgjengelig, kan du kontakte kontakt oss og vi kan snakke om ditt brukstilfelle.

Vennligst ta deg tid til å gjøre deg kjent med datastrukturen for Entry Requirement ved å ta en titt på API-dokumentene våre her.

En litt forvirrende del ved datastrukturen er vår bruk av begrepet "opprinnelse." Dette er forvirrende fordi utviklere ofte tenker på opprinnelse som opprinnelsesstedet eller avgangsstedet. Det vi mener med opprinnelse, er imidlertid opprinnelsen til regelen som pålegges andre, dvs. landet eller regionen som har innført restriksjonen.

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

Noen eksempler

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

Hvordan henter jeg kravene mellom to land?

Det finnes et par måter å gjøre denne typen forespørsler på. Den enkleste versjonen er å bruke destinasjon og avgang parametere. Disse parametrene godtar ISO 3166-1 alfa-2 koder som inndata.

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

Svaret vil omfatte alle krav (på land- og delstatsnivå) som er nødvendige å forstå for den reisende som reiser fra avgangslandet og til bestemmelseslandet.

Hva om jeg vil ha data på delstatsnivå?

Sitata har data på delstatsnivå for visse regioner. Du vil vite at en bestemt oppføring er for en delstat, hvis origin_country_division feltet har en verdi. Du kan også filtrere for bare å hente data på delstatsnivå ved hjelp av feltet destination_country_division parameter. 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 etter statsdata for å se om slike data finnes, og bruke dem hvis de finnes.

Hvordan henter jeg kravene mellom to flyplasser?

På samme måte som med land, kan Sitata API returnere resultater mellom to flyplasser. Parametrene avreise_flyplass og destinasjon_flyplass Bruk enten ICAO eller IATA koder for å filtrere resultatene. Svaret vil omfatte alle restriksjoner (på land- og delstatsnivå) som er nødvendige å forstå for den reisende som reiser fra det tilsvarende avgangslandet og til bestemmelseslandet.

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

Svaret vil omfatte alle restriksjoner (på land- og delstatsnivå) som er nødvendige å forstå for den reisende som reiser fra avgangslandet og til bestemmelseslandet.

Hva om jeg bare har byinformasjon?

Sitata valgte å ikke legge til rette for søk etter et bestemt bynavn fordi det kunne føre til konflikter og forvirring. I stedet valgte vi å legge til rette for å søke i API-et vårt etter bredde- og lengdegradskoordinater, noe som ikke gir noen tvetydighet i resultatsettet vårt. Parameterne er departure_lat, departure_lng, destinasjon_latog 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 oppløser byene dine til steder og søker basert på koordinater, vil API-et vårt svare med alle restriksjoner (på land- og delstatsnivå) som er nødvendige for å forstå for den reisende som reiser fra avgangslandet og til bestemmelseslandet.

Ekstra data

For noen typer innreisekrav kan det være ekstra tilknyttede data i et metadatatypefelt som heter Statister. Dette feltet er en nøkkel/verdikartlegging av ulike ekstra opplysninger for et bestemt krav.

Hva er antall karantenedager?

Denne dataregistreringen faller inn under oppføringskravet type 5. I denne oppføringen er Statister kartleggingen vil inneholde et felt som heter karantene_dager som vil inneholde et heltall for antall pålagte karantenedager.

Hva er antall timer før innreise for en negativ covid-test?

Denne dataregistreringen faller inn under oppføringskravet type 8. I denne oppføringen er Statister kartleggingen vil inneholde et felt som heter entry_hours som vil inneholde et heltall for antall timer som en negativ covid-test er tillatt før innreise.

Gi oss beskjed

Vi tror vi har en veldig robust løsning som sannsynligvis vil dekke alle behovene dine for å hjelpe de reisende med å forstå hva de sannsynligvis vil møte underveis. Hvis du har et bestemt bruksområde som vi ikke tar opp, kan du kontakte oss, vennligst gi oss beskjed!

Vent... det er mer!

Dette innlegget er en del av en serie i to deler som forklarer hvordan du samhandler med Sitata API for informasjon om innreisekrav og reiserestriksjoner. Så langt har vi snakket om innreisekrav som skisserer de harde ja/nei-kravene som er nødvendige for å reise inn i et land eller en region, men vi har ikke snakket om hva som skjer inne i landet heller. En ting er å vite om innreise til et land, noe annet er å vite om det er mulig å bevege seg rundt i landet eller besøke strendene, eller om det er portforbud.

Følg med på det andre innlegget som vil gå i dybden på datasettet vårt om reiserestriksjoner. Hint - det er nesten identisk, så du kan alltid ta en titt på vår API-dokumentasjon i mellomtiden.

Vennligst følg og lik oss: