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