Slik bruker du API-et til Sitata for å fastsette reiserestriksjoner for reisende

10. september 2024

Mange av dere vet det ikke, men de første cimientos de Sitata se construyeron para la detección temprana de enfermedades. De hecho, nuestro fundador tiene una charla de TedX a partir de 2016 sobre hvorfor vi må advare reisende for å bidra til å forebygge spredning av sykdommen. No debe sorprender entonces que nos enteramos de COVID-19 cuando se informó de un inusual grupo de casos de neumonía a principios de diciembre de 2019. Den 2. januar 2020 bestemte vårt helseutvalg at vi måtte sende ut 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 uunngåelige radioaktive regntiden opplevde vi en epifanía. Sykdommen spredte seg så raskt at det var klart at den globale responsen i de fleste tilfellene ville bli for dårlig. Hvert land innførte sitt eget sett med reguleringer og regler for å kontrollere spredningen. Dette ville uunngåelig føre til forstyrrelser i de internasjonale reisene og være en enorm kilde til forvirring for alle som ønsker å reise. Teníamos razón y nos propusimos hacer algo al respecto. Sitata var et av de første selskapene i verden som opprettet et dedikert API og en overvåkningstjeneste for endringer i innreisebegrensninger og innreisekrav som følge av COVID-19. Med et avansert programvaresystem for å oppdage hendelser og et dedikert analyseapparat hadde vi allerede alle de nødvendige verktøyene og prosessene for å gjøre dette.

Siden lanseringen av denne nye tjenesten har vi hatt en rekke organisasjoner som bruker dataene til fordel for sine egne kunder, deriblant Eddy Travels, Flight Centre og Etihad Airways; ¡y hay más que se anunciarán pronto! Con el fin de ayudar a que más organizaciones centradas en los viajes se beneficien de esta oferta, hemos escrito en detalle a continuación una serie de ejemplos para ayudar a explicar cómo utilizar la API para una variedad de casos de uso. Håper at disse forklaringene kan hjelpe deg med å sette i gang dine egne initiativer.

Requisitos de entrada

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.

En el momento de redactar el presente informe, este conjunto de datos incluía las siguientes 10 categorías distintas:

  • ¿Puede un residente entrar en el país?
  • ¿Puede un extranjero entrar en el país?
  • ¿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)? ¿Se requiere una vacuna?
  • ¿Se requiere un seguro?
  • ¿Se requiere un certificado de prueba?
  • ¿Se requiere un formulario de inscripción? (salud u otro)

Hver kategori kan ha en av de følgende verdiene:

  • Sí, con excepciones
  • Nei
  • Nei, med unntak av

Selv om de fleste verdiene er "ja" og "nei", er situasjonen på jorda ikke alltid så enkel. Noen ganger finnes det regler som er virkelig ekstravagante og lokale, og som ulike regjeringer har innført, og som krever at visse typer verdier skal være "med unntak"

Et inngangsrekvisitt er først og fremst et register som dokumenterer en samling normer som en aktør har innført mot ett eller flere land eller regioner. Aktøren kan være et land, en stat eller en kommune i vårt dataarkitektur. Generelt sett inneholder Sitata data på landsnivå i dag. Sin embargo, tenemos algunos registros estatales/provinciales para regiones seleccionadas como los Estados Unidos y otros

Alle registre som har en inngang under kampanjen opprinnelsesland_divisjon_id o opprinnelsesland_region_id es uno que es de nivel estatal o municipal, respectivamente. Hvis du ønsker mer informasjon, vennligst ta kontakt med 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 våre API-dokumenter her.

En litt forvirrende del av datastrukturen er vår bruk av begrepet"origen" Esto es confuso porque a menudo los desarrolladores piensan que el origen es el lugar de origen o de partida. 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 annet viktig poeng er hvordan listen over berørte land fungerer. Hvis affected_countries er tom, skal den tolkes som en global regel, dvs. at alle land påvirkes.

Noen eksempler

Som du har sett i dokumentasjonen, finnes det ulike måter å hente ut data fra API-et på. A continuación veremos algunos de los casos de uso más comunes.

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

Det finnes flere måter å gjøre denne typen begjæringer på. Den enkleste versjonen er å bruke el destino y salida parámetros. Disse parametrene aksepterer følgende tall ISO 3166-1 alfa-2 como entradas

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

Svaret skal inneholde alle krav (på land- og delstatsnivå) som er nødvendige for å forstå hva som gjelder for den reisende som reiser fra avreiselandet til destinasjonslandet.

¿Y si quiero datos a nivel estatal?

Sitata tiene datos a nivel estatal para ciertas regiones. Du vet at en bestemt inngang er for en stat hvis den división_país_original el campo tiene un valor. Du kan også filtrere for å gjenfinne bare data om tilstandsnivået ved hjelp av división_país_destino parámetro. Espera un valor 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

Obsérvese que podría ser serás sencillo hacer una consulta por país y luego filtrar por los datos de los estados para ver si esos datos existen, y utilizarlos si existen.

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

På samme måte som i andre land kan API-et fra Sitata levere resultater mellom to flyplasser. Parametre aeropuerto de salida y aeropuerto de destino utilizar los códigos de la OACI o de la IATA para filtrar los resultados. La respuesta incluirá todas las restricciones (a nivel de país y de estado) necesarias para comprender al viajero que sale del país de salida correspondiente y viaja al país de destino.

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

La respuesta incluirá 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.

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

Sitata valgte å ikke bruke et bestemt antall byer for å søke etter en bestemt by, fordi det kunne føre til konflikter og forvirring. I stedet valgte vi å tilpasse konsultasjonen til vårt API etter bredde- og lengdekoordinater, noe som ikke skaper noen tvetydighet i våre resultater. De viktigste parameterne er avgang_lat, avgang_lng, destinasjon_lat...y.. 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

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.

Ytterligere opplysninger

For noen typer inngangskrav kan det finnes tilleggsopplysninger knyttet til en metadatakamp som kalles Ekstrautstyr. Denne kampanjen er en kartografía clave/valor av varios bits extra de información para un requerimiento particular

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

Denne datainngangen er underlagt kravet om datainngang tipo 5. En esta entrada, el Ekstrautstyr el mapeo contendrá un campo llamado 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 datainngangen er underlagt kravet om datainngang tipo 8. En esta entrada, el Ekstrautstyr el mapeo contendrá un campo llamado entry_hours 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 tror at vi har en veldig robust løsning som sannsynligvis vil tilfredsstille alle dine behov for å hjelpe dine reisende med å forstå hva de sannsynligvis vil finne på veien. Hvis du har et spesielt brukstilfelle som vi ikke har tatt opp, por favor háganoslo saber!

Espera... ¡hay más!

Dette innlegget er en del av en serie på to deler som forklarer hvordan du kan samhandle med Sitatas API for innreisekrav og informasjon om reiserestriksjoner. Hittil har vi snakket om innreisekrav, som inneholder de fleste typer krav som er nødvendige for å komme inn i et land eller en region, men vi har ikke snakket om hva som skjer innenfor landet. En ting er å vite hvordan man kommer inn i et land, og en annen ting er å vite om det er mulig å reise rundt i landet eller besøke lekene, eller om det er et obligatorisk krav til opphold.

Manténgase en sintonía para el segundo post que se sumergirá en nuestro conjunto de datos de Restricción de Viaje. Pista - det er helt identisk, slik at du alltid kan få et glimt av våre documentación de la API mientras tanto.

Reiseforsikring og assistanse som hjelper deg få en bedre reise

Se hvorfor tusenvis av reisende velger Sitata når de skal ut og reise

Opphavsrett © 2025 Sitata Inc.