Hogyan használjuk a Sitata API-jait az utazási korlátozások meghatározásához

Sokan közületek talán nem tudják, de a Sitata korai alapjait a korai betegségészlelésre fektettük le. Alapítónknak van egy 201-es 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 már 2019 decemberében, amikor szokatlan tüdőgyulladás-esetek csoportjaként jelentették, felfigyeltünk a COVID-19-re. 2020. január 2-ára egészségügyi csapatunk úgy döntött, hogy kiadjuk első figyelmeztetésünket utazóink és üzleti partnereink számára. Ez még a Világegészségügyi Szervezetnél is napokkal korábban történt!

Az elkerülhetetlen következmények közepette egy felismerés ért minket. A betegség olyan gyorsan terjedt, hogy számunkra nyilvánvalóvá vált: a globális válasz legjobb esetben is kaotikus lesz. Minden ország saját szabályozási és szabályrendszert fog bevezetni a terjedés megfékezésére. Ez elkerülhetetlenül káoszt okoz a globális utazásban, és óriási zavar forrása lesz azok számára, akik továbbra is utazni szeretnének. Igazunk volt, és elhatároztuk, hogy teszünk valamit ellene. A Sitata volt az első cégek egyike a világon, amely dedikált API-t és monitorozási szolgáltatást hozott létre a COVID-19 miatti utazási korlátozások és belépési követelmények változásainak nyomon követésére. Egy fejlett szoftverrendszerrel az eseményészleléshez és egy dedikált elemzői csapattal már minden szükséges eszköz és folyamat a rendelkezésünkre állt.

Azóta, hogy elindítottuk ezt az új szolgáltatást, 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öbbet is bejelentünk! Hogy segítsünk több utazással foglalkozó szervezetnek profitálni ebből az ajánlatból, részletesen leírtunk alább néhány példát, hogy segítsünk megérteni az API használatát különböző felhasználási esetekben. Reméljük, ezek a magyarázatok segítenek elindítani saját kezdeményezéseiteket.

Belépési követelmények

Kétségtelen, hogy az utazó első kérdései általában azok, hogy “mehetek-e oda?” és “karanténba kell-e mennem?”, így ez jó kiindulópont. A Belépési követelmények adatkészletet azért hoztuk létre, hogy megválaszoljuk a kemény “igen/nem” típusú 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ő 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 átszállás az országon keresztül?
• 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 az oltás?
• Kötelező-e a biztosítás?
• Kötelező-e a tesztigazolás?
• Kötelező-e a belépési űrlap (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” vagy “nem”, a helyzet a gyakorlatban nem mindig ilyen egyértelmű. Néha nagyon furcsa és őrült szabályokat vezetnek be a különböző kormányok, ami megkívánja a “kivételekkel” értéktípusokat.

Egy Belépési követelmény lényegében egy olyan rekord, amely dokumentálja egy szereplő (aktor) által egy vagy több másik ország vagy régió ellen bevezetett szabályrendszert. Az aktor lehet ország, állam vagy akár önkormányzat is az adatarchitektúránkban. Jelenleg a Sitata túlnyomórészt országos szintű adatokat fed le. Vannak azonban állami/tartományi rekordjaink is bizonyos régiókra, például az Egyesült Államokra és másokra.

Bármely rekord, amelynek van bejegyzése az **origin_country_division_id** vagy **origin_country_region_id** mező alatt, állami, illetve önkormányzati szintű. Ha részletesebb adatokra van szükséged, kérjük, vedd fel velünk a kapcsolatot, és beszéljük meg a felhasználási esetedet.

Kérjük, szánj egy kis időt a Belépési követelmények adatszerkezetének megismerésére a következő API dokumentációnk áttekintésével.

Az adatszerkezet egy kissé zavaró része a “origin” (eredet) kifejezés használatunk. Ez azért zavaró, mert a fejlesztők gyakran az eredet alatt az indulási helyet értik. Azonban mi az eredet alatt valójában a szabályt másokra kiszabó fél eredetét értjük, azaz a korlátozást bevezető ország vagy régió eredetét.

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áthattad a dokumentációból, számos módja van az adatok lekérésének az API-ból. Az alábbiakban végigvezetünk néhány gyakoribb felhasználási eseten.

Hogyan kérjem le a követelményeket két ország között?

Van néhány módja az ilyen típusú kérésnek. A legegyszerűbb változat a **destination** és a **departure** paraméterek használata. Ezek a paraméterek ISO 3166-1 alpha-2 kódokat fogadnak el 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 állam szinten), amit 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 Sitatának vannak állami szintű adatai bizonyos régiókra. Akkor tudod, hogy egy adott bejegyzés állami szintű, ha a origin_country_division mezőnek van értéke. Az állami szintű adatok kizárólagos lekéréséhez használhatod a **destination_country_division** paramétert is. Ez ISO_3166-2 értéket vár. Például US-TX Texas, Egyesült Államok.

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

Vedd figyelembe, hogy egyszerűbb lehet ország szerint lekérdezni, majd szűrni az állami adatokra, hogy megnézd, léteznek-e ilyen adatok, és ha igen, akkor azokat használni.

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

Pont mint az országoknál, 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 állam szinten), amit az utazónak meg kell értenie, aki a megfelelő kiindulási országból indul és a célországba utazik.

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 állam szinten), amit az utazónak meg kell értenie, aki a 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 konfliktusokat és zavart okozhat. Ehelyett úgy döntöttünk, hogy lehetővé tesszük az API-nk lekérdezését szélességi és hosszúsági koordinátákkal, 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árosaidat helyekre oldod fel és koordináták alapján kérdezel le, API-nk válasza tartalmazni fogja az összes korlátozást (ország és állam szinten), amit az utazónak meg kell értenie, aki a kiindulási országból indul és a célországba utazik.

Extra adatok

Egyes típusú Belépési követelmények esetén lehetnek extra, hozzá tartozó adatok egy extras nevű metaadat típusú mezőben. Ez a mező egy kulcs/érték leképezés, amely egy adott követelmény különféle extra információit tartalmazza.

Hány napos a karantén?

Ez az adatbejegyzés a típus 5 belépési követelmény alá tartozik. Ebben a bejegyzésben az **extras** leképezés tartalmazni fog egy quarantine_days nevű mezőt, amely a kiszabott karantén napok számát tartalmazza egész számként.

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

Ez az adatbejegyzés a típus 8 belépési követelmény alá tartozik. Ebben a bejegyzésben az **extras** leképezés tartalmazni fog egy entry_hours nevű mezőt, amely azt az óraszámot tartalmazza egész számként, amennyivel a belépés előtt még érvényes lehet egy negatív COVID teszt.

Tudasd velünk

Úgy gondoljuk, hogy nagyon robusztus rendszerünk van, amely valószínűleg minden igényedet kielégíti ahhoz, hogy segítsd utazóidat megérteni, mivel találkozhatnak útközben. Ha van egy olyan felhasználási eseted, amit nem fedünk le, kérjük, tudasd velünk!

Várj… van még!

Ez a bejegyzés egy két részből álló sorozat része, amely elmagyarázza, hogyan működik a Sitata API a Belépési követelmények és Utazási korlátozások információiért. Eddig a Belépési követelményekről beszéltünk, amelyek egy országba vagy régióba való 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, hogy be lehet-e jutni egy országba, más dolog megérteni, hogy lehetséges-e közlekedni az országban, vagy meglátogatni a strandokat, vagy van-e kijárási tilalom.

Maradj velünk a második bejegyzésért, amely mélyen belemegy az Utazási korlátozások adatkészletünkbe. Tipp – szinte teljesen megegyezik, így addig is mindig megnézheted API dokumentációnkat.