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

Skrivet av Madeline Sharpe

22 december 2020

Teknik

Många av er vet kanske inte det, men de första grundningarna av Sitata har byggts upp för att förebygga sjukdomar. Faktum är att vår grundare har organiserat en TedX-diskussion från 2016 om Skäl för vilka vi måste undvika resenärer för att förhindra att sjukdomar sprids.. Det är därför inte förvånande att vi har fått veta att COVID-19 existerar, som i början av december 2019 har signalerats som en grupp av lungfall. Den 2 januari 2020 har vår hälsogrupp beslutat att vi ska skicka ut en första varning till våra resenärer och partners kommersiella. Det var några dagar före den världsomfattande hälsoorganisationen!

Vid de oförstörbara retombéerna fick vi en uppenbarelse. Sjukdomen spred sig så snabbt att det var uppenbart för oss att det globala svaret skulle bli mer kaotiskt. Varje land skulle införa sina egna bestämmelser och regler för att kontrollera spridningen. Detta skulle oundvikligen leda till förödelse i hela världen och vara en enorm källa till förvirring för dem som ville resa vidare. Vi hade rätt och vi har beslutat att göra något för att avlägsna oss. Sitata har varit ett av de första företagen i världen som skapat ett särskilt API och en tjänst för uppföljning av ändringar av resebegränsningar och inresevillkor till följd av COVID-19. Tack vare ett avancerat programvarusystem för upptäckt av händelser och ett specialiserat analytikerteam har vi redan alla verktyg och processer som krävs för att nå dit.

Sedan lanseringen av denna nya tjänst har flera organisationer utnyttjat uppgifterna till förmån för sina egna kunder, bland annat Eddy Travels, Flight Centre och Etihad Airways; andra uppgifter kommer snart att offentliggöras! För att hjälpa ett stort antal organisationer som är inriktade på resor att dra nytta av detta erbjudande har vi nedan sammanställt ett antal exempel för att förklara hur API:et kan användas i olika fall. Jag hoppas att dessa förklaringar kan hjälpa er att utveckla era egna initiativ.

Villkor för tillträde

De första frågorna som en resenär ställer är utan tvekan: "Puis-je y aller ?" och "Serai-je mis en quarantaine", c'est donc un bon point de départ. Vi har skapat en samling uppgifter om inresevillkor för att svara på svåra frågor av typen "ja/nej" om inresa i ett land eller en region.

Vid tidpunkten för redigeringen av detta dokument omfattade denna samling uppgifter följande tio olika kategorier:

  • Kan en bosatt person komma in i landet?
  • Kan en utlänning komma in i landet?
  • Är transiteringen tillåten i hela landet?
  • Krävs det ett test vid ankomsten (uppkomsten av en sjukdom)?
  • Är ett testcertifikat godkänt (uppkomst av en sjukdom)?
  • Är det nödvändigt med en kvartalsdispens vid ankomsten (uppkomsten av en sjukdom)? Är en vaccination nödvändig?
  • Är det nödvändigt att försäkra sig?
  • Testcertifikat krävs ?
  • Formulaire d'inscription krävs ? (hälsa eller annat)

Varje kategori kan ha en av följande värden :

  • Oui
  • Oui, med några undantag
  • Ej
  • Non, sauf undantag

Om en stor majoritet av värdena är "ja" och "nej" är situationen i terrängen inte alltid lika enkel. Ibland finns det mycket bisarra och följsamma regler som olika regeringar har infört och som kräver att man ska använda sig av olika typer av värden "med undantag".

Ett inresevillkor är huvudsakligen ett dokument som innehåller en uppsättning regler som en aktör har infört i ett eller flera andra länder eller regioner. Aktören kan vara ett land, en stat eller en kommun i vår dataarkitektur. Sitata täcker i sin helhet de aktuella uppgifterna på landsnivå. Vi har dock några registreringar av stater/provinser för vissa regioner, t.ex. Förenta staterna och andra.

Alla inspelningar som innehåller en inmatning under champen origine_pays_division_id ou origine_pays_région_id est un niveau qui se situe respectivement au niveau de l'État ou au niveau municipal. Om ni vill ha mer omfattande uppgifter, vänligen Vi kontaktar dig. och vi kommer att diskutera din användningssituation.

Vänligen ta dig tid att bekanta dig med strukturen på uppgifterna om villkoren för tillträde som konsult. våra dokument API ici.

En del av uppgifternas struktur är lätt oklar, till exempel vår användning av termen."ursprung" Denna förvirring beror på att utvecklarna ofta betraktar ursprunget som en ursprungsort eller en avreseort. Eller så är det som vi förstår med "ursprung" i själva verket ursprunget till den regel som införs för andra, dvs. det land eller den region som har skapat begränsningen.

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 kunnat konstatera i dokumentationen finns det flera sätt att hämta API-data. Vi kommer därför att gå igenom några av de vanligaste användningsfallen.

Hur kan man få fram de krav som gäller för två länder?

Det finns flera sätt att göra denna typ av begäran. Den enklaste varianten är att använda den destination et Avgång parametrar. Dessa parametrar accepterar följande koder ISO 3166-1 alfa-2 som entréer

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.

Et si je veux des données au niveau de l'État ?

Sitata har uppgifter på statlig nivå för vissa regioner. Om en särskild post är för en stat, måste ni försäkra er om att den är för en stat om origine_pays_division ett värde. Du kan också filtrera för att inte hämta mer data på statusnivå när du använder champen. destination_pays_division paramètre. Det är ett värde ISO_3166-2. Exempelvis US-TX för Texas, USA.

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

Observera att det skulle kunna vara enklare att göra en sökning per land och sedan filtrera uppgifterna per stat för att se om de finns och använda dem om de finns.

Hur kan jag få fram de krav som gäller för två flygplatser?

API Sitata kan, precis som för länderna, återge resultaten mellan två flygplatser. Parametrar départ_aéroport et destination_aéroport använda koderna i l'OACI eller i denIATA för att filtrera resultaten. Svaret omfattar alla de restriktioner (på lands- och statsnivå) som är nödvändiga för att förstå resenären som är på väg från det motsvarande avgångslandet och som befinner sig i destinationslandet.

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

Svaret omfattar alla de begränsningar (på lands- och statsnivå) som är nödvändiga att förstå för den resenär som lämnar avreselandet och reser till destinationslandet.

Et si je n'ai que des informations sur la ville ?

Sitata har valt att inte svara på ansökningar som rör ett särskilt stadsnamn, eftersom det skulle kunna leda till konflikter och förvirring. I stället för detta har vi valt att acceptera vår API:s förfrågningar genom koordinater för latitud och longitud, vilket inte ger några oklarheter i våra resultat. Parametrarna är de följande départ_lat, departure_lng, destination_latet 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 löser dina städer i enlighet med platserna och dina krav i enlighet med koordinaterna, svarar vårt API med alla de restriktioner (på lands- och statsnivå) som är nödvändiga för att förstå resenären som lämnar avreselandet och kommer till destinationslandet.

Ytterligare information

För vissa typer av inresevillkor kan det finnas ytterligare uppgifter som är kopplade till en kategori av typ av metadonnor som kallas extras. Detta fält är en kartläggning av olika informationselement som är extra för en särskild situation.

Vad är antalet dagar i kvartalet?

Denna datainsamling är underställd en skyldighet att bevara uppgifter. typ 5. I denna ingång, le extras Kartografin innehåller en mästare som heter Quarantaine_days som innehåller ett helt nummer för antalet dagar av de kvartalsvis utlagda dagarna.

Hur många timmar före intagningen för ett negativt covidtest?

Denna datainsamling är underställd en skyldighet att bevara uppgifter. typ 8. I denna ingång, le extras Kartografin innehåller en mästare som heter entry_hours som innehåller ett helt tal för antalet timmar under vilka ett negativt test av blodet är tillåtet före inträdet.

Låt oss veta

Vi tror att vi har ett mycket robust verktyg som förmodligen svarar mot alla dina behov för att hjälpa dina resenärer att förstå vad de kan tänkas möta under resan. Om ni har ett särskilt användningsfall som vi inte behandlar, gör det för oss. vet !

Vänta lite... det finns mer!

Denna ingång är en del av en serie av två parter som förklarar hur man kan samverka med API Sitata för att få information om inresevillkor och resebegränsningar. Fram till nu har vi talat om inresevillkor som beskriver de typer av strikta villkor av typen ja/icke nödvändiga för att komma in i ett land eller en region, men vi har inte heller talat om vad som händer inom landet. En sak är att veta hur man kommer in i ett land, en annan är att förstå om det är möjligt att flytta in i landet eller besöka stränderna eller om det finns en obligatorisk täckmantel.

Återvänd till vår andra artikel som behandlar vår serie med uppgifter om reseförbud. Astuce : det är nästan identiskt, ni kan därför alltid konsultera vår dokumentation om API en attendant.

Följ och gilla oss:

Relaterade artiklar

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

Högpatogen aviär influensa - H5N1

Högpatogen aviär influensa - H5N1

Det finns en stam av influensaviruset som kallas H5N1 som är mycket dödlig för vilda fåglar och tamhöns (kycklingar, ankor osv.). Den har orsakat stora utbrott i inhemska kycklingflockar under de senaste decennierna. Vid sällsynta tillfällen har detta virus infekterat människor som...

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