
Många av er vet inte vad som hänt, men de första klinikerna på Sitata byggdes för att upptäcka sjukdomar i tid. Därför har vår grundare fått en TedX-utmärkelse från 2016 om varför vi måste informera resenärer för att hjälpa till att förhindra spridning av sjukdomen. Det är inte förvånande att vi började med COVID-19 när vi fick information om en ovanlig grupp fall av neumoni i början av december 2019. Den 2 januari 2020 bestämde vår hälsoutrustning att vi skulle släppa ut nuestra primera advertencia a nuestros viajeros y socios comerciales. ¡Esto fue días antes incluso de la Organización Mundial de la Salud!
Under den oundvikliga radioaktiva floden hade vi en epifanía. Sjukdomen spred sig så snabbt att vi förstod att det globala svaret skulle bli mycket kortsiktigt i de flesta fall. Varje land införde sina egna regleringar och bestämmelser för att kontrollera spridningen. Detta skulle oundvikligen leda till störningar i de globala resorna och vara en enorm källa till förvirring för dem som ännu inte ville resa. Teníamos razón y nos propusimos hacer algo al respecto. Sitata var ett av de första företagen i världen som skapade ett dedikerat API och en övervakningstjänst för ändringar i resebegränsningar och inresekrav som ett resultat av COVID-19. Med ett avancerat mjukvarusystem för att upptäcka händelser och en dedikerad analysteam hade vi redan alla verktyg och processer som behövdes för att göra det.
Sedan lanseringen av denna nya tjänst har vi haft en mängd olika organisationer som använder datauppgifterna till förmån för sina egna kunder, bland annat Eddy Travels, Flight Centre och Etihad Airways; ¡y hay más que se anunciarán pronto! För att fler organisationer som är inriktade på resor ska kunna dra nytta av erbjudandet har vi skrivit en rad exempel i detalj för att förklara hur API:et kan användas i olika användningsfall. Hoppas att dessa förklaringar hjälper dig att sätta igång med dina egna initiativ.
De första frågorna som en resenär ställer är "Kan jag komma hit?" och "Är du på cuarentena?", och därför är det här ett bra ställe att börja på. 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.
Vid tidpunkten för utarbetandet av denna rapport omfattade detta uppgiftssammanhang de följande 10 olika kategorierna:
Varje kategori kan ha ett av de följande värdena:
Även om de flesta värderingar är "ja" och "nej", är situationen på jorden inte alltid så enkel. Ibland finns det regler som är riktigt extravaganta och lokala som olika regeringar har infört och som kräver olika typer av värden "med undantag"
Ett krav på inresa är framför allt ett register som dokumenterar ett antal normer som en aktör har infört mot ett eller flera länder eller regioner. Aktören kan vara ett land, en stat eller till och med en kommun i den nuvarande dataarkitekturen. I allmänhet innehåller Sitata uppgifter på landsnivå i dagsläget. Sin embargo, tenemos algunos registros estatales/provinciales para regiones seleccionadas como los Estados Unidos y otros
Alla register som har en ingång under kampanjen ursprung_land_division_id
o ursprung_land_region_id
es uno que es de nivel estatal o municipal, respectivamente. Om du vill ha mer detaljerad information, por favor, kontakta med nosotros och vi kan prata om ditt användningsfall.
Ta gärna lite tid på dig att bekanta dig med datastrukturen och de krav som ställs för att komma in i systemet genom att titta på våra dokument om API här.
En del som är lite förvirrande när det gäller datastrukturen är vår användning av termen"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.
En annan viktig punkt att notera är hur vår lista över påverkade länder fungerar. Om affected_countries är tomt ska det tolkas som en global regel, dvs. alla länder påverkas.
Som du har sett i dokumentationen finns det olika sätt att återskapa data från API:et. Här följer några av de vanligaste fallen av användning.
Det finns ett par olika sätt att göra denna typ av petición. Den enklaste versionen är att använda el destino
y salida
parámetros. Dessa parametrar accepterar följande koder ISO 3166-1 alfa-2 como entradas
GET https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination=IN
Svaret kommer att omfatta alla krav (på lands- och delstatsnivå) som är nödvändiga för att förstå för resenären som avreser från avgångslandet och reser till destinationslandet.
Sitata har data på nationell nivå för vissa regioner. Du vet att en särskild ingång är för en stat om den uppdelning_país_original
el campo tiene un valor. Du kan också filtrera för att bara återvinna data om nivå av tillstånd med hjälp av uppdelning_país_destino
parámetro. Ange ett värde ISO_3166-2. Som exempel kan nämnas US-TX för Texas, Förenta staterna.
GET https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination_country_division=IN-AP
Observera att det kan vara enklare att göra en konsultation per land och sedan filtrera bland uppgifterna från de olika staterna för att kontrollera om dessa uppgifter finns och använda dem om de finns.
På samma sätt som för länder kan API:et för Sitata leverera resultat mellan två flygplatser. Parametrar aeropuerto de salida
y aeropuerto de destino
Använda de koder som 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 comprehender para el viajero que sale del país de salida y viaja al país de destino.
Sitata valde att inte göra konsultationer för ett visst antal städer eftersom det skulle kunna leda till konflikter och förvirring. I stället valde vi att anpassa konsulteringen av vårt API efter latitud- och longitudkoordinater, vilket inte ger upphov till några oklarheter i vårt resultatkoncept. Följande parametrar används avgång_lat
, avgång_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
Om du flyttar dina städer till de platser där de ligger och konsulterar dem baserat på de platser där de ligger, kommer vårt API att svara med alla de begränsningar (på lands- och statsnivå) som krävs för att förstå för den resenär som säljer från ankomstlandet och reser till destinationslandet.
För vissa typer av inträdeskrav kan det finnas ytterligare uppgifter som är kopplade till ett metadatakampanjområde som kallas statister
. Detta fält är en tydlig kartografi/valör med olika bitar av extra information för ett särskilt krav
Denna datainmatning är underkastad kravet på inmatning tipo 5. I detta inlägg, el statister
kartan innehåller ett fält med namnet días_de_cuarentena
que contendrá un número entero para el número de días de cuarentena impuestos.
Denna datainmatning är underkastad kravet på inmatning tipo 8. I detta inlägg, el statister
kartan innehåller ett fält med namnet inmatning_timmar
que contendrá un número entero para el número de horas que se permite una prueba covid negativa antes de la entrada.
Vi tror att vi har en mycket robust lösning som troligen uppfyller alla dina behov för att hjälpa dina resenärer att förstå vad de troligen kommer att stöta på under resans gång. Om du har ett särskilt användningsfall som vi inte tar upp, por favor háganoslo saber!
Detta inlägg är en del av en serie i två delar som förklarar hur man interagerar med Sitatas API för inresekrav och information om resebegränsningar. Hittills har vi talat om de inresekrav som innehåller de mest omfattande sí/no-kraven som krävs för att resa in i ett land eller en region, men vi har inte talat om vad som händer inom landet. En sak är att veta hur man reser in i ett land, en annan är att veta om det är möjligt att resa runt i landet eller besöka lekplatserna eller om det finns en obligatorisk kvävning.
Håll ögonen öppna för det andra inlägget som kommer att publiceras i vårt dataregister för Restricción de Viaje. Pista - det är nästan identiskt, så du kan alltid ta en titt på vår dokumentation de la API mientras tanto.