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 első alapjait a betegségek korai felismerésére építettük. Alapítónknak van egy 2016-os TedX előadása 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 a COVID-19-ről akkor értesültünk, amikor 2019 december elején egy szokatlan tüdőgyulladásos esetcsoportról számoltak be. 2020. január 2-án egészségügyi csapatunk úgy döntött, hogy kiadjuk első figyelmeztetésünket utasainknak és üzleti partnereinknek. Ez még a Világegészségügyi Szervezet előtt is napokkal történt!

Az elkerülhetetlen következmények során egy felismerés ért minket. A betegség olyan gyorsan terjedt, hogy világossá vált: a globális válasz a legjobb esetben is kaotikus lesz. Minden ország saját szabályrendszert és előírásokat fog bevezetni a terjedés megfékezésére. Ez elkerülhetetlenül káoszt okoz a világ utazásában, és hatalmas zavarforrás lesz azok számára, akik még mindig utazni szeretnének. Igazunk volt, és elhatároztuk, hogy teszünk valamit. A Sitata volt az egyik első cég a világon, amely dedikált API-t és felügyeleti szolgáltatást hozott létre az utazási korlátozások és belépési követelmények COVID-19 miatti változásainak nyomon követésére. Egy fejlett szoftverrendszerrel az eseményészleléshez és egy elkötelezett elemzőcsapattal már rendelkeztünk minden szükséges eszközzel és folyamattal ennek megvalósításához.

Az új szolgáltatás indítása óta számos szervezet vette igénybe az adatokat saját ügyfeleik javára, köztük az Eddy Travels, a Flight Centre és az Etihad Airways; és hamarosan még több bejelentés várható! Annak érdekében, hogy több utazásorientált szervezet is profitálhasson ebből az ajánlatból, részletesen leírtunk alább néhány példát, hogy segítsünk megmagyarázni az API különböző használati esetekben történő felhasználását. Reméljük, ezek a magyarázatok segítenek elindítani saját kezdeményezéseit.

Belépési követelmények

Kétségtelenül az első kérdések, amiket egy utazó feltesz: “oda tudok-e menni?” és “karanténba kerülök-e?”, tehát ez egy jó kiindulópont. Létrehoztuk a Belépési Követelmények adatkészletét, hogy megválaszoljuk az országba vagy régióba belépéssel kapcsolatos kemény “igen/nem” típusú kérdéseket.

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

• Beléphet-e egy állampolgár az országba?
• Beléphet-e egy külföldi az országba?
• Megengedett-e az országon át történő átszállás?
• Kötelező-e teszt az érkezéskor (járvány esetén)?
• Elfogadható-e tesztigazolás (járvány esetén)?
• Kötelező-e karantén az érkezéskor (járvány esetén)?
• Kötelező-e oltás?
• Kötelező-e biztosítás?
• Kötelező-e tesztigazolás?
• Kötelező-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 a legtöbb érték “igen” és “nem”, a helyzet a gyakorlatban nem mindig ilyen egyszerű. Néha vannak nagyon furcsa és őrült szabályok, amelyeket különböző kormányok vezettek be, és amelyek a “kivételekkel” típusú értékeket igénylik.

Egy belépési követelmény lényegében egy olyan rekord, amely dokumentálja egy szereplő által egy vagy több ország vagy régió ellen kiszabott szabályok halmazát. A szereplő lehet ország, állam vagy akár önkormányzat is adatarchitektúránkban. Általánosságban a Sitata jelenleg országos szintű adatokat fed le. Vannak azonban állami/tartományi rekordjaink kiválasztott régiókra, például az Egyesült Államokra és másokra.

Bármely rekord, amelynek van bejegyzése a **origin_country_division_id** vagy **origin_country_region_id** mező alatt, á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 használati esetét.

Kérjük, szánjon egy kis időt a belépési követelmények adatstruktúrájának megismerésére, tekintse meg API dokumentációnkat itt.

Az adatstruktúrával kapcsolatban egy kicsit zavaró lehet az “eredet” kifejezés használatunk. Ez azért zavaró, mert a fejlesztők gyakran úgy gondolják, hogy az eredet az indulási vagy származási hely. Azonban az, amire mi eredetként gondolunk, 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

Ahogyan láthatták a dokumentációban, többféleképpen lehet adatokat lekérni az API-ból. Az alábbiakban megvizsgálunk néhány gyakori használati esetet.

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

Van néhány módja ennek a típusú kérésnek. A legegyszerűbb változat a **destination** és **departure** paraméterek használata. Ezek a paraméterek ISO 3166-1 alfa-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 a kiindulási országból indul és a célországba utazik.

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

A Sitata állami szintű adatokkal rendelkezik bizonyos régiókra. Akkor tudhatja, hogy egy adott bejegyzés államra vonatkozik, ha a origin_country_division_id mezőnek van értéke. Az állami szintű adatok lekérésére szűrhet is a **destination_country_division** paraméterrel. 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 lekérdezni, majd szűrni az állami adatokra, hogy megnézze, léteznek-e, és használja őket, ha igen.

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

Az országokhoz hasonlóan a Sitata API két repülőtér közötti eredményeket is visszaadhatja. A departure_airport és destination_airport paraméterek ICAO vagy IATA repülőtéri kódokat használnak az eredmények szűréséhez.

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

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

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

A Sitata úgy döntött, hogy nem támogatja a lekérdezéseket konkrét városnév alapján, mert az ütközésekhez és zavarokhoz vezethet. Ehelyett úgy döntöttünk, hogy a koordinátákon (szélességi és hosszúsági fok) alapuló lekérdezéseket támogatjuk API-nkban, ami nem eredményez kétértelműséget az eredményhalmazunkban. A paraméterek: 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 helyekké oldja fel és koordináták alapján kérdez le, API-nk válaszol az összes szükséges korlátozással (ország- és állami szinten), amelyet az utazónak meg kell értenie, aki a kiindulási országból indul és a célországba utazik.

További adatok

Egyes belépési követelménytípusokhoz további adatok tartozhatnak 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önböző extra információkat tartalmaz.

Hány napos a karantén?

Ez az adatbejegyzés az 5. típusú belépési követelményhez kapcsolódik. 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én napok számára.

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

Ez az adatbejegyzés a 8. típusú belépési követelményhez kapcsolódik. 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 negatív COVID teszt belépés előtt megengedett óráinak számára.

Tudassa velünk

Úgy gondoljuk, hogy rendkívül robusztus API-val rendelkezünk, amely valószínűleg kielégíti minden igényét az utasai számára az útjuk során várható feltételek megértésében. Ha van egy olyan konkrét használati esete, amit nem kezelünk, kérjük, tudassa velünk!

Várjunk… van még!

Ez a bejegyzés egy kétrészes sorozat része, amely elmagyarázza, hogyan lehet kommunikálni a Sitata API-jával a belépési követelmények és az utazási korlátozások információi terén. Eddig a Belépési Követelményekről beszéltünk, amelyek egy országba vagy régióba belépéshez szükséges kemény igen/nem típusú követelményeket vázolják fel, 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, és egy másik megérteni, hogy lehetséges-e az országban közlekedni, vagy meglátogatni a strandokat, vagy van-e kijárási tilalom.

Maradjon velünk a második bejegyzésért, amely beleveti magát az Utazási Korlátozások adatkészletünkbe. Tipp – szinte teljesen megegyezik, így addig is mindig megnézheti API dokumentációnkat.