sitata logo

Hvordan bruger man Sitatas API til at bestemme rejsebegrænsninger for de rejsende?

10. september 2024
Rejsebegrænsninger API

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.

Indgangsbetingelser

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:

  • Kan en beboer komme ind i landet?
  • Kan en udlænding komme ind i landet?
  • Er transit tilladt på tværs af landet?
  • Er det nødvendigt med en test ved ankomst (forekomst af en sygdom)?
  • Er et testcertifikat godkendt (forekomst af en sygdom)?
  • Er det nødvendigt med en vaccination ved ankomst (forekomst af en sygdom)? Er en vaccination nødvendig?
  • Nødvendig forsikring?
  • Certificat de test requis?
  • Er der brug for en tilmeldingsformular? (sundhed eller andet)

Hver kategori kan have en af de følgende værdier:

  • Ja
  • Ja, med visse undtagelser
  • Ikke
  • Nej, undtagen undtagelser

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.

Nogle eksempler

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.

Hvordan opnås kravene mellem to lande?

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.

Og hvis jeg vil have oplysninger på statsniveau?

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.

Hvordan kan jeg opnå kravene mellem to lufthavne?

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.

Og hvis jeg ikke har nogen oplysninger om byen?

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

Yderligere oplysninger

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

Hvad er antallet af quarantaine-dage?

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.

Hvad er antallet af timer før indgangen til en negativ covid-test?

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.

Gør os klogere

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!

Vent... der er mere!

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.

Rejseforsikring og assistance, der hjælper dig få en bedre rejse

Se, hvorfor tusindvis af rejsende vælger Sitata, når de rejser

Copyright © 2025 Sitata Inc.
We've detected you might be speaking a different language. Do you want to change to:
en_US English
en_US English
es_ES Español
fr_FR Français
it_IT Italiano
de_DE Deutsch
hu_HU Magyar
ro_RO Română
ar العربية
pl_PL Polski
pt_PT Português
nl_NL Nederlands
sv_SE Svenska
fi Suomi
nb_NO Norsk bokmål
da_DK Dansk
Close and do not switch language