Hur man använder Sitatas API för att fastställa begränsningar för resandeförbindelser för resenärer

Skrivet av Madeline Sharpe

22 december 2020

Teknik

Många av er vet inte riktigt, men de första stationerna i Sitata byggdes för att upptäcka tidiga sjukdomar. Därför har vår grundare en TedX-utmärkelse från 2016 om 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. Den 2 december 2020 fastställde vår hälsoutrustning att vi måste sända ut följande 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 nedkylningen fick vi en epifanía. Sjukdomen utvidgades så snabbt att det var uppenbart att det globala svaret skulle vara kritiskt i de flesta fall. Varje land införde sina egna regler och bestämmelser för att kontrollera spridningen. Detta skulle oundvikligen leda till att det skulle uppstå problem i de globala resorna och skapa stor förvirring bland dem som fortfarande vill 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 dedicerat API och en övervakningstjänst för ändringarna av resebegränsningarna och inresekraven som ett resultat av COVID-19. Med ett avancerat programvarusystem för upptäckt av händelser och en särskild analytikerutrustning hade vi alla de verktyg och processer som krävdes för att genomföra detta.

Sedan lanseringen av denna nya tjänst har vi haft en mängd olika organisationer som använder uppgifterna till förmån för sina egna kunder, bland annat Eddy Travels, Flight Centre och Etihad Airways; och det finns fler som vi kommer att meddela snarast! För att hjälpa till att fler organisationer som är inriktade på resor ska kunna dra nytta av detta erbjudande har vi i detalj skrivit en serie exempel för att förklara hur man kan använda API:et i en mängd olika användningsområden. Espero que estas explicaciones le ayuden a poner en marcha sus propias iniciativas.

Förutsättningar för inträde

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.

Vid tidpunkten för redigeringen av denna rapport omfattar denna sammanställning av uppgifter tio olika kategorier:

  • ¿Puede un residente entrar en el país?
  • ¿Puede un extranjero entrar in 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)? ¿Ska det krävas en vaccination?
  • ¿Se requiere un seguro?
  • ¿Se requiere un certificado de prueba?
  • ¿Se requiere un formulario de inscripción? (hälsa eller annat)

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

  • Sí, med undantag
  • Ingen
  • Nej, med undantag

Även om de flesta av värdena är "sí" och "nej", är situationen på marken inte alltid lika enkel. Ibland finns det regler som är mycket extra och lokala som olika regeringar har infört och som kräver att dessa typer av värden ska vara "med undantag".

Ett inreseförbud är framför allt ett register som dokumenterar ett antal normer som en agent har infört för ett eller flera länder eller regioner. Aktören kan vara ett land, en stat eller även en kommun i vår datasamling. I allmänhet omfattar Sitata data 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 fältet origin_country_division_id o origin_country_region_id es uno que es de nivel estatal o municipal, respectivamente. Om du vill ha tillgång till mer information, vänligen kontakta oss. med oss y podemos hablar de su caso de uso.

Om du vill, ta lite tid på dig för att bekanta dig med datastrukturen för de obligatoriska kraven för att komma in på webbplatsen genom att titta på våra dokument om API:n här.

En del som är lite förvirrad när det gäller strukturen av data är vår användning av begreppet"ursprung" 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 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 drabbade länder fungerar. Om affected_countries är tomt ska det tolkas som en global regel, dvs. alla länder påverkas.

Några exempel

Som du har sett i dokumentationen finns det olika sätt att hämta data från API:et. I fortsättningen ser vi några av de vanligaste användningsfallen.

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

Det finns många olika sätt att göra denna typ av ansökan. Den enklaste varianten är att använda destino y salida parametrar. Dessa parametrar accepterar koder. ISO 3166-1 alfa-2 como entradas

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

Svaret kommer att innehålla alla krav (på lands- och statsnivå) som är nödvändiga för att förstå resenären som avreser från avreselandet och reser till destinationslandet.

¿Y si quiero datos a nivel estatal?

Sitata har uppgifter på nationell nivå för vissa regioner. Du vet att en särskild ingång är för en stat om división_país_original el campo tiene un valor. Du kan även filtrera för att endast hämta data om nivå av tillstånd med hjälp av División_país_destino parameter. Ange ett värde ISO_3166-2. Exempelvis US-TX för Texas, Estados Unidos.

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

Det kan vara enklare att göra en sökning per land och sedan filtrera statistiska uppgifter för att se om det finns sådana uppgifter och använda dem om de finns.

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

Precis som i fråga om länder kan Sitatas API överföra resultat mellan två flygplanstjänster. Parametrar Flygplats Salida y Flygplats för destinationen använda de koder som finns i la OACI o de la la IATA för att filtrera resultaten. 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 dar lugar a conflictos y confusión. I stället valde vi att låta konsultationen i vårt API ske med hjälp av latitud- och longitudkoordinater, vilket inte ger några oklarheter i resultatet. Parametrarna är följande 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

Om du väljer dina städer utifrån de olika platserna och rådfrågar dem utifrån deras positioner, svarar vårt API på alla de begränsningar (land- och statsnivå) som behövs för att förstå för den resenär som säljer från sitt hemland och reser till sitt destinationsland.

Ytterligare uppgifter

För vissa typer av inskrivningsrekvisit kan det finnas ytterligare uppgifter som är associerade med en kategori av metadata som kallas Campo de tipo de metadatos. extras. Detta fält är en kartografisk beskrivning av olika delar av informationen för en särskild begäran.

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

Denna datainsamling är föremål för ett krav på insamling. tipo 5. I detta avsnitt, den extras kartan innehåller ett läger med namnet Campo 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?

Denna datainsamling är föremål för ett krav på insamling. tipo 8. I detta avsnitt, den extras kartan innehåller ett läger med namnet Campo 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.

Vi ska veta

Vi tror att vi har en mycket robust version som sannolikt uppfyller alla behov för att hjälpa resenärer att förstå vad de kan tänkas hitta på vägen. Om du har ett särskilt användningsområde som vi inte har tagit hänsyn till, por favor háganoslo saber!

Espera... ¡hay más!

Denna sida är en del av en serie med två delar som förklarar hur du kan interagera med Sitatas API för att få information om inresekrav och restriktioner för resor. Vi har hittills talat om de krav som krävs för att komma in i ett land eller en region, men vi har inte heller talat om vad som händer i landet. 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.

Håll dig uppdaterad för att se om det andra inlägget som kommer att publiceras i vårt datasammanhang för Restricción de Viaje. Pista - es casi idéntico, así que siempre puedes echar un vistazo a nuestra dokumentation de la API mientras tanto.

Följ och gilla oss:

Relaterade artiklar

En förhandstitt på de olympiska spelen i Paris 2024

En förhandstitt på de olympiska spelen i Paris 2024

Spelen i XXXIII olympiaden, även kända som de olympiska och paralympiska sommarspelen 2024, är planerade att äga rum i Paris, Frankrike, från 26 juli till 11 augusti och 28 augusti till 8 september, samtidigt. Turneringarna kommer att sträcka sig över ikoniska landmärken i Paris...

De bästa säkerhetsapparna för resenärer, kvinnor eller barn

De bästa säkerhetsapparna för resenärer, kvinnor eller barn

Att förebygga är bättre än att bota. Oavsett om något går fel är förberedelser en livlina. Att ge sig ut och utforska världen ensam kan vara skrämmande men oundvikligt. Oavsett om det handlar om att ta med ditt barn på en lekdejt, en campingtur eller om du själv ska ge dig ut på en...