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

Geschreven door Madeline Sharpe

22 december 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. 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 radioactieve neerslag hadden we een epifanía. De ziekte breidde zich zo snel uit dat het duidelijk was dat de globale reactie in de meeste gevallen caótica was. Elk land vaardigde zijn eigen regelgeving uit om de verspreiding te beheersen. Dit veroorzaakte onvermijdelijk estragos bij de viajes mundiales en zou een enorme bron van verwarring zijn voor degenen die nog steeds op reis willen. Teníamos razón and nos propusimos hacer algo al respecto. Sitata was een van de eerste bedrijven in de wereld die een speciale API en een service voor toezicht op de veranderingen in de beperkingen van de reis en de vereisten voor toegang als gevolg van de COVID-19 creëerde. Met een geavanceerd softwaresysteem voor de detectie van gebeurtenissen en een speciaal analistenteam, beschikten wij over de geschikte hulpmiddelen en processen om dit te doen.

Sinds de lancering van deze nieuwe dienst hebben we verschillende organisaties die de gegevens gebruiken ten voordele 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 gebruik kunnen maken van dit aanbod, hebben we in het vervolg een reeks voorbeelden geschreven om uit te leggen hoe de API gebruikt kan worden in verschillende situaties. Ik hoop dat deze uitleg u helpt bij het opstarten van uw eigen initiatieven.

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.

Op het moment dat deze informatie werd opgesteld, bevatte deze reeks gegevens de volgende 10 verschillende categorieën:

  • ¿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? (gezondheid of andere)

Elke categorie kan een van de volgende waarden hebben:

  • Sí, con excepciones
  • 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 de 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 gemeente zijn in de architectuur van de gegevens. In het algemeen bevat Sitata de gegevens op het niveau van het huidige land. Sin embargo, tenemos algunos registros estatales/provinciales para regiones seleccionadas como los Estados Unidos y otros

Elk register dat een ingang heeft in de buurt van het kamp... oorsprong_land_afdeling_id o herkomst_land_regio_id is er een die van nationaal of gemeentelijk niveau is. Als u over meer gegevens wilt beschikken, neem dan alstublieft contact op met met ons en kunnen we praten over het gebruik ervan.

Por favor, tómese un tiempo para familiarizarse con la estructura de datos de los requisitos de entrada echando un vistazo a onze documenten over de API hier.

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 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 dit worden geïnterpreteerd als een globale regel, d.w.z. dat alle landen worden beïnvloed.

Enkele voorbeelden

Zoals u in de documentatie hebt kunnen lezen, zijn er verschillende manieren om gegevens van de API terug te halen. Hier volgen enkele van de meest voorkomende gevallen.

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

Het antwoord zal alle vereisten (op land- en staatsniveau) omvatten die nodig zijn om de reiziger die uit het land van vertrek vertrekt 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 particular es para un estado si el división_país_original el campo tiene un valor. U kunt ook filteren om alleen de gegevens over het staatsniveau te verkrijgen door gebruik te maken van de optie división_país_destino parámetro. Espera un valor ISO_3166-2. Por ejemplo, US-TX voor 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 sercillo 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?

Al igual que en el caso de los países, la API de Sitata puede devolver resultados entre dos aeropuertos. De parameters aeropuerto de salida y vliegveld van bestemming gebruik te maken van de la OACI o de la IATA om de resultaten te filteren. Het antwoord omvat alle restricties (op het niveau van het land en de staat) die nodig zijn om de viajero die het land van vertrek verlaat en naar het land van bestemming reist, te kunnen vergelijken.

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

Het antwoord omvat alle beperkingen (op het niveau van het land en de staat) die nodig zijn om de viajero die het land verlaat en naar het land van bestemming reist, te helpen.

¿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 zou kunnen leiden tot conflicten en verwarring. In plaats daarvan hebben we ervoor gekozen de raadpleging van onze API te laten verlopen via de geografische coördinaten van lengte en breedte, wat geen dubbelzinnigheid oplevert in onze resultaten. De parameters zijn vertrek_lat, vertrek_lng, bestemming_lat...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

Als u uw steden op basis van de postcode en het land van bestemming raadpleegt, geeft onze API antwoord op alle beperkingen (op het niveau van het land en de staat) die nodig zijn om de viajero die het land verlaat en naar het land van bestemming reist, te informeren.

Aanvullende gegevens

Voor sommige types van toegangsvereisten kunnen aanvullende gegevens worden gebruikt in een kamp met verschillende types van metadata. 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 esta entrada, el extra's 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 datos está sujeta al requisito de entrada tipo 8. En esta entrada, el extra's el mapeo contendrá un campo llamado ingangsuren 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

Wij zijn van mening dat wij een zeer robuuste versie hebben die waarschijnlijk voldoet aan alle behoeften om onze reizigers te helpen begrijpen wat zij waarschijnlijk onderweg tegenkomen. Als u een bijzonder geval van gebruik heeft dat wij niet behandelen.., 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. Een ding is weten hoe je een land binnenkomt, en een ander ding is weten of het mogelijk is om door het land te reizen of de speeltuinen te bezoeken of dat er een verplichte visumplicht is.

Houd het in de gaten voor de tweede post die wordt toegevoegd aan onze gezamenlijke gegevens over 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.

Volg en like ons:

Verwante artikelen

From Metro to Marathon: Transportation Tips for The Paris Olympics

From Metro to Marathon: Transportation Tips for The Paris Olympics

Millions of people are expected to visit Paris for the 2024 Summer Olympic and Paralympic Games from 26 July to 11 August and 28 August to 8 September. Are you also gearing up to witness the games this year and looking for a perfect travel guide? Consider it done,...

Hoogpathogene aviaire influenza - H5N1

Hoogpathogene aviaire influenza - H5N1

Er is een stam van het influenzavirus genaamd H5N1 die zeer dodelijk is voor wilde vogels en kippen (kippen, eenden, enz.). Het heeft de afgelopen decennia grote uitbraken veroorzaakt bij kippen. In zeldzame gevallen heeft dit virus mensen besmet die...