
Många av er vet kanske inte, men de första stiftelserna i Sitata har byggts upp för att förebygga sjukdomar. Vår fondatrice organiserade faktiskt en TedX-föreläsning från 2016 om skäl för vilka vi bör avråda resenärerna från att resa för att förhindra spridning av sjukdomar. Det är därför inte förvånande att vi har lärt oss att COVID-19 existerar, vilket signalerades som en inhemsk grupp av fall av lunginflammation i början av december 2019. Den 2 januari 2020 beslutade vår hälsoavdelning att vi skulle skicka ut en första varningen till våra resenärer och kommersiella partners. C'était quelques jours avant même l'Organisation mondiale de la santé !
Under de oundvikliga retombéerna har vi fått en uppenbarelse. Sjukdomen spred sig så snabbt att det stod klart för oss att det globala svaret skulle bli kaotiskt. Varje land skulle promulgera sina egna bestämmelser och regler för att kontrollera spridningen. Detta skulle oundvikligen göra des ravages i hela världen och vara en enorm källa till förvirring för dem som ännu ville resa. Nous avions raison et nous avons décidé de faire quelque chose pour y remédier. Sitata var ett av de första företagen i världen som skapade ett dedikerat API och en tjänst för uppföljning av ändringar i reserestriktioner och inresevillkor till följd av COVID-19. Tack vare ett avancerat system för upptäckt av händelser och ett team av specialiserade analytiker har vi redan alla verktyg och processer som krävs för att komma fram.
Sedan lanseringen av denna nya tjänst har flera organisationer dragit nytta av uppgifterna till förmån för sina egna kunder, bland annat Eddy Travels, Flight Centre och Etihad Airways ; d'autres informations seront bientôt annoncées ! För att hjälpa ett större antal organisationer som är inriktade på resor att dra nytta av detta erbjudande har vi i detalj nedan skrivit ett visst antal exempel för att förklara hur man använder API för olika användningsfall. J'espère que ces explications vous aideront à faire démarrer vos propres initiatives.
De första frågorna som en resenär ställer är utan tvekan: "Kan jag åka dit?" och "Serai-je mis en quarantaine", det är alltså en bra startpunkt. Vi har skapat en samling uppgifter om inresevillkor för att kunna svara på svåra frågor av typen "ja/nej" om inresa i ett land eller en region.
Vid tidpunkten för upprättandet av föreliggande dokument omfattade denna ensemble av uppgifter följande tio olika kategorier
Varje kategori kan ha en av de följande värdena :
Om den stora majoriteten av värdena är "ja" och "nej", är situationen på marken inte alltid lika enkel. Ibland finns det verkligen bisarra regler som olika regeringar har infört och som kräver olika typer av värden "med undantag"
Ett inträdesvillkor är i huvudsak ett dokument som dokumenterar en helhet av regler som ålagts av en aktör i förhållande till ett eller flera andra länder eller regioner. Aktören kan vara ett land, en stat eller till och med en kommun i vår dataarkitektur. I sin helhet täcker Sitata för närvarande uppgifter på landsnivå. Toutefois, nous disposons de quelques enregistrements d'états/provinces pour certaines régions, comme les États-Unis et d'autres
All registrering som innehåller en entré under champen ursprung_löner_division_id
eller ursprung_betalar_region_id
est un niveau qui se situe respectivement au niveau de l'État ou au niveau municipal. Om du vill ha tillgång till mer omfattande uppgifter, vänligen vi kontaktar och vi kommer att diskutera ditt användningsfall.
Ta dig tid att bekanta dig med strukturen på uppgifterna om villkoren för tillträde till en konsult våra dokument API här.
En del av strukturen i uppgifterna är något avvikande, till exempel vår användning av begreppet"ursprung" Denna förvirring beror på att utvecklarna ofta anser att ursprunget är både ursprungsort och avgångsort. Eller, det som vi förstår med "ursprung" är i själva verket ursprunget till den regel som införts för andra, det vill säga det land eller den region som har skapat begränsningen.
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 kunnat konstatera i dokumentationen finns det flera sätt att återvinna uppgifterna från API. Vi kommer här att gå igenom några av de vanligaste användningsfallen.
Det finns flera sätt att göra denna typ av begäran. Den enklaste versionen är att använda destination
et start
parametrar. Dessa parametrar accepterar koderna ISO 3166-1 alfa-2 som ingångar
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 dispose de données au niveau de l'État pour certaines régions. Vous saurez qu'une entrée particulière est pour un État si le ursprung_betalar_avdelning
a en värde. Du kan också filtrera för att inte återfå mer data än vad som finns på statusnivån när du använder champ destination_betalar_indelning
paramètre. Det ger ett värde ISO_3166-2. Till exempel 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 kan 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.
Precis som för länderna kan API Sitata återföra resultaten mellan två flygplatser. Parametrarna avgång_aéroport
et destination_aéroport
använda koderna för l'OACI ou de l'IATA för att filtrera resultaten. La réponse comprendra toutes les restrictions (au niveau du pays et de l'État) nécessaires à la compréhension du voyageur partant du pays de départ correspondant et se rendant dans le pays de destination.
GET https://www.sitata.com/api/v2/entry_requirements?departure_airport=MUC&destination_airport=BOM
La réponse comprendra toutes les restrictions (au niveau du pays et de l'État) nécessaires à comprendre pour le voyageur qui part du pays de départ et se rend dans le pays de destination.
Sitata har valt att inte svara på förfrågningar som gäller ett särskilt stadsnamn, eftersom det kan leda till konflikter och förvirring. I stället för detta har vi valt att acceptera kraven från vårt API genom koordinater för latitud och longitud, vilket inte ger någon tvetydighet i vår ensemble av resultat. Parametrarna är följande avgång_lat
, avgång_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
Si vous résolvez vos villes en fonction des lieux et des requêtes en fonction des coordonnées, notre API répondra avec toutes les restrictions (au niveau du pays et de l'État) nécessaires à la compréhension du voyageur qui part du pays de départ et se rend dans le pays de destination.
För vissa typer av ingångsvillkor kan det finnas ytterligare uppgifter som är associerade med en typ av metadon som kallas statister
. Detta fält är en nyckel/värdesbild av olika extra informationselement för ett särskilt behov
Denna insamling av uppgifter är underkastad skyldigheten till insamling typ 5. I denna ingång, le statister
kartografin innehåller en champ som kallas karantän_dagar
som innehåller ett helt antal för antalet dagar av kvantaine imposés.
Denna insamling av uppgifter är underkastad skyldigheten till insamling typ 8. I denna ingång, le statister
kartografin innehåller en champ som kallas inmatning_timmar
qui contiendra un nombre entier pour le nombre d'heures pendant lesquelles un test covid négatif est autorisé avant l'entrée.
Vi anser att vi har ett mycket robust verktyg som förmodligen uppfyller alla dina behov för att hjälpa dina resenärer att förstå vad de kan tänkas möta under resan. Om du har ett särskilt användningsfall som vi inte behandlar, gör så här med oss kunskap!
Denna artikel ingår i en serie av två artiklar som förklarar hur man använder API Sitata för att få information om inresevillkor och reserestriktioner. Hittills har vi talat om inresevillkor som beskriver de typer av strikta villkor av typen oui/non nécessaires för att komma in i ett land eller en region, men vi har inte heller talat om vad som händer innanför landets gränser. C'est une chose de savoir comment entrer dans un pays, c'en est une autre de comprendre s'il est possible de se déplacer dans le pays ou de visiter les plages ou s'il y a un couvre-feu obligatoire.
Fortsätt läsa den andra artikeln som beskriver vår informationsserie om resebegränsningar. Astuce : det är nästan identiskt, du kan också alltid konsultera vår Dokumentation om API en ledsagare.