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

10 septembrie 2024

Muchos de ustedes tal vez no lo sepan, pero los primeros cimientos de Sitata se construyeron para la detección temprana de enfermedades. De fapt, fondatorul nostru are o diplomă TedX începând din 2016 despre de ce trebuie să avertizăm călătorii pentru a ajuta la prevenirea propagării bolii. No debe sorprender entonces que nos enteramos de COVID-19 cuando se informó de un grupo neobișnuit 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 prima noastră publicitate pentru călătorii noștri și partenerii comerciali. ¡Esto fue días antes incluso de la Organización Mundial de la Salud!

În timpul inevitabilei ploi radioactive am avut o epidemie. 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. Fiecare țară își promulga propriul ansamblu de reglementări și reguli pentru a controla propagarea. În mod inevitabil, acest lucru ar provoca dificultăți în călătoriile mondiale și ar fi o sursă enormă de confuzie pentru cei care încă doresc să călătorească. 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 supervisión para los cambios en las restricciones de viaje y los requisitos de entrada como resultado de COVID-19. Cu un sistem avansat de software pentru detectarea evenimentelor și o echipă dedicată de analiști, aveam deja toate instrumentele și procesele adecvate pentru a o face.

De la lansarea acestui nou serviciu am avut o varietate de organizații care utilizează datele în beneficiul propriilor clienți, inclusiv Eddy Travels, Flight Centre și Etihad Airways; există și altele care vor fi anunțate imediat! Cu scopul de a ajuta ca mai multe organizații axate pe călătorii să beneficieze de această ofertă, am scris în detaliu în continuare o serie de exemple pentru a ajuta la explicarea modului de utilizare a API pentru o varietate de cazuri de utilizare. Espero que estas explicaciones le ayuden a poner en marcha sus own initiatives.

Cerințe de intrare

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 creato 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.

En el momento de redactar el presente informe, este conjunto de datos incluía las siguientes 10 categorías distintas:

  • Poate un rezident să intre în țară?
  • ¿Puede un extranjero entrar en el país?
  • Se permite tranzitul prin țară?
  • ¿Se requiere una prueba a la llegada (brote de la enfermedad)?
  • ¿Se permite un certificat de probă (brote de una enfermedad)?
  • Necesită o cuarentenă la sosire (brotă de boală)? Este nevoie de o vaccinare?
  • Este nevoie de o asigurare?
  • Este necesar un certificat de încercare?
  • ¿Se requiere un formular de înscriere? (sănătate sau altul)

Fiecare categorie poate avea una dintre următoarele valori:

  • Da
  • Da, cu excepții
  • Nu
  • Nu, cu excepții

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 types de valores "con excepciones"

Un requisito de entrada es esencialmente un registro que documenta un conjunto de normas impuestas por un agent contra uno o varios países o regiones. El actor podría ser un país, estado o incluso municipio en nuestra arquitectura de datos. În general, Sitata acoperă datele la nivel de țară în prezent. Sin embargo, tenemos algunos registros estatales/provinciales para regiones seleccionadas como los Estados Unidos y otros

Orice registru care are o intrare sub câmp origin_country_division_id o origin_country_region_id es uno que es de nivel estatal o municipal, respectivamente. Dacă doriți să dispuneți de mai multe date generale, vă rugăm să contactați cu noi y podemos hablar de su caso de uso.

Por favor, tómese un tiempo para familiarizarse con la estructura de datos de los requisitos de entrada echando un vistazo a documentele noastre de API aici.

Una parte un poco confusa sobre la estructura de los datos es nuestro uso del término"origine" 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 creato la restricción.

Un alt punct important de reținut este modul în care funcționează lista noastră de țări afectate. Dacă affected_countries este gol, ar trebui interpretat ca o regulă globală, adică toate țările sunt afectate.

Câteva exemple

Como habrán visto en la documentación, hay varias formas de recuperar datos de la API. În continuare vom vedea câteva dintre cazurile de utilizare cele mai comune.

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

Hay un par de maneras de hacer este tipo de petición. Versiunea cea mai simplă este utilizarea destin y ieșire parametri. Acești parametri acceptă codurile ISO 3166-1 alfa-2 ca intrări

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

Răspunsul va include toate cerințele (la nivel de țară și de stat) necesare pentru înțelegerea călătorului care pleacă din țara de plecare și călătorește către țara de destinație.

¿Y si quiero datos a nivel estatal?

Sitata tiene datos a nivel estatal para ciertas regiones. Puteți ști că o intrare specială este pentru un stat dacă 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 un valor ISO_3166-2. De exemplu, US-TX pentru Texas, Estados Unidos.

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

Obsérvese que podría ser más 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?

La fel ca în cazul țărilor, API-ul Sitata poate genera rezultate între două aeroporturi. Parametrii aeroport de ieșire y aeroport de destinație utilizarea codurilor de la OACI o de la IATA para filtrar los 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 las restricciones (a nivel de país y de estado) necesarias 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 da lugar a conflictos y confusión. În acest caz, am ales să acomodăm consultarea API-ului nostru prin coordonate de latitudine și longitudine, ceea ce nu produce nicio ambiguitate în ansamblul nostru de rezultate. Parametrii sunt plecare_lat, plecare_lng, destinație_lat...y.. destinație_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 resolve sus ciudades a las ubicaciones y consulta basada en las coordenadas, nuestra API responderá con todas las restricciones (a nivel de país y de estado) necesarias para comprender para el viajero que sale del país de salida y viaja al país de destino.

Date suplimentare

Para algunos tipos de requisitos de entrada, puede haber datos adicionales asociados en un campo de tipo de metadatos llamado plusuri. Acest câmp este o cartografie cheie/valoare a câtorva biți suplimentari de informații pentru o cerință specială

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

Această intrare de date este supusă cerinței de intrare tip 5. În această intrare, el plusuri el mapeo contendrá un campo llamado zile_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?

Această intrare de date este supusă cerinței de intrare tip 8. În această intrare, el plusuri el mapeo contendrá un campo llamado entry_hours que contendrá un número entero para el número de horas que se permite una prueba covid negativa antes de la entrada.

Trebuie să știm

Creemos que tenemos una muy robusta que probabil satisfaga todas sus necesidades para ayudar a sus viajeros a entender lo que es probabil que encuentren en el camino. Si usted tiene un caso de uso particular que no estamos abordando, por favor háganoslo saber!

Espera... ¡hay más!

Această intrare face parte dintr-o serie de două părți care explică cum să interacționați cu API-ul Sitata pentru cerințele de intrare și informațiile privind restricțiile de călătorie. 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. Una cosa es saber acerca de entrar a un país, y otra es entender si es posible moverse por el país o visitar las playas o si hay un toque de queda obligatorio.

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 documentație de la API mientras tanto.

Asigurare de călătorie și asistență care vă ajută să aveți o călătorie mai bună

Vedeți de ce mii de călători aleg Sitata atunci când călătoresc

Copyright © 2025 Sitata Inc.