
Mange af jer ved det måske ikke, men Sitatas første stiftelser blev oprettet for at forebygge sygdomme. Vores grundlægger organiserede faktisk en TedX-diskussion i 2016 om grunde til, at vi skal advare rejsende mod spredning af sygdomme. Det er derfor ikke overraskende, at vi har fået kendskab til eksistensen af COVID-19, som blev signaleret som en gruppe beboede tilfælde af lungebetændelse i begyndelsen af december 2019. Den 2. januar 2020 besluttede vores sundhedsteam, at vi skulle udsende en Første advarsel til vores rejsende og kommercielle partnere. C'était quelques jours avant même l'Organisation mondiale de la santé!
I forbindelse med de uundgåelige tilbagefald har vi fået en afsløring. Sygdommen spredte sig så hurtigt, at det var klart for os, at det globale svar ville blive mere kaotisk. Hvert land skulle indføre sine egne regler og bestemmelser for at kontrollere udbredelsen. Det ville uundgåeligt skabe ødelæggelser i hele verden og være en enorm kilde til forvirring for dem, der endnu ville rejse. Vi havde en grund og besluttede at gøre noget for at komme væk. Sitata var en af de første virksomheder i verden til at skabe en dedikeret API og en tjeneste til at følge op på ændringer i rejserestriktioner og indrejsebetingelser i forbindelse med COVID-19. Takket være et avanceret system til registrering af begivenheder og et team af specialiserede analytikere har vi allerede alle de værktøjer og processer, der er nødvendige for at nå frem.
Siden lanceringen af denne nye tjeneste har flere organisationer fået gavn af oplysningerne til gavn for deres egne kunder, bl.a. Eddy Travels, Flight Centre og Etihad Airways; flere oplysninger vil snart blive annonceret! For at hjælpe et større antal organisationer med fokus på rejser med at drage fordel af dette tilbud, har vi nedenfor udarbejdet et vist antal eksempler for at forklare, hvordan API'en anvendes i forskellige tilfælde. Jeg håber, at disse forklaringer vil hjælpe dig med at starte dine egne initiativer.
De første spørgsmål, som en rejsende stiller, er uden tvivl: "Kan jeg rejse?" og "Vil jeg blive sat i karantæne?", det er altså et godt udgangspunkt. Vi har skabt en samling af data om indrejsebetingelserne for at kunne svare på vanskelige spørgsmål af typen "ja/nej" om indrejse i et land eller en region.
På tidspunktet for udarbejdelsen af dette dokument bestod denne samling af data af de følgende ti kategorier:
Hver kategori kan have en af de følgende værdier:
Hvis størstedelen af værdierne er "ja" og "nej", er situationen i terrænet ikke altid så enkel. Nogle gange findes der virkelig bizarre regler, som forskellige regeringer har indført, og som kræver værdiansættelser "med undtagelser".
En adgangsbetingelse er i bund og grund et dokument, der dokumenterer en række regler, som en aktør har pålagt et eller flere andre lande eller regioner. Aktøren kan være et land, en stat eller endda en kommune i vores dataarkitektur. I sin helhed dækker Sitata i øjeblikket data på landeniveau. Vi råder dog over nogle registreringer af stater/provinser for visse regioner, som USA og andre.
Enhver registrering, der indeholder en indgang under champen origine_pays_division_id
Ou origine_pays_région_id
er et niveau, der ligger henholdsvis på statsligt eller kommunalt niveau. Hvis du ønsker at have mere detaljerede oplysninger, bedes du vi kontakter og vi kan diskutere din brugssituation.
Tag dig tid til at sætte dig ind i strukturen af oplysninger om adgangsbetingelserne for konsulenter. vores dokumenter API her.
En del af dataenes struktur er lidt uoverskuelig, f.eks. vores brug af begrebet"oprindelse" Denne forvirring skyldes, at udviklerne ofte betragter oprindelsen som værende oprindelsesstedet eller udgangsstedet. Eller hvad vi forstår ved "oprindelse" er faktisk oprindelsen til den regel, der er pålagt andre, dvs. det land eller den region, der har skabt begrænsningen.
Et andet vigtigt punkt at bemærke er, hvordan vores liste over berørte lande fungerer. Hvis affected_countries er tom, skal den fortolkes som en global regel, dvs. at alle lande er berørt.
Som du har kunnet konstatere i dokumentationen, findes der flere måder at genvinde API'ens data på. I det følgende vil vi gennemgå nogle af de mest almindelige anvendelsestilfælde.
Der findes flere måder at gøre denne type forespørgsel på. Den mest enkle version består i at bruge destination
et afgang
parametre. Disse parametre accepterer koderne ISO 3166-1 alpha-2 som entréer
GET https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination=IN
Svaret vil omfatte alle krav (på lande- og statsniveau), der er nødvendige at forstå for den rejsende, der afgår fra afgangslandet og rejser til destinationslandet.
Sitata har data på statsniveau for visse regioner. Du kan se, at en bestemt indgang er for en stat, hvis den oprindelse_betaler_inddeling
en værdi. Du kan også filtrere for ikke at genvinde data på tilstandsniveau ved at bruge feltet destination_pays_division
paramètre. Den har en værdi 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
Bemærk, at det kan være nemmere at foretage en søgning pr. land og derefter filtrere dataene pr. stat for at se, om de findes, og bruge dem, hvis de findes.
Ligesom for landene kan API Sitata henvise resultaterne mellem to lufthavne. Parametrene départ_aéroport
et destination_aéroport
brug koderne i l'OACI ou de l'IATA for at filtrere resultaterne. Svaret omfatter alle de begrænsninger (på lands- og statsniveau), der er nødvendige for at forstå den rejsende, der rejser fra det pågældende afgangsland og ankommer til bestemmelseslandet.
GET https://www.sitata.com/api/v2/entry_requirements?departure_airport=MUC&destination_airport=BOM
Svaret omfatter alle de begrænsninger (på lands- og statsniveau), der er nødvendige at forstå for den rejsende, der rejser fra afrejselandet og befinder sig i bestemmelseslandet.
Sitata har valgt ikke at svare på forespørgsler om et bestemt bynavn, da det kunne medføre konflikter og forvirring. I stedet har vi valgt at acceptere forespørgslerne fra vores API via længde- og breddegradskoordinater, hvilket ikke giver nogen tvetydighed i vores samlede resultater. Parametrene er de følgende départ_lat
, afgang_lng
, destination_lat
et 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 dine byer i henhold til steder og krav i henhold til koordinater, svarer vores API med alle de begrænsninger (på lands- og statsniveau), der er nødvendige for at forstå den rejsende, der rejser fra afrejselandet og befinder sig i destinationslandet.
For visse typer af adgangsbetingelser kan der være yderligere data tilknyttet et område af metadata kaldet Ekstramateriale
. Dette felt er en kortlægning af nøgle/værdi af forskellige ekstra informationselementer til et særligt behov
Denne registrering af data er underlagt registreringspligt. type 5. I denne indledning, le Ekstramateriale
Kartografien indeholder et felt kaldet quarantaine_days
der indeholder et helt tal for det antal dage, der er pålagt.
Denne registrering af data er underlagt registreringspligt. type 8. I denne indledning, le Ekstramateriale
Kartografien indeholder et felt kaldet indgangstimer
der indeholder et helt tal for det antal timer, hvor en negativ covid-test er tilladt før indgangen.
Vi mener, at vi råder over et meget robust værktøj, der sandsynligvis opfylder alle dine behov for at hjælpe dine rejsende med at forstå, hvad de er tilbøjelige til at møde undervejs. Hvis du har et særligt anvendelsestilfælde, som vi ikke behandler, så gør os opmærksom på det. viden!
Denne indgang er en del af en serie af to parter, der forklarer, hvordan man interagerer med API Sitata for at få oplysninger om indrejsebetingelser og rejsebegrænsninger. Indtil nu har vi talt om indrejsebetingelser, der beskriver de typer strenge betingelser af typen ja/nej, der er nødvendige for at komme ind i et land eller en region, men vi har ikke talt mere om, hvad der sker inden for landets grænser. Det er en ting at vide, hvordan man kommer ind i et land, og det er en anden ting at forstå, om det er muligt at flytte sig i landet eller besøge strandene, eller om der er en obligatorisk dækningsafgift.
Læs også den anden artikel, der uddyber vores række af oplysninger om rejsebegrænsninger. Astuce : det er næsten identisk, du kan også altid konsultere vores Dokumentation om API en ledsager.