Sådan bruger du Sitatas API til at bestemme rejsebegrænsninger for rejsende

10. september 2024

Mange af jer ved det ikke, men de første centre i Sitata blev bygget for at kunne opdage sygdomme i tide. Derfor har vores grundlægger fået en TedX-udstilling i 2016 om Hvorfor er det nødvendigt at advare rejsende for at forhindre spredning af sygdommen?. Det er derfor ikke overraskende, at vi blev ramt af COVID-19, da vi blev informeret om en usædvanlig gruppe tilfælde af neumoni i begyndelsen af december 2019. El 2 de enero de 2020, nuestro equipo de salud determinó que debíamos emitir nuestra primera advertencia a nuestros viajeros y socios comerciales. ¡Esto fue días antes incluso de la Organización Mundial de la Salud!

Under den uundgåelige radioaktive regn havde vi en epifanía. Sygdommen bredte sig så hurtigt, at vi var klar over, at den globale reaktion ville være meget begrænset i de fleste tilfælde. Alle lande indførte deres egne regler og bestemmelser for at kontrollere udbredelsen. Det ville uundgåeligt skabe problemer på de globale rejser og være en enorm kilde til forvirring for dem, der stadig ønsker at rejse. Teníamos razón y nos propusimos hacer algo al respecto. Sitata var en af de første virksomheder i verden, der skabte en dedikeret API og en overvågningstjeneste for ændringer i rejsebegrænsninger og indrejsekrav som følge af COVID-19. Med et avanceret softwaresystem til at opdage hændelser og et dedikeret analysehold havde vi allerede de rette værktøjer og processer til at gøre det.

Siden lanceringen af denne nye tjeneste har vi haft en lang række organisationer, der bruger dataene til fordel for deres egne kunder, herunder Eddy Travels, Flight Centre og Etihad Airways; ¡og der er flere, som vi annoncerer snart! Med det formål at hjælpe flere organisationer med fokus på rejser til at drage fordel af dette tilbud, har vi skrevet en række eksempler for at forklare, hvordan API'et kan bruges i forskellige situationer. Espero que estas explicaciones le ayuden a poner en marcha sus propias iniciativas.

Krav til indgang

Sin duda, las primeras preguntas que un viajero hace son "¿puedo ir allí?" y "¿seré puesto en cuarentena?", así que este es un buen lugar para empezar. Hemos creado el conjunto de datos de Requisitos de Entrada para responder a los duros "sí/no" de las preguntas relativas a la entrada en un país o región.

På tidspunktet for udarbejdelsen af denne rapport omfattede dette datasæt de følgende 10 forskellige kategorier:

  • Kan en beboer komme ind i landet?
  • Kan en udlænding komme ind i landet?
  • ¿Se permite el tránsito por el país?
  • ¿Se requiere una prueba a la llegada (brote de la enfermedad)?
  • ¿Se permite un certificado de prueba (brote de una enfermedad)?
  • ¿Se requiere una cuarentena a la llegada (brote de enfermedad)? Er det nødvendigt med en vaccine?
  • Er det nødvendigt med et forsikringsselskab?
  • ¿Se requiere un certificado de prueba?
  • ¿Se requiere un formulario de inscripción? (sundhed eller andet)

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

  • Ja, med visse undtagelser
  • Nej
  • Nej, med visse undtagelser

Selv om de fleste værdier er "ja" og "nej", er situationen på jorden ikke altid så enkel. Nogle gange er der regler, der er virkelig ekstravagante og lokale, som forskellige regeringer har indført, og som kræver forskellige typer af værdier "med undtagelser".

Et adgangskrav er først og fremmest et register, der dokumenterer en samling normer, som en aktør har indført over for et eller flere lande eller regioner. Aktøren kan være et land, en stat eller en kommune i vores dataarkitektur. Generelt indeholder Sitata data på landeniveau i øjeblikket. Sin embargo, tenemos algunos registros estatales/provinciales para regiones seleccionadas como los Estados Unidos y otros

Enhver registrering, der har en indgang under kampagnen origin_country_division_id o oprindelse_land_region_id er en, der er på henholdsvis statsligt eller kommunalt niveau. Hvis du vil have flere oplysninger, bedes du kontakte os. con nosotros y podemos hablar de su caso de uso.

Por favor, tómese un tiempo para familiarizarse con la estructura de datos de los requisitos de entrada echando un vistazo a vores API-dokumenter her.

En del, der er lidt forvirrende i forhold til datastrukturen, er vores brug af begrebet"origen" Det er forvirrende, fordi de fleste udviklere mener, at oprindelsen er stedet, hvor de opstod, eller hvor de startede. Sin embargo, lo que queremos decir con origen es en realidad el origen de la regla impuesta a otros, es decir, el país o la región que ha creado la restrición.

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 set i dokumentationen, er der forskellige måder at genskabe data fra API'en på. A continuación veremos algunos de los casos de uso más comunes.

¿Cómo puedo obtener los requisitos entre dos países?

Der er flere måder at lave denne type anmodning på. Den mest enkle version er at bruge el destino y salida parámetros. Disse parametre accepterer tallene ISO 3166-1 alfa-2 como entradas

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.

¿Y si quiero datos a nivel estatal?

Sitata tiene datos a nivel estatal para ciertas regiones. Du ved, at en bestemt indgang er for en stat, hvis den división_país_original el campo tiene un valor. Du kan også filtrere for kun at genskabe data om tilstandsniveau ved hjælp af división_país_destino parámetro. Find en værdi ISO_3166-2. Por ejemplo, US-TX para Texas, Estados Unidos.

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

Bemærk, at det kunne være nemmere at foretage en søgning efter land og derefter filtrere efter data fra delstaterne for at se, om de findes, og bruge dem, hvis de findes.

¿Cómo puedo obtener los requisitos entre dos aeropuertos?

På samme måde som i andre lande kan API'en i Sitata levere resultater mellem to lufthavne. Parametre aeropuerto de salida y aeropuerto de destino bruge códigos de la OACI o de la IATA for at filtrere resultaterne. Svaret omfatter alle de begrænsninger (på lande- og statsniveau), der er nødvendige for at forstå den rejsende, der rejser fra det tilsvarende hjemland og til destinationslandet.

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

Svaret omfatter alle de restriktioner (på lande- og statsniveau), der er nødvendige for at forstå den rejsende, der rejser fra hjemlandet og til destinationslandet.

¿Y si sólo tengo información de la ciudad?

Sitata valgte ikke at foretage søgninger efter en bestemt by, fordi det kunne give anledning til konflikter og forvirring. I stedet valgte vi at tilpasse forespørgslen til vores API efter længde- og breddegrader, hvilket ikke giver nogen tvetydighed i vores samlede resultater. De vigtigste parametre er afgang_lat, afgang_lng, destination_lat...y.. 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

Si resuelve sus ciudades a las ubicaciones y consulta basada en las coordenadas, nuestra API responderá con todas las restricciones (a nivel de país y de estado) necesarias para comprender para el viajero que sale del país de salida y viaja al país de destino.

Yderligere oplysninger

For nogle typer adgangskrav kan der være yderligere data tilknyttet i en metadatakampagne med navnet Ekstramateriale. Denne kampagne er en kortlægning af forskellige ekstra oplysninger til en bestemt opgave.

¿Cuál es el número de días de cuarentena?

Denne indtastning af data er underlagt kravet om indtastning tipo 5. En esta entrada, el Ekstramateriale Kortet indeholder en kampagne med navnet días_de_cuarentena que contendrá un número entero para el número de días de cuarentena impuestos.

¿Cuál es el número de horas antes de la entrada para una prueba de covidio negativa?

Denne indtastning af data er underlagt kravet om indtastning tipo 8. En esta entrada, el Ekstramateriale Kortet indeholder en kampagne med navnet indgangstimer que contendrá un número entero para el número de horas que se permite una prueba covid negativa antes de la entrada.

Háganos saber

Vi mener, at vi har en meget robust løsning, der sandsynligvis opfylder alle behov for at hjælpe vores rejsende med at forstå, hvad de sandsynligvis vil møde på deres vej. Hvis du har et særligt tilfælde af brug, som vi ikke beskriver, por favor háganoslo saber!

Espera... ¡hay más!

Dette indlæg er en del af en serie på to dele, der forklarer, hvordan man interagerer med Sitatas API med hensyn til adgangskrav og oplysninger om rejsebegrænsninger. Hidtil har vi talt om indrejsekrav, der indeholder alle de krav, der er nødvendige for at komme ind i et land eller en region, men vi har ikke talt om, hvad der sker inde i landet. En ting er at vide, hvordan man kommer ind i et land, og en anden ting er at vide, om det er muligt at rejse rundt i landet eller besøge legepladserne, eller om der er et obligatorisk ophold.

Hold øje med det andet indlæg, som vil blive samlet i vores datagruppe for rejsebegrænsning. Pista - det er næsten identisk, så du kan altid få et overblik over vores dokumentation de la API mientras tanto.

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.