Hvordan du bruger Sitata API'en til at bestemme de begrænsninger, der gælder for rejsende

Skrevet af Madeline Sharpe

22. december 2020

Tecnología

Muchos de ustedes tal vez no lo sepan, pero los primeros 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 por qué necesitamos advertir a los viajeros para ayudar a prevenir la propagación de la enfermedad. No debe sorberprender 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. 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!

Durante la inevitable lluvia radioactiva tuvimos una epifanía. La enfermedad se estaba estaba extendiendo tan rápido que teníamos claro que la respuesta global sería caótica en el mejor de los casos. Cada país promulgaría su propio conjunto de regulaciones y reglas para controlar la propagación. Dette ville uundgåeligt skabe problemer i forbindelse med de globale rejser og ville skabe stor forvirring for dem, der ønsker at rejse. Teníamos razón y nos propusimos propusimos hacer algo al respecto. Sitata fue una de las primeras empresas del mundo en crear una API dedicada y un servicio de supervisión para los cambios en las restricciones de viaje y los requisitos de entrada como resultado de COVID-19. Con un avanzado sistema de software para la detección de eventos y un equipo dedicado de analistas, ya teníamos todas las herramientas y procesos adecuados para hacerlo.

Siden lanceringen af denne nye service har vi haft en lang række organisationer, som anvender dataene til gavn for deres egne kunder, herunder 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. Espero que estas explicaciones le ayuden a poner en marcha sus propias iniciativas.

Forudsætninger for adgang

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)

Cada categoría puede tener uno de los siguientes valores:

  • Sí, con excepciones
  • Nej
  • Nej, med undtagelser

Selv om størstedelen af værdierne er "sí" og "no", er situationen på jorden ikke altid så enkel. A veces hay reglas realmente extrañas y locas que varios gobiernos han puesto en marcha que requieren los tipos de valores "con excepciones"

Un requisito de entrada es es esencialmente un registro que documenta un conjunto de normas impuestas por un agente contra uno o varios países o regiones. El actor podría ser un país, estado o incluso municipio en nuestra arquitectura de datos. Generelt set er Sitata cubre los datos a nivel de país en la actualidad. Sin embargo, tenemos algunos registros estatales/provinciales para regiones seleccionadas como los Estados Unidos y otros

Cualquier registro que tenga una entrada bajo el campo origin_country_division_id o origin_country_region_id es uno que es de nivel estatal o municipal, respectivamente. Si desea disponer de más datos granulares, por favor, póngase en contacto 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 nuestros documentos de la API aquí.

Una parte un poco confusa sobre la estructura de los datos es nuestro uso del término"oprindelse" 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 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 restricción.

Et andet vigtigt punkt at bemærke er, hvordan vores liste over berørte lande fungerer. Hvis affected_countries er tomt, skal det fortolkes som en global regel, dvs. at alle lande er berørt.

Algunos ejemplos

Como habrán visto en la documentación, hay varias formas de recuperar datos de la API. A continuación veremos algunos de los casos de uso más comunes.

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

Der findes en række forskellige måder at gøre denne type anmodning på. Den mest enkle er at bruge den destino y salida parámetros. Estos parámetros aceptan los códigos ISO 3166-1 alfa-2 como entradas

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

Svaret vil omfatte alle de krav (på lande- og statsniveau), der er nødvendige for at forstå for den rejsende, der rejser fra afrejselandet og til bestemmelseslandet.

¿Y si quiero datos a nivel estatal?

Sitata tiene datos a nivel estatal para ciertas regiones. Usted sabrá que una entrada particular es para un estado si el división_país_original el campo tiene un valor. También puede filtrar para recuperar sólo los datos de nivel de estado usando el división_país_destino parámetro. Espera un valor ISO_3166-2. F.eks. US-TX for 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 má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?

Al igual que en el caso de los países, la API de Sitata puede devolver resultados entre dos aeropuertos. Parametre aeropuerto de salida y flyveplads til destination udnytte de koder, der er la OACI o de la IATA for at filtrere resultaterne. 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 eligió no dar cabida a las consultas por un nombre de ciudad en particular porque eso podría dar lugar a conflictos y confusión. En su lugar, elegimos acomodar la consultaar a nuestra API por coordenadas de latitud y longitud, lo que no produce ninguna ambigüedad en nuestro conjunto de resultados. Los parámetros son afgang_lat, departure_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

Hvis du vælger dine byer på grundlag af de lokale oplysninger og konsultationer, vil vores API svare på alle de begrænsninger (på lands- og statsniveau), der er nødvendige for at forstå for den rejsende, der sælger fra sit hjemland og rejser til sit bestemmelsesland.

Yderligere oplysninger

Para algunos tipos de requisitos de entrada, puede haber datos adicionales asociados en un campo de tipo de metadatos llamado ekstraudstyr. Dette felt er en kortlægning af forskellige ekstra oplysninger til et særligt behov.

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

Denne dataindsamling er omfattet af en adgangsforpligtelse tipo 5. I denne indledning, el ekstraudstyr 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 dataindsamling er omfattet af en adgangsforpligtelse tipo 8. I denne indledning, el ekstraudstyr 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

Creemos que tenemos una muy robusta que probablemente satisfaga todas sus necesidades para ayudar a sus viajeros a entender lo que es probable que encuentren en el camino. Si usted tiene un caso de uso particular que no estamos abordando, por favor háganoslo saber!

Espera... ¡hay más!

Esta entrada forma parte de una serie de dos partes que explica cómo interactuar con la API de Sitata para los requisitos de entrada y la información sobre restricciones de viaje. Hasta ahora hemos hablado de los Requisitos de Entrada que esbozan los duros sí/no tipos de requisitos necesarios para entrar en un país o region, pero tampoco hemos hablado de lo que ocurre dentro del país. Una cosa es saber acerca de entrar a un país, y otra es entender si es posible moverse por el país o visitar las playas o si hay un toque de queda obligatorio.

Manténgase en sintonía para el segundo post que se sumergirá en nuestro conjunto de datos de Restricción de Viaje. Pista - es casi idéntico, así que siempre puedes echar un vistazo a nuestra dokumentation de la API mientras tanto.

Følg og synes godt om os:

Relaterede artikler

From Metro to Marathon: Transportation Tips for The Paris Olympics

From Metro to Marathon: Transportation Tips for The Paris Olympics

Millions of people are expected to visit Paris for the 2024 Summer Olympic and Paralympic Games from 26 July to 11 August and 28 August to 8 September. Are you also gearing up to witness the games this year and looking for a perfect travel guide? Consider it done,...

Højpatogen fugleinfluenza - H5N1

Højpatogen fugleinfluenza - H5N1

Der findes en stamme af influenzavirus kaldet H5N1, som er meget dødelig for vilde fugle og tamfjerkræ (kyllinger, ænder osv.). Den har forårsaget store udbrud i tamme hønseflokke i de seneste årtier. I sjældne tilfælde har denne virus inficeret mennesker, der...

En forsmag på De Olympiske Lege i Paris 2024

En forsmag på De Olympiske Lege i Paris 2024

Legene i den XXXIII olympiade, også kendt som de olympiske og paralympiske sommerlege i 2024, er planlagt til at finde sted i Paris, Frankrig fra den 26. juli til den 11. august og fra den 28. august til den 8. september samtidigt. Turneringerne vil strække sig over ikoniske vartegn i Paris...