sitata logotyp

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

10 september 2024
Resebegränsningar API

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.

Villkor för inträde

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

  • En invånare kan komma in i landet?
  • En utlänning kan komma in i landet?
  • Är transit tillåtet över hela landet?
  • Är ett test nödvändigt vid ankomst (uppkomst av en sjukdom)?
  • Un certificat de test est-il autorisé (apparition d'une maladie) ?
  • Är det nödvändigt med en kvantain vid ankomsten (uppkomst av en sjukdom)? Är en vaccination nödvändig?
  • Erforderlig försäkran?
  • Testcertifikat krävs ?
  • Formulär för registrering krävs ? (hälsa eller annat)

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

  • Ja
  • Ja, med vissa undantag
  • Icke
  • Non, sauf undantag

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.

Några exempel

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.

Hur får man fram kraven mellan två länder?

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.

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

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.

Hur kan jag få fram kraven mellan två flygplatser?

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.

Och om jag inte har någon information om staden?

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

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.

Ytterligare information

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

Quel est le nombre de jours de quarantaine ?

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.

Quel est le nombre d'heures avant l'entrée pour un test covid négatif ?

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.

Låt oss veta

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!

Vänta... det finns mer!

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.

Reseförsäkring och assistans som hjälper dig ha en bättre resa

Se varför tusentals resenärer väljer Sitata när de reser

Upphovsrätt © 2025 Sitata Inc.
We've detected you might be speaking a different language. Do you want to change to:
en_US English
en_US English
es_ES Español
fr_FR Français
it_IT Italiano
de_DE Deutsch
hu_HU Magyar
ro_RO Română
ar العربية
pl_PL Polski
pt_PT Português
nl_NL Nederlands
sv_SE Svenska
fi Suomi
nb_NO Norsk bokmål
da_DK Dansk
Close and do not switch language