Puede que muchos de ustedes no lo sepan, pero los primeros cimientos de Sitata se construyeron para la detección precoz de enfermedades. De hecho, nuestro fundador tiene una charla TedX de 2016 sobre... por qué debemos advertir a los viajeros para evitar la propagación de enfermedades. Por lo tanto, no debería sorprendernos que detectáramos el COVID-19 cuando se notificó como un grupo inusual de casos de neumonía a principios de diciembre de 2019. El 2 de enero de 2020, nuestro equipo sanitario 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 radiactiva tuvimos una epifanía. La enfermedad se propagaba tan rápidamente que teníamos claro que la respuesta mundial sería, en el mejor de los casos, caótica. Cada país promulgaría sus propias normas y reglas para controlar la propagación. Esto inevitablemente causaría estragos en los viajes por todo el mundo y sería una enorme fuente de confusión para aquellos que aún quisieran viajar. Teníamos razón y nos propusimos hacer algo al respecto. Sitata fue una de las primeras empresas del mundo en crear una API dedicada y un servicio de seguimiento de los cambios en las restricciones de viaje y los requisitos de entrada como consecuencia de COVID-19. Con un sistema de software avanzado para la detección de eventos y un equipo dedicado de analistas, ya disponíamos de 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, entre ellas Eddy Travels, Flight Centre y Etihad Airways, y pronto anunciaremos otras. 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.
Sin duda, las primeras preguntas que se hace un viajero son "¿puedo ir allí?" y "¿me pondrán en cuarentena?", por lo que este es un buen punto de partida. Hemos creado el conjunto de datos Requisitos de entrada para responder a las preguntas difíciles del tipo "sí/no" relativas a la entrada en un país o región.
En el momento de redactar este documento, este conjunto de datos incluía las 10 categorías siguientes:
Cada categoría puede tener uno de los siguientes valores:
Aunque la gran mayoría de los valores son "sí" y "no", la situación sobre el terreno no siempre es tan sencilla. A veces hay normas realmente extrañas y disparatadas que los distintos gobiernos han puesto en marcha y que obligan a utilizar los tipos de valores "con excepciones".
Un requisito de entrada es esencialmente un registro que documenta un conjunto de normas impuestas por un actor contra uno o varios países o regiones. En nuestra arquitectura de datos, el actor puede ser un país, un estado o incluso un municipio. En general, Sitata cubre actualmente datos a nivel nacional. Sin embargo, disponemos de algunos registros estatales/provinciales para determinadas regiones, como Estados Unidos y otras.
Cualquier registro que tenga una entrada en el campo origin_country_division_id o origin_country_region_id es uno a nivel estatal o municipal, respectivamente. Si desea disponer de datos más detallados, por favor Contacto y podemos hablar de su caso de uso.
Tómese su tiempo para familiarizarse con la estructura de datos de los requisitos de acceso. echando un vistazo a nuestros documentos API aquí.
Una parte ligeramente confusa de la estructura de datos es el uso que hacemos del término "origen." Esto es confuso porque a menudo los desarrolladores piensan en el origen como el lugar de procedencia o de partida. Sin embargo, lo que entendemos por origen es en realidad el origen de la norma impuesta a otros, es decir, el país o la 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 affected_countries está vacía, debe interpretarse como una regla global, es decir, que afecta a todos los países.
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.
Hay un par de maneras de hacer este tipo de petición. La versión más sencilla es utilizar la función destino y salida parámetros. Estos parámetros aceptan ISO 3166-1 alfa-2 como entradas.
GET https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination=INLa respuesta incluirá todos los requisitos (a nivel de país y de estado) que sea necesario comprender para el viajero que parte del país de salida y viaja al país de destino.
Sitata dispone de datos a nivel estatal para determinadas regiones. Sabrá que una entrada concreta corresponde a un estado si la entrada origen_país_división tiene un valor. También puede filtrar para recuperar sólo los datos a nivel de estado utilizando la función división_país_de_destino parámetro. Espera un ISO_3166-2 valor. Por ejemplo, US-TX para Texas, Estados Unidos.
GET https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination_country_division=IN-APTenga en cuenta que podría ser más sencillo realizar una consulta por país y luego filtrar por datos estatales para ver si existen tales datos, y utilizarlos en caso afirmativo.
Al igual que con los países, la API de Sitata puede devolver resultados entre dos aeropuertos. Los parámetros aeropuerto_de_salida y aeropuerto_de_destino utilizar OACI o IATA para filtrar los resultados. La respuesta incluirá todas las restricciones (a nivel de país y de estado) necesarias de entender para el viajero que parte 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=BOMLa respuesta incluirá todas las restricciones (a nivel de país y de estado) que sea necesario comprender para el viajero que parte del país de salida y viaja al país de destino.
Sitata ha optado por no dar cabida a las consultas por el nombre de una ciudad concreta, ya que ello podría dar lugar a conflictos y confusiones. En su lugar, hemos optado por consultar 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_laty destino_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.8777Si resuelve sus ciudades en ubicaciones y realiza una consulta basada en coordenadas, nuestra API responderá con todas las restricciones (a nivel de país y de estado) necesarias para comprender al viajero que parte del país de salida y viaja al país de destino.
Para algunos tipos de Requisitos de acceso, puede haber datos adicionales asociados en un campo de tipo metadatos denominado extras. Este campo es una correspondencia clave/valor de varios bits adicionales de información para un requisito concreto.
Esta entrada de datos corresponde al requisito de entrada tipo 5. En esta entrada, el extras contendrá un campo denominado días_de_cuarentena que contendrá un número entero para el número de días de cuarentena impuestos.
Esta entrada de datos corresponde al requisito de entrada tipo 8. En esta entrada, el extras contendrá un campo denominado horas_entrada que contendrá un número entero para el número de horas que se permite una prueba covid negativa antes de la entrada.
Creemos que tenemos una solución muy sólida que probablemente satisfaga todas sus necesidades para ayudar a sus viajeros a comprender lo que probablemente encontrarán por el camino. Si tienes un caso de uso particular que no estamos abordando, Háganoslo saber.
Esta entrada forma parte de una serie de dos partes que explican 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 requisitos estrictos de tipo sí/no necesarios para entrar en un país o región, pero tampoco hemos hablado de lo que ocurre dentro del país. Una cosa es saber cómo entrar en un país y otra es saber si es posible moverse por él o visitar sus playas o si hay toque de queda obligatorio.
Estén atentos a la segunda entrada, en la que profundizaremos en nuestro conjunto de datos sobre restricciones de viaje. Pista: es casi idéntico, así que siempre puedes echar un vistazo a nuestro Documentación API mientras tanto.
English 
Español 
Français 
Italiano 
Deutsch 
Magyar 
Română 
العربية 
Polski 
Português 
Nederlands 
Svenska 
Suomi 
Norsk bokmål 
Dansk