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 de anunciar a los viajeros para ayudar a prevenir la propagación de la enfermedad. 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. 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 inevitável lluvia radioactiva tuvimos una epifanía. La enfermedad se 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 o seu propio conjunto de regulaciones y reglas para controlar a propagación. É inevitável causar estragos nas viagens mundiais e sería uma enorme fuga de confusão para aquellos que aún desean viajar. Teníamos razón y nos propusemos 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. Com um avançado sistema de software para a detecção de eventos e um equipamento dedicado de analistas, e tínhamos todas as ferramentas e processos específicos para o desenvolvimento.

Desde o lanzamiento deste novo serviço, temos uma variada gama de organizações que aprovam os dados em benefício dos seus clientes, incluindo Eddy Travels, Flight Centre, e Etihad Airways; ¡y hay más que se anunciarán pronto! Com o fim de ajudar a que mais organizações centradas nas viagens se beneficiem desta oferta, escrevemos em detalhe a continuação de uma série de explosivos para ajudar a explicar como utilizar a API para uma variedade de casos de uso. Espero que estas explicações expliquem as suas iniciativas em marcha.

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.

No momento de redactar o presente informe, este conjunto de dados inclui as siguientes 10 categorias 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?
• ¿Requere uma prueba a la llegada (brote de la enfermedad)?
• ¿Permite um 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?
• ¿Requerer um certificado de prueba?
• ¿Requere um formulário de inscrição? (salud u otro)

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

• Sí
• Sí, con excepciones
• Não
• Não, com excepções

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 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 esencialmente um registo que documenta um conjunto de normas impuestas por um agente contra uno o varios países ou regiões. O actor pode ser um país, estado ou município incluso em nossa arquitectura de dados. Em geral, Sitata cubre los datos a nivel de país en la actualidad. Pecado 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 origem_país_região_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, faça um click para familiarizar-se com a estructura de dados dos 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"originen” 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 restricción.

Outro ponto importante a salientar é como funciona a nossa lista de condados afectados. Se os países afectados estão vazios, deve ser interpretado como uma regra global, ou seja, todos os países são afectados.

Algunos ejemplos

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

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

Hay un par de maneras de hacer este tipo de petición. La versión más simple es usar el 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

A resposta incluirá todos os requisitos (a nível de país e de estado) necessários para que o viajante que parte do país de partida e viaja para o país de destino.

¿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 um 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

Observar que podría ser mais 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 no caso dos países, a API de Sitata puede devolver resultados entre os aeropuertos. Los parámetros aeropuerto de salida y aeropuerto de destino utilizar os códigos de la OACI o de la IATA para filtrar os 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 as restrições (a nivel de país y de estado) necessárias 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. No seu lugar, elegemos acomodar a consulta a nuestra API por coordenadas de latitud y longitud, lo que no produce ninguna ambigüedad en nuestro conjunto de resultados. Os parámetros filho partida_lat, partida_lng, destino_lat…y.. 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.8777

Se reencaminhar as suas cidades para as ubicaciones e consulta basada nas coordenadas, a nossa API responderá com todas as restrições (a nível de país e de estado) necessárias para comprender para o viajante que vende o país de salida e viaja ao país de destino.

Datos adicionales

Para algunos tipos de requisitos de entrada, pode haber datos adicionales asociados en un campo de tipo de metadados llamado extras. Este campo é uma cartografía clave/valor de varios bits extra de informação para um requisito particular

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

Esta entrada de dados está sujeita ao requisito de entrada tipo 5. En esta entrada, el extras 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?

Esta entrada de dados está sujeita ao requisito de entrada tipo 8. En esta entrada, el extras el mapeo contendrá un campo llamado entrada_horas 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

Cremos que tenemos una muy robusta que provavelmente satisfaga todas sus necesidades para ayudar a sus viajeros a entender lo que es probable que encuentren en el camino. Se 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 uma série de partes que explica cómo interactuar com a API de Sitata para os requisitos de entrada e a informação sobre restrições 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 región, pero tampoco hemos hablado de lo que ocurre dentro del país. Uma vez que se sabe acerca de entrar num país, e se é possível mover-se por esse país ou visitar as peças de teatro ou se é obrigatório um toque de queda.

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 documentación de la API mientras tanto.

Por favor, siga e como nós: