Es posible que muchos de ustedes 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 TedX de 2016 sobre por qué debemos advertir a los viajeros para ayudar a prevenir la propagación de enfermedades. Entonces, no debería sorprendernos que detectamos COVID-19 cuando se informó como un grupo inusual de casos de neumonía a principios de diciembre de 2019. Para el 2 de enero de 2020, nuestro equipo de salud determinó que deberí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 las consecuencias inevitables tuvimos una epifanía. La enfermedad se estaba propagando tan rápido que nos quedó claro que la respuesta global sería, en el mejor de los casos, caótica. Cada país promulgaría su propio conjunto de regulaciones y reglas sobre cómo controlar la propagación. Esto inevitablemente causaría estragos en los viajes globales y sería una gran fuente de confusión para aquellos que todavía desean viajar. Teníamos razón y nos dispusimos a hacer algo al respecto. Sitata fue una de las primeras empresas del mundo en crear una API dedicada y un servicio de monitoreo para los cambios en las restricciones de viaje y los requisitos de entrada como resultado de la COVID-19. Con un sistema de software avanzado para la detección de eventos y un equipo dedicado de analistas, ya contábamos con todas las herramientas y procesos adecuados para hacerlo.

Desde el lanzamiento de este nuevo servicio, varias organizaciones han aprovechado los datos en beneficio de sus propios clientes, incluidos Eddy Travels, Flight Centre y Etihad Airways; y hay más por anunciar pronto! Para ayudar a que más organizaciones enfocadas en viajes se beneficien de esta oferta, hemos escrito en detalle a continuación una serie de ejemplos para ayudar a explicar cómo usar la API para una variedad de casos de uso. Espero que estas explicaciones te ayuden a poner en marcha tus propias iniciativas.

Requisitos de entrada

Sin lugar a dudas, las primeras preguntas que un viajero hace son "¿puedo ir allí?" y "¿estaré en cuarentena?", por lo que este es un buen lugar para comenzar. Creamos el conjunto de datos de Requisitos de entrada para responder a las preguntas difíciles de tipo "sí/no" relacionadas con la entrada a un país o región.

En el momento de escribir este artículo, este conjunto de datos incluía las siguientes 10 categorías distintas:

• ¿Puede un residente ingresar al país?
• ¿Puede un extranjero ingresar al país?
• ¿Está permitido el tránsito por el país?
• ¿Se requiere una prueba a la llegada (brote de enfermedad)?
• ¿Se permite un certificado de prueba (brote de enfermedad)?
• ¿Se requiere cuarentena a la llegada (brote de enfermedad)? ¿Se requiere una vacuna?
• ¿Se requiere seguro?
• ¿Se requiere certificado de prueba?
• ¿Se requiere formulario de entrada? (salud u otro)

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

• Sí
• Sí, con excepciones
• No
• No, con excepciones

Si bien la gran mayoría de los valores son "sí" y "no", la situación sobre el terreno no siempre es tan sencilla. A veces, existen reglas realmente extrañas y locas que varios gobiernos han implementado y que requieren los tipos de valor "con excepciones".

Un requisito de entrada es esencialmente un registro que documenta un conjunto de reglas impuestas por un actor contra uno o varios países o regiones. El actor podría ser un país, un estado o incluso un municipio en nuestra arquitectura de datos. En general, Sitata cubre actualmente datos a nivel de país. Sin embargo, tenemos algunos registros estatales/provinciales para regiones seleccionadas, como Estados Unidos y otras.

Cualquier registro que tenga una entrada bajo el campo origin_country_division_id o país_origen_región_id es aquella que es de ámbito estatal o municipal, respectivamente. Si desea obtener más datos granulares disponibles, por favor Contáctenos y podemos hablar sobre su caso de uso.

Tómese un tiempo para familiarizarse con la estructura de datos del requisito de entrada al echando un vistazo a nuestros documentos API aquí.

Una parte un poco confusa sobre la estructura de datos es nuestro uso del término "origen.” Esto es confuso porque a menudo los desarrolladores piensan que el origen es el lugar de origen o el lugar de partida. Sin embargo, lo que entendemos por origen es en realidad el origen de la regla impuesta a otros. es decir, el país o región que ha creado la restricción.

Otro punto importante a tener en cuenta es cómo funciona nuestra lista de países afectados. Si los países_afectados están vacíos, debe interpretarse como una regla global. es decir, todos los países están afectados.

Algunos ejemplos

Como habrás 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 obtengo los requisitos entre dos países?

Hay un par de maneras de hacer este tipo de solicitud. La versión más simple es usar el destino y partida parámetros Estos parámetros aceptan ISO 3166-1 alfa-2 códigos como entradas.

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

La respuesta incluirá todos los requisitos (a nivel de país y estado) necesarios para que el viajero comprenda la salida del país de salida y el viaje al país de destino.

¿Qué pasa si quiero datos a nivel estatal?

Sitata tiene datos a nivel estatal para ciertas regiones. Sabrá que una entrada en particular es para un estado si el división_del_país_de_origen campo tiene un valor. También puede filtrar para recuperar solo datos a nivel de estado usando el destino_país_división parámetro. Se espera un ISO_3166-2 valor. Por ejemplo, US-TX para Texas, Estados Unidos.

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

Tenga en cuenta que podría ser más sencillo consultar por país y luego filtrar por datos de estado para ver si existen dichos datos y usarlos si existen.

¿Cómo obtengo los requisitos entre dos aeropuertos?

Al igual que con los países, la API de Sitata puede devolver resultados entre dos aeropuertos. Los parametros aeropuerto de salida y aeropuerto de destino utilizar cualquiera OACI o IATA códigos para filtrar los resultados. La respuesta incluirá todas las restricciones (a nivel de país y estado) necesarias para comprender que el viajero salga del país de salida correspondiente y viaje al país de destino.

OBTENGA 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 estado) necesarias para que el viajero comprenda que parte del país de salida y viaja al país de destino.

¿Qué pasa si solo tengo información de la ciudad?

Sitata optó por no acomodar las consultas por un nombre de ciudad en particular porque eso podría generar conflictos y confusión. En cambio, elegimos acomodar la consulta de nuestra API por coordenadas de latitud y longitud, lo que no produce ninguna ambigüedad en nuestro conjunto de resultados. Los parámetros son salida_lat, salida_lng, destino_lat, y destino_lng.

OBTENGA 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 en ubicaciones y consulta en función de las coordenadas, nuestra API responderá con todas las restricciones (a nivel de país y estado) necesarias para que el viajero comprenda que parte del país de salida y viaja al país de destino.

Datos adicionales

Para algunos tipos de requisitos de entrada, puede haber datos adicionales asociados en un campo de tipo de metadatos llamado extras. Este campo es una asignación de clave/valor de varios bits adicionales de información para un requisito particular.

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

Esta entrada de datos cae bajo el requisito de entrada tipo 5. En esta entrada, el extras mapeo contendrá un campo llamado dias_de_cuarentena que contendrá un número entero para el número de días de cuarentena impuesta.

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

Esta entrada de datos cae bajo el requisito de entrada tipo 8. En esta entrada, el extras mapeo contendrá un campo llamado horas_de_entrada que contendrá un número entero para la cantidad de horas que se permite una prueba de covid negativa antes de la entrada.

Haznos saber

Creemos que tenemos un sistema muy sólido que probablemente abordará todas sus necesidades para ayudar a sus viajeros a comprender lo que es probable que encuentren en el camino. Si tiene un caso de uso particular que no estamos abordando, ¡por favor déjanos saber!

Espera… ¡hay más!

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

Estén atentos a la segunda publicación que profundizará en nuestro conjunto de datos de Restricción de viaje. Sugerencia: es casi idéntico, por lo que siempre puede echar un vistazo a nuestro documentación de la API mientras tanto.

Síguenos y dale me gusta: