logotipo de sitata

Cómo utilizar la API de Sitata para determinar las restricciones de viaje para los viajeros

10 septiembre 2024
Restricciones de viaje API

Muchos de vosotros no lo sabéis, pero las primeras fundaciones de Sitata se construyeron para la detección precoz de enfermedades. De hecho, nuestra fundadora organizó un discurso TedX a partir de 2016 sobre las razones por las que debemos evitar la propagación de enfermedades a los viajeros. Il n'est donc pas surprenant que nous ayons appris l'existence du COVID-19, qui a été signalé comme un groupe habituel de cas de pneumonie au début du mois de décembre 2019. Le 2 janvier 2020, notre équipe de santé a décidé que nous devions émettre un premier avertissement à nos voyageurs et partenaires commerciaux. ¡C'était quelques jours avant même l'Organisation mondiale de la santé !

Durante las inevitables réplicas, hemos tenido una revelación. La enfermedad se propagaba tan rápidamente que era evidente para nosotros que la respuesta mundial sería más bien caótica. Cada país debía promulgar sus propias normas y reglas para controlar la propagación. Esto causaría estragos en todo el mundo y sería una fuente enorme de confusión para quienes quisieran seguir viajando. Teníamos razón y decidimos hacer algo para alejarnos. Sitata ha sido una de las primeras empresas del mundo en crear una API especializada y un servicio de seguimiento de los cambios introducidos en las restricciones de viaje y las condiciones de entrada tras la COVID-19. Gracias a un avanzado sistema logístico de detección de eventos y a un equipo de analistas especializados, ya disponemos de todas las herramientas y procesos necesarios para seguir adelante.

Desde la puesta en marcha de este nuevo servicio, varias organizaciones se han beneficiado de los datos en beneficio de sus propios clientes, entre ellas Eddy Travels, Flight Centre y Etihad Airways; ¡más información será anunciada próximamente! Con el fin de ayudar a un mayor número de organizaciones dedicadas a los viajes a beneficiarse de esta oferta, hemos redactado en detalle a continuación un cierto número de ejemplos para explicar cómo utilizar la API en diversos casos de uso. Espero que estas explicaciones le ayuden a llevar a cabo sus propias iniciativas.

Condiciones de acceso

Las primeras preguntas que se hace un viajero son, sin duda alguna: "¿Puedo irme?" y "¿Seré cuarentón?", por lo que es un buen punto de partida. Hemos creado un conjunto de datos sobre las condiciones de entrada para responder a preguntas difíciles del tipo "sí/no" sobre la entrada en un país o una región.

En el momento de redactar el presente documento, este conjunto de datos incluía las seis categorías siguientes:

  • ¿Puede un residente entrar en el país?
  • ¿Puede un extranjero entrar en el país?
  • ¿Está autorizado el tránsito por todo el país?
  • ¿Se exige una prueba a la llegada (aparición de una enfermedad)?
  • ¿Un certificado de prueba está autorizado (aparición de una enfermedad)?
  • ¿Es necesaria una cuarentena a la llegada (aparición de una enfermedad)? Es necesario vacunarse?
  • ¿Garantía requerida?
  • ¿Necesita un certificado de prueba?
  • ¿Formulario de inscripción requerido? (salud u otro)

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

  • Oui
  • Sí, con algunas excepciones
  • No
  • Non, sauf exceptions

Si la gran mayoría de los valores son "sí" y "no", la situación sobre el terreno no siempre es tan sencilla. En ocasiones, existen normas muy extrañas que varios gobiernos han puesto en práctica y que requieren tipos de valores "con excepciones".

Una condición de entrada es esencialmente un documento que documenta un conjunto de normas impuestas por un actor ante uno o varios países o regiones. En nuestra arquitectura de datos, el agente puede ser un país, un Estado o incluso un municipio. En conjunto, Sitata cubre actualmente los datos a nivel de país. Sin embargo, disponemos de algunos registros de Estados/provincias para algunas regiones, como los Estados Unidos y otras.

Cualquier registro que incluya una entrada en el campo origine_pays_division_id ou origine_pays_région_id Es un nivel que se sitúa respectivamente a nivel del Estado o a nivel municipal. Si desea disponer de datos más voluminosos, sírvase Contacte con nosotros y podremos discutir su caso de uso.

Tómese su tiempo para familiarizarse con la estructura de los datos de las condiciones de acceso a la consulta. nuestros documentos API ici.

Una parte de la estructura de los datos es bastante imprecisa, como demuestra el uso que hacemos del término "datos"."origine" Esta confusión se debe a que los desarrolladores consideran a menudo que el origen es el lugar de origen o el lugar de partida. O, 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.

Algunos ejemplos

Como has podido comprobar en la documentación, existen varias formas de recuperar los datos de la API. A continuación, vamos a revisar algunos de los casos de uso más comunes.

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

Existen varias formas de realizar este tipo de solicitud. La versión más sencilla consiste en utilizar el destino et départ parámetros. Estos parámetros aceptan los códigos ISO 3166-1 alfa-2 comme entrées

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

¿Y si quiero datos sobre el Estado?

Sitata dispone de datos a nivel de Estado para determinadas regiones. Asegúrese de que una entrada concreta es para un Estado si el origine_pays_division a un valor. También puede filtrar para no recuperar más datos que los que se encuentran en el estado actual utilizando el campo destino_paga_division parámetro. Tiene un 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

Tenga en cuenta que podría ser más sencillo realizar una búsqueda por país, y filtrar los datos por Estado para ver si existen, y utilizarlos si existen.

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

Al igual que para los países, la API Sitata puede transferir los resultados entre dos aeropuertos. Parámetros départ_aéroport et destino_aéroport utilizar los códigos de l'OACI ou de l'IATA para filtrar los resultados. La respuesta incluye todas las restricciones (a nivel de país y de Estado) necesarias para la comprensión del viajero que parte del país de partida correspondiente y llega al país de destino.

GET https://www.sitata.com/api/v2/entry_requirements?departure_airport=MUC&destination_airport=BOM

La respuesta comprende todas las restricciones (a nivel de país y de Estado) que debe tener en cuenta el viajero que parte del país de partida y se instala en el país de destino.

¿Y si no tengo información sobre la ciudad?

Sitata ha optado por no responder a las solicitudes que se refieran a un nombre de ciudad concreto, ya que esto podría dar lugar a confusiones. En lugar de ello, hemos optado por aceptar las peticiones de nuestra API mediante coordenadas de latitud y longitud, lo que no produce ninguna ambigüedad en nuestro conjunto de resultados. Los parámetros son los siguientes départ_lat, salida_lng, destino_latet 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

Si resuelve sus municipios en función de los lugares y las solicitudes en función de las coordenadas, nuestra API responderá con todas las restricciones (a nivel de país y de Estado) necesarias para la comprensión del viajero que parte del país de partida y se dirige al país de destino.

Información complementaria

Para determinados tipos de condiciones de entrada, puede haber datos suplementarios asociados en un campo de tipo de métadonnées llamado extras. Este campo es un mapeo clave/valor de diversos elementos de información complementaria para una exigencia particular

¿Cuántos días dura la cuarentena?

Esta recogida de datos está sujeta a la obligación de secreto tipo 5. En esta entrada, el extras la cartographie contiendra un champ appelé quarantaine_days que contiene un número entero para el número de días de cuarentena impuestos.

¿Cuántas horas deben transcurrir antes de que se inicie una prueba de covarianza negativa?

Esta recogida de datos está sujeta a la obligación de secreto tipo 8. En esta entrada, el extras la cartographie contiendra un champ appelé horas_entrada que contiene un número entero para el número de horas durante las cuales se autoriza una prueba covídica antes de la entrada.

Faites-nous savoir

Creemos que disponemos de una herramienta muy robusta que probablemente responderá a todas sus necesidades para ayudar a sus viajeros a comprender lo que pueden encontrar durante su viaje. Si tiene un caso de uso particular que no tratamos, háganoslo saber ¡savoir !

¡Attendez... il y a plus !

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 las condiciones de entrada y las restricciones de viaje. Hasta ahora, hemos hablado de las condiciones de entrada que describen los tipos de condiciones estrictas de tipo sí/no necesarias para entrar en un país o una región, pero no hemos hablado de lo que ocurre en el interior del país. Una cosa es saber cómo entrar en un país, y otra comprender si es posible instalarse en él o visitar sus playas o si es obligatorio pagar un suplemento.

Consulte el segundo artículo, que describe nuestra serie de datos sobre las restricciones de viaje. Astucia: es casi lo mismo, por lo que puede seguir consultando nuestro documentación sobre la API en attendant.

Seguro de viaje y asistencia que le ayuda tenga un mejor viaje

Descubra por qué miles de viajeros eligen Sitata cuando viajan

Derechos de autor © 2025 Sitata Inc.
We've detected you might be speaking a different language. Do you want to change to:
en_US English
en_US English
es_ES Español
fr_FR Français
it_IT Italiano
de_DE Deutsch
hu_HU Magyar
ro_RO Română
ar العربية
pl_PL Polski
pt_PT Português
nl_NL Nederlands
sv_SE Svenska
fi Suomi
nb_NO Norsk bokmål
da_DK Dansk
Close and do not switch language