Hogyan használjuk a Sitata API-kat az utazási korlátozások meghatározásához utazók számára

Sokan közületek talán nem tudják, de a Sitata korai alapjait a betegségek korai felismerésére építették. Alapítónk még 2016-ban tartott egy TedX előadást arról, hogy miért kell figyelmeztetnünk az utazókat a betegségek terjedésének megelőzése érdekében. Nem meglepő tehát, hogy értesültek a COVID-19-ről, amelyet 2019 december elején szokatlan tüdőgyulladás-esetek csoportjaként jelentettek. 2020. január 2-án egészségügyi csapatunk úgy döntött, hogy első figyelmeztetést kell kiadnunk utazóink és üzleti partnereink számára. Ez még pár nappal a Világegészségügyi Szervezet előtt történt!

A várható következmények során felismerés ért minket. A betegség olyan gyorsan terjedt, hogy számunkra világossá vált: a globális válasz legjobb esetben is kaotikus lesz. Minden ország saját szabályozásokat és előírásokat fog bevezetni a terjedés megfékezésére. Ez elkerülhetetlenül káoszt okozott volna világszerte, és óriási zavart szült volna azok számára, akik mégis utazni szerettek volna. Igazunk volt, és úgy döntöttünk, teszünk valamit a probléma megoldására. A Sitata volt az első cégek egyike a világon, amely dedikált API-t és szolgáltatást hozott létre a COVID-19 utáni utazási korlátozások és belépési feltételek változásainak nyomon követésére. Egy fejlett szoftveres eseményfelismerő rendszer és egy szakértő elemzőkből álló csapat révén már minden szükséges eszközzel és folyamattal rendelkeztünk ennek megvalósításához.

Az új szolgáltatás indítása óta számos szervezet élvezte az adatok előnyeit saját ügyfeleik javára, köztük az Eddy Travels, a Flight Centre és az Etihad Airways; hamarosan további bejelentések következnek! Annak érdekében, hogy még több utazással foglalkozó szervezet számára tegyük elérhetővé ezt az ajánlatot, az alábbiakban részletesen bemutatunk néhány példát, amelyek elmagyarázzák, hogyan használható az API különböző felhasználási esetekhez. Reméljük, ezek a magyarázatok segítenek elindítani saját kezdeményezéseiteket.

Belépési feltételek

Az első kérdések, amelyek egy utazót biztosan foglalkoztatják: “Mehetek oda?” és “Karanténba kerülök?”, tehát ez jó kiindulópont. Létrehoztuk a belépési feltételek adatkészletét, hogy megválaszoljuk a “igen/nem” típusú nehéz kérdéseket egy országba vagy régióba való belépéssel kapcsolatban.

A jelen írás elkészültekor ez az adatkészlet a következő tíz különálló kategóriát tartalmazta:

• Beléphet-e az országba egy állampolgár?
• Beléphet-e az országba egy külföldi?
• Megengedett-e az átszállás az országon keresztül?
• Követelnek-e tesztet érkezéskor (betegség esetén)?
• Elfogadható-e tesztigazolás (betegség esetén)?
• Szükséges-e karantén érkezéskor (betegség esetén)?
• Szükséges-e oltás?
• Szükséges-e biztosítás?
• Szükséges-e tesztigazolás?
• Szükséges-e nyilatkozat (egészségügyi vagy egyéb)?

Minden kategória a következő értékek egyikét veheti fel:

• Igen
• Igen, kivételekkel
• Nem
• Nem, kivételekkel

Bár az értékek túlnyomó többsége “igen” és “nem”, a valós helyzet nem mindig ilyen egyszerű. Néha vannak igazán szokatlan és furcsa szabályok, amelyeket a különböző kormányok vezettek be, és amelyek a “kivételekkel” típusú értékeket igénylik.

Egy belépési feltétel alapvetően egy dokumentum, amely egy szereplő által egy vagy több másik ország vagy régió ellen előírt szabályok halmazát rögzíti. Az szereplő lehet ország, állam vagy akár önkormányzat is adatarchitektúránkban. Összességében a Sitata jelenleg országos szintű adatokat fed le. Van azonban néhány állami/tartományi rekordunk bizonyos régiókra, például az Egyesült Államokra és másokra.

Bármely rekord, amely rendelkezik bejegyzéssel az **origin_country_division_id** vagy **origin_country_region_id** mezőkben, állami, illetve önkormányzati szintű. Ha részletesebb adatokra van szüksége, kérjük, lépjen kapcsolatba velünk, és megbeszélhetjük az Ön felhasználási esetét.

Kérjük, szánjon időt a belépési feltételek adatstruktúrájának megismerésére API dokumentációnk itt.

Az adatstruktúra egy része kissé zavaró lehet, nevezetesen a “origin” kifejezés használatunk. Ez azért zavaró, mert a fejlesztők gyakran az eredet alatt az indulási helyet vagy a származási helyet értik. Azonban amit mi “origin” alatt értünk, az valójában a másokra kiszabott szabály forrása, vagyis az a ország vagy régió, amely a korlátozást létrehozta.

Egy másik fontos megjegyzendő pont, hogyan működik az érintett országok listánk. Ha az affected_countries üres, azt globális szabályként kell értelmezni, azaz minden ország érintett.

Néhány példa

Ahogy az dokumentációnkban láthatta, többféleképpen lehet lekérni az adatokat az API-ból. Az alábbiakban áttekintünk néhány leggyakoribb felhasználási esetet.

Hogyan kaphatom meg a követelményeket két ország között?

Többféleképpen lehet ilyen lekérdezést végrehajtani. A legegyszerűbb változat a **destination** és **departure** paraméterek használata. Ezek a paraméterek ISO 3166-1 alpha-2 kódokat fogadnak bemenetként.

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

A válasz tartalmazni fogja az összes szükséges követelményt (ország- és állami szinten), amelyet az utazónak meg kell értenie, aki az indulási országból utazik a célországba.

Mi van, ha állami szintű adatokra van szükségem?

A Sitata állami szintű adatokkal rendelkezik bizonyos régiókra. Akkor tudja, hogy egy adott bejegyzés államra vonatkozik, ha a origin_country_division értékkel rendelkezik. Az állami szintű adatok kinyeréséhez a **destination_country_division** paraméter használatával is szűrhet. Ez ISO_3166-2 értéket vár. Például US-TX Texas, USA esetén.

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

Vegye figyelembe, hogy egyszerűbb lehet ország szerint keresni, majd az adatokat állam szerint szűrni, hogy lássa, léteznek-e ilyen adatok, és ha igen, akkor azokat használni.

Hogyan kaphatom meg a követelményeket két repülőtér között?

Az országokhoz hasonlóan a Sitata API visszaadhatja az eredményeket két repülőtér között is. A departure_airport és destination_airport paraméterek ICAO vagy IATA kódokat használnak az eredmények szűréséhez. A válasz tartalmazni fogja az összes korlátozást (ország- és állami szinten), amelyet az utazónak meg kell értenie, aki a megfelelő indulási országból utazik a célországba.

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

A válasz tartalmazni fogja az összes korlátozást (ország- és állami szinten), amelyet az utazónak meg kell értenie, aki az indulási országból utazik a célországba.

Mi van, ha csak városinformációim vannak?

A Sitata úgy döntött, hogy nem válaszol konkrét városnévvel kapcsolatos kérésekre, mivel az konfliktusokat és zavart okozhat. Ehelyett úgy döntöttünk, hogy API-nk lekérdezéseit szélességi és hosszúsági koordináták alapján fogadjuk el, ami nem eredményez kétértelműséget az eredménykészletünkben. A paraméterek a következők: departure_lat, departure_lng, destination_lat és 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

Ha a városait helyek alapján oldja fel, és koordináták alapján végzi a lekérdezéseket, API-nk válaszolni fog az összes szükséges korlátozással (ország- és állami szinten), amelyet az utazónak meg kell értenie, aki az indulási országból utazik a célországba.

További információk

Egyes típusú belépési feltételek esetén további adatok társulhatnak egy extras nevű metaadat-típusú mezőben. Ez a mező egy kulcs/érték leképezés, amely egy adott követelményhez kapcsolódó különféle további információkat tartalmaz.

Hány napos a karantén?

Ez az adatbevitel a típus 5 belépési követelményhez tartozik. Ebben a bejegyzésben az **extras** leképezés tartalmazni fog egy quarantine_days nevű mezőt, amely egy egész számot tartalmaz a kiszabott karanténnapok számáról.

Hány órával a belépés előtt kell a negatív covid teszt?

Ez az adatbevitel a típus 8 belépési követelményhez tartozik. Ebben a bejegyzésben az **extras** leképezés tartalmazni fog egy entry_hours nevű mezőt, amely egy egész számot tartalmaz a belépés előtt megengedett negatív covid teszt óráinak számáról.

Tudassa velünk

Úgy gondoljuk, hogy rendelkezünk egy nagyon robusztus eszközzel, amely valószínűleg minden igényét kielégíti, hogy segítsen utazóinak megérteni, mivel találkozhatnak útközben. Ha van egy speciális felhasználási esete, amivel nem foglalkozunk, tudassa velünk!

Várjunk… van még!

Ez a bejegyzés egy kétrészes sorozat része, amely elmagyarázza, hogyan lehet interakcióba lépni a Sitata API-val a belépési feltételek és utazási korlátozások információiért. Eddig a belépési feltételekről beszéltünk, amelyek leírják az országba vagy régióba belépéshez szükséges szigorú igen/nem típusú feltételeket, de még nem beszéltünk arról, hogy mi történik az országon belül. Egy dolog tudni, hogyan lehet belépni egy országba, más dolog megérteni, hogy lehetséges-e az országon belül közlekedni, vagy meglátogatni a strandokat, vagy van-e kényszerű kijárási tilalom.

Maradjon velünk a második cikkért, amely részletesebben bemutatja utazási korlátozási adatsorozatunkat. Tipp: szinte teljesen megegyezik, így addig is megtekintheti API dokumentációnkat.