Hoe gebruik je de API van Sitata om de beperkingen voor reizigers te bepalen?

10 september 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 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. Op 2 de enero de 2020 bepaalde ons gezondheidsteam dat we het volgende moesten uitvaardigen nuestra primera advertencia a nuestros viajeros y socios comerciales. ¡Esto fue días antes incluso de la Organización Mundial de la Salud!

Tijdens de onvermijdelijke lluvia radioactiva hadden we een epifanía. La enfermedad se estaba extiendo tan rápido que teníamos claro que la respuesta global sería caótica en el mejor de los casos. Elk land vaardigde zijn eigen reeks regels uit om de verspreiding te beheersen. Dit veroorzaakte onvermijdelijk estragos bij de viajes over de hele wereld en zou een enorme bron van verwarring zijn voor degenen die nog steeds op reis willen. Teníamos razón y nos propusimos hacer algo al respecto. Sitata was een van de eerste bedrijven ter wereld die een speciale API en een supervisiedienst creëerde voor de wijzigingen in de beperkingen van de toegang en de vereisten voor binnenkomst als gevolg van de COVID-19. Het bedrijf heeft een geavanceerd systeem ontwikkeld voor het beheer van de toegang tot de luchthavens. Met een geavanceerd softwaresysteem voor het opsporen van gebeurtenissen en een speciaal analistenpanel beschikten we over de juiste hulpmiddelen en processen om dit te doen.

Sinds de lancering van deze nieuwe service hebben we verschillende organisaties die de gegevens gebruiken ten gunste van hun eigen klanten, waaronder Eddy Travels, Flight Centre en Etihad Airways; en er zijn er nog meer die binnenkort worden aangekondigd! Om ervoor te zorgen dat meer organisaties die zich richten op viajes kunnen profiteren van dit aanbod, hebben we in het vervolg een aantal voorbeelden uitgebreid beschreven om duidelijk te maken hoe je de API kunt gebruiken in verschillende situaties. Ik hoop dat deze uitleg u helpt om uw eigen initiatieven in gang te zetten.

Toegangseisen

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.

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

  • Kan een ingezetene het land binnenkomen?
  • ¿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? (gezondheid of andere)

Elke categorie kan een van de volgende waarden hebben:

  • Sí, met uitzonderingen
  • Geen
  • Nee, met uitzondering van

Aunque la gran mayoría de los valores son "sí" y "no", la situación sobre el terreno no siempre es tan sencilla. Soms zijn er echt extrañas y locas reglas que varios gobiernos han puesto en marcha que requieren los tipos de valores "con excepciones".

Un requisito de entrada esencialmente un registro que documenta un conjunto de normas impuestas por un agente contra uno o varios países o regiones. De actor kan een land, staat of zelfs gemeente zijn in de architectuur van de gegevens. In het algemeen bevat Sitata de gegevens op het niveau van het land en op dit moment. Sin embargo, tenemos algunos registros estatales/provinciales para regiones seleccionadas como los Estados Unidos y otros

Alle registraties die een ingang hebben onder de campo oorsprong_land_afdeling_id o oorsprong_land_regio_id es uno que es de nivel estatal o municipal, respectivamente. Als u over meer gegevens wilt beschikken, neem dan alstublieft contact op met met ons y podemos hablar de su caso de uso.

Neem even de tijd om vertrouwd te raken met de structuur van de gegevens over de vereisten voor toegang door een kijkje te nemen op onze API-documenten hier.

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

Een ander belangrijk punt om op te merken is hoe onze lijst met betrokken landen werkt. Als affected_countries leeg is, moet het worden geïnterpreteerd als een globale regel. Dat wil zeggen dat alle landen worden beïnvloed.

Enkele voorbeelden

Zoals je in de documentatie hebt kunnen lezen, zijn er verschillende manieren om gegevens van de API terug te halen. In het vervolg zullen we enkele van de meest voorkomende gebruiksgevallen bespreken.

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

Er zijn verschillende manieren om een verzoekschrift in te dienen. De eenvoudigste manier is om de destino y salida parameters. Deze parameters accepteren de volgende codes ISO 3166-1 alfa-2 como entradas

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

Het antwoord zal alle vereisten (op land- en staatsniveau) bevatten die nodig zijn om de reiziger die vertrekt uit het land van vertrek en naar het land van bestemming reist, te begrijpen.

¿Y si quiero datos a nivel estatal?

Sitata heeft gegevens op nationaal niveau voor bepaalde regio's. Usted sabrá que una entrada es particular para un estado si el oorspronkelijke afdeling el campo tiene un valor. Je kunt ook filteren om alleen de gegevens over het staatsniveau op te halen met behulp van de optie afdeling_país_destino parámetro. Kies een waarde ISO_3166-2. Bijvoorbeeld US-TX voor Texas, Verenigde Staten.

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 verifir si esos datos existentes y utilizarlos si existentes.

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

Net als in het geval van andere landen kan de API van Sitata resultaten tussen twee luchthavens verspreiden. De parameters vliegveld van salida y luchthaven van bestemming maak gebruik van de la OACI o de la IATA om de resultaten te filteren. 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 koos ervoor om geen gebruik te maken van raadplegingen op basis van een specifieke plaatsnaam, omdat dit tot conflicten en verwarring zou kunnen leiden. In plaats daarvan kozen we ervoor om de raadplegingen van onze API te laten plaatsvinden op basis van de breedte- en lengteklassen, wat geen dubbelzinnigheid oplevert in onze resultaten. De parameters zijn vertrek_lat, vertrek_lng, bestemming...y.. bestemming_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 ciudades a las ubicaciones y consulta basada en las coordenadas, nuestra API responderá condas 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.

Aanvullende gegevens

Voor sommige typen vereisten voor toelating kunnen aanvullende gegevens beschikbaar zijn in een campagne met de volgende naam extra's. 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?

Esta entrada de datos está sujeta al requisito de entrada tipo 5. En deze ingang, de extra's el mapeo contendrá un campo llamado dagen_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 datos está sujeta al requisito de entrada tipo 8. En deze ingang, de extra's el mapeo contendrá un campo llamado binnenkomst_uren que contendrá un número entero para el número de horas que se permite una prueba covid negativa antes de la entrada.

Weten

Wij zijn van mening dat we een zeer robuuste versie hebben die waarschijnlijk voldoet aan alle behoeften om onze reizigers te helpen begrijpen wat ze waarschijnlijk onderweg tegenkomen. 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.

Houd het in de gaten voor de tweede post die wordt toegevoegd aan onze samenvatting van de Restricción de Viaje. Pista - es casi idéntico, así que siempre puedes echar un vistazo a nuestra documentatie de la API mientras tanto.

Reisverzekering en hulp die je helpt een betere reis hebben

Zie waarom duizenden reizigers Sitata kiezen als ze op reis gaan

Copyright © 2025 Sitata Inc.