Cómo usar las API de Sitata para determinar las restricciones de viaje para viajeros

Muchos de ustedes quizás no lo sepan, pero los primeros cimientos de Sitata se construyeron para la detección temprana de enfermedades. De hecho, nuestra fundadora dio una charla TedX en 2016 sobre por qué debemos alertar a los viajeros para prevenir la propagación de enfermedades. Así que no es de extrañar que nos enteráramos del COVID-19, que fue reportado como un grupo inusual de casos de neumonía a principios de diciembre de 2019. El 2 de enero de 2020, nuestro equipo de salud decidió que debíamos emitir una alerta temprana a nuestros viajeros y socios comerciales. ¡Eso fue unos días antes incluso que la Organización Mundial de la Salud!

Durante las inevitables consecuencias, tuvimos una revelación. La enfermedad se estaba propagando tan rápido que para nosotros estaba claro que la respuesta global sería, en el mejor de los casos, caótica. Cada país iba a promulgar sus propias regulaciones y reglas para controlar la propagación. Esto inevitablemente causaría estragos en todo el mundo y sería una gran fuente de confusión para quienes aún deseaban viajar. Teníamos razón y decidimos hacer algo al respecto. Sitata fue una de las primeras empresas del mundo en crear una API dedicada y un servicio para rastrear los cambios en las restricciones de viaje y los requisitos de entrada a raíz del COVID-19. Gracias a un avanzado sistema de software de detección de eventos y un equipo de analistas especializados, ya teníamos todas las herramientas y procesos necesarios para lograrlo.

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

Requisitos de Entrada

Las primeras preguntas que sin duda se hace un viajero son: “¿Puedo ir?” y “¿Me pondrán en cuarentena?”, así que es un buen punto de partida. Creamos el conjunto de datos de Requisitos de Entrada para responder las difíciles preguntas de tipo “sí/no” sobre ingresar a un país o región.

Al momento de escribir esto, este conjunto de datos incluía las siguientes diez categorías distintas:

• ¿Puede un residente ingresar al país?
• ¿Puede un extranjero ingresar al país?
• ¿Se permite el tránsito a través del país?
• ¿Se requiere una prueba a la llegada (aparición de enfermedad)?
• ¿Se permite un certificado de prueba (aparición de enfermedad)?
• ¿Se requiere cuarentena a la llegada (aparición de enfermedad)?
• ¿Se requiere vacunación?
• ¿Se requiere seguro?
• ¿Se requiere certificado de prueba?
• ¿Se requiere formulario de registro? (salud u otro)

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

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

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

Un requisito de entrada es básicamente un documento que registra un conjunto de reglas impuestas por un actor contra uno o más países o regiones. El actor puede 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 a nivel de estado/provincia para ciertas regiones, como Estados Unidos y otros.

Cualquier registro que tenga una entrada en el campo **origin_country_division_id** o **origin_country_region_id** es un nivel que está respectivamente a nivel estatal o a nivel municipal. Si deseas datos más granulares, por favor contáctanos y podemos discutir tu caso de uso.

Tómate un momento para familiarizarte con la estructura de datos de los Requisitos de Entrada consultando nuestra documentación de la API aquí.

Parte de la estructura de datos es un poco confusa, específicamente nuestro uso del término “origen”. Esta confusión surge porque los desarrolladores a menudo consideran el origen como el lugar de procedencia o el punto 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 región que creó la restricción.

Otro punto importante a tener en cuenta es cómo funciona nuestra lista de países afectados. Si affected_countries está vacía, 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, repasaremos algunos de los casos de uso más comunes.

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

Hay varias formas de hacer este tipo de solicitud. La versión más simple es usar los parámetros **destination** y **departure**. Estos parámetros aceptan códigos ISO 3166-1 alpha-2 como entradas.

GET 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 los comprenda al partir desde el país de salida y viajar al país de destino.

¿Y si quiero datos a nivel de estado?

Sitata tiene datos a nivel de estado para ciertas regiones. Sabrás que una entrada en particular es para un estado si el campo origin_country_division tiene un valor. También puedes filtrar para recuperar solo datos a nivel de estado usando el parámetro **destination_country_division**. Espera un valor ISO_3166-2. Por ejemplo, US-TX para Texas, EE. UU.

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

Ten en cuenta que podría ser más simple buscar por país y luego filtrar los datos por estado para ver si esos datos existen, y usarlos si es así.

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

Al igual que con los países, la API de Sitata puede devolver resultados entre dos aeropuertos. Los parámetros departure_airport y destination_airport usan códigos OACI o IATA para filtrar los resultados. La respuesta incluirá todas las restricciones (a nivel de país y estado) necesarias para que el viajero las comprenda al partir desde el país de salida correspondiente y viajar 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 estado) necesarias para que el viajero las comprenda al partir desde el país de salida y viajar al país de destino.

¿Y si solo tengo información de la ciudad?

Sitata ha optado por no responder solicitudes basadas en un nombre de ciudad específico, ya que eso podría generar conflictos y confusiones. En su lugar, hemos optado por aceptar consultas a nuestra API por coordenadas de latitud y longitud, lo que no produce ambigüedad en nuestro conjunto de resultados. Los parámetros son departure_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

Si resuelves tus ciudades a ubicaciones y consultas por coordenadas, nuestra API responderá con todas las restricciones (a nivel de país y estado) necesarias para que el viajero las comprenda al partir desde el país de salida y viajar al país de destino.

Información Adicional

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

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

Esta entrada de datos está sujeta al requisito de entrada tipo 5. En esta entrada, el mapeo **extras** contendrá un campo llamado quarantine_days que contendrá un número entero para la cantidad de días de cuarentena impuestos.

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

Esta entrada de datos está sujeta al requisito de entrada tipo 8. En esta entrada, el mapeo **extras** contendrá un campo llamado entry_hours que contendrá un número entero para la cantidad de horas durante las cuales se permite una prueba de covid negativa antes de la entrada.

Háznoslo Saber

Creemos que tenemos una herramienta muy robusta que probablemente satisfaga todas tus necesidades para ayudar a tus viajeros a comprender lo que es probable que encuentren en el camino. Si tienes un caso de uso particular que no cubrimos, ¡háznoslo 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 requisitos de entrada y restricciones de viaje. Hasta ahora, hemos hablado de los requisitos de entrada que describen los tipos de condiciones estrictas de sí/no necesarias para ingresar a un país o región, pero tampoco hemos hablado de lo que sucede dentro del país. Una cosa es saber cómo 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.

Mantente atento para la segunda publicación que profundizará en nuestra serie de datos de restricciones de viaje. Pista: es casi idéntica, por lo que siempre puedes consultar nuestra documentación de la API mientras tanto.