Miten Sitatan API:ta voidaan käyttää matkustusrajoitusten määrittämiseen matkustavien osalta

Kirjoittanut Madeline Sharpe

joulukuu 22, 2020

Tecnología

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 advertir 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 emitire nuestra primera advertencia a nuestros viajeros y socios comerciales. ¡Esto fue días antes incluso de la Organización Mundial de la Salud!

Välttämättömän radioaktiivisen sateen aikana saimme yhden epifanian. Tauti laajeni niin nopeasti, että oli selvää, että kokonaisvaltainen vaste oli kaoottinen useimmissa tapauksissa. Kukin maa antoi omat säädös- ja valvontasääntönsä leviämisen valvomiseksi. Tämä aiheuttaisi väistämättä estragioita maailmanmatkoilla ja olisi valtava hämmennyksen aiheuttaja niille, jotka haluaisivat matkustaa. Meillä oli järkeä ja ehdotimme, että tekisimme jotain tämän suhteen. Sitata oli yksi maailman ensimmäisistä yrityksistä, joka loi COVID-19:n seurauksena oman API:n ja valvontapalvelun matkustusrajoitusten ja maahantulovaatimusten muutoksille. Meillä oli kehittynyt ohjelmistosysteemi tapahtumien havaitsemista varten ja oma analyytikkoryhmä, joten meillä oli kaikki tarvittavat välineet ja menettelyt tämän toteuttamiseksi.

Tämän uuden palvelun lanseerauksen jälkeen meillä on ollut monia eri organisaatioita, jotka käyttävät tietoja omien asiakkaidensa hyväksi, kuten Eddy Travels, Flight Centre ja Etihad Airways, ja on muitakin, jotka ilmoittavat siitä pian! Con el fin de ayudar a que más organizaciones centradas en los viajes se benefien de esta oferta, hemos escrito en detalle a continuación una serie de ejemplos para ayudar a explicar caro how utilizar la API for una variedad de cases de uso. Toivomme, että nämä selitykset auttavat sinua käynnistämään omia aloitteitasi.

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 respondder a los duros "sí/no" de las preguntas relativas a la entrada en un country or región.

Tämän tiedonannon laatimishetkellä tämä tietokokonaisuus sisälsi seuraavat 10 eri luokkaa:

  • ¿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?
  • ¿Se requiere una prueba a la llegada (brote de la enfermedad)?
  • ¿Se permite un 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?
  • ¿Se requiere un certificado de prueba?
  • ¿Se requiere un formulario de inscripción? (salud u otro)

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

  • Sí, con excepciones
  • Ei
  • No, con excepciones

Vaikka suurin osa arvoista on "kyllä" ja "ei", tilanne maan päällä ei ole aina niin yksinkertainen. A veces hay reglas realmente extrañas y locas que varios gobiernos han puesto en marcha que require los tipos de valores "con excepciones".

Un requisito de entrada esencialmente un registro que dokumenta un conjunto de normas impuestas por un agente 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. Yleisesti ottaen Sitata kuvaa tiedot maittain ja ajantasaisesti. Sin embargo, tenemos algunos registros estatales/provinciales para regiones seleccionadas como los Estados Unidos y otros.

Cualquier registro que tenga una entrada bajo el campo alkuperä_maa_division_id o origin_country_region_id es uno que es de nivel estatal o municipal, respectivamente. Jos haluatte saada lisää tietoa, ottakaa yhteyttä osoitteeseen con nosotros 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 API:n asiakirjat aquí.

Una parte un poco confusa sobre la estructura de los datos es nuestro uso del término"origen" 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 country o la región que ha creado la restricción.

Toinen tärkeä seikka on se, miten luettelo maista, joihin vaikutukset kohdistuvat, toimii. Jos affected_countries on tyhjä, se on tulkittava globaaliksi säännökseksi, eli kaikki maat vaikuttavat.

Algunos ejemplos

Como habrán 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.

¿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

Vastaus sisältää kaikki vaatimukset (maa- ja osavaltiotaso), jotka on ymmärrettävä lähtömaasta lähtevän ja kohdemaahan matkustavan matkustajan osalta.

¿Y si quiero datos a nivel estatal?

Sitata tiene datos a nivel estatal para ciertas regiones. Tiedät, että jokin tietyntyyppinen alue on tietyn osavaltion alue, jos se on 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. Por ejemplo, US-TX para Texas, Estados Unidos.

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

Huomatkaa, että olisi helpompaa tehdä maakohtainen haku ja suodattaa sen jälkeen osavaltioiden tiedot, jotta voidaan tarkistaa, onko näitä tietoja olemassa, ja käyttää niitä, jos niitä on olemassa.

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

Samoin kuin muiden maiden kohdalla, Sitatan API voi välittää tuloksia kahden lentoyhtiön välillä. Parametrit aeropuerto de salida y aeropuerto de destino käyttää seuraavia koodeja la OACI o de la IATA para filterrar los results. 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 destination.

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

La respuesta incluirá allas 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 country de destination.

¿Y jos minulla on vain tietoa kaupungista?

Sitata päätti, ettei kuulemisia saa tehdä erityisesti kaupunkinimellä, koska se voisi aiheuttaa ristiriitoja ja hämmennystä. En su lugar, elegimos acomodar la consulta a nuestra API por coordenadas de latitud y longitud, lo que no produce ninguna ambigüedad en nuestro conjunto de results. 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

Jos resuelve 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 destination.

Lisätiedot

Para algunos tipos de requisitos de entrada, puede haber datos adicionales asociados en un campo de tipo de metadatos llamado lisävarusteet. Este campo es una cartografía clave/valor de varios bits extra de información para un requerimiento particular.

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

Tämä tietojen syöttö on sallittu tietojen syöttämistä koskevan vaatimuksen mukaisesti. tipo 5. En esta entrada, el lisävarusteet kartalla on yksi leiri nimeltä Campo llamado días_de_cuarentena que contendrá un número entero para el número de diages de cuarentena impuestos.

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

Tämä tietojen syöttö on sallittu tietojen syöttämistä koskevan vaatimuksen mukaisesti. tipo 8. En esta entrada, el lisävarusteet kartalla on yksi leiri nimeltä Campo llamado entry_hours que contendrá un número entero para el número de horas que se permites una prueba covid negativa antes de la entrada.

Háganos saber

Creemos que tenemos una muy robusta que probablemente satisfaga todas sus necesidades para ayudar a sus viajeros a entender lo que es probable 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!

Esta entrada forma parte de una serie de dos partes que explica cómo interactuar con la API de Sitata para los requisitos de entrada y la información sobre restricciones 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. 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 documentación de la API mientras tanto.

Seuraa ja tykkää meistä:

Aiheeseen liittyvät artikkelit

Nine Most Common Scams in Paris and Tips to Avoid  Them

Nine Most Common Scams in Paris and Tips to Avoid Them

Paris attracts millions of tourists each year, thanks to its romantic ambiance, magnificent landmarks, and rich history. Unfortunately, like many other tourist spots, the city’s popularity also makes it a hub for various scams that target innocent visitors. These...

Hop on the RER: Explore Paris Like a Pro with This Easy Guide

Hop on the RER: Explore Paris Like a Pro with This Easy Guide

Parisians rely on the RER train network to navigate the city and its suburbs. Mastering the RER unlocks a more authentic travel experience, especially during events like the Olympics. Let's navigate the RER like Parisians! The Paris RER or Réseau Express Régional is a...