Kuinka käyttää Sitatan API:ita matkustajien matkarajoitusten määrittämiseen

Monet teistä eivät ehkä tiedä tätä, mutta Sitatan ensimmäiset perustukset rakennettiin sairauksien varhaista havaitsemista varten. Perustajallamme onkin TedX-puhe vuodelta 2016 aiheesta miksi matkustajia on varoitettava auttamaan estämään taudin leviäminen. Ei siis ole yllätys, että saimme tietää COVID-19:stä, kun epätavallinen keuhkokuumeiden ryhmä raportoitiin alkuvuodesta 2019. 2. tammikuuta 2020 terveystiimimme päätti, että meidän on annettava ensimmäinen varoituksemme matkustajillemme ja liikekumppaneillemme. Tämä tapahtui päiviä ennen Maailman terveysjärjestöä!

Väistämättömän seurausten aikana meillä oli oivallus. Tauti levisi niin nopeasti, että oli selvää, että globaali reaktio olisi parhaimmillaankin kaaosta. Jokainen maa toteuttaisi omat sääntönsä ja määräyksensä leviämisen hillitsemiseksi. Tämä aiheuttaisi väistämättä tuhoa maailmanlaajuisille matkoille ja suurta sekasortoa niille, jotka silti haluavat matkustaa. Olisimme oikeassa ja ryhdyimme tekemään asialle jotain. Sitata oli yksi maailman ensimmäisistä yrityksistä, joka loi omistetun API:n ja valvontapalvelun COVID-19:stä johtuvien matkarajoitusten ja sisäänpääsyvaatimusten muutoksille. Kehittyneen tapahtumien havaitsemisen ohjelmistojärjestelmän ja omistautuneen analyytikkotiimin ansiosta meillä oli jo kaikki oikeat työkalut ja prosessit sen tekemiseen.

Tämän uuden palvelun lanseerauksen jälkeen useat organisaatiot ovat hyödyntäneet dataa omien asiakkaidensa hyödyksi, mukaan lukien Eddy Travels, Flight Centre ja Etihad Airways; ja lisää tulee pian julkistamaan! Auttaaksemme lisää matkustukseen keskittynyttä organisaatiota hyötymään tästä tarjonnasta, olemme alla kirjoittaneet yksityiskohtaisesti sarjan esimerkkejä auttamaan selittämään, kuinka API:ta voidaan käyttää erilaisissa käyttötapauksissa. Toivon, että nämä selitykset auttavat sinua käynnistämään omia aloitteitasi.

Sisäänpääsyvaatimukset

Epäilemättä ensimmäiset kysymykset, joita matkustaja esittää, ovat “voinko mennä sinne?” ja “joudunko karanteeniin?”, joten tämä on hyvä paikka aloittaa. Olemme luoneet Sisäänpääsyvaatimukset -tietojoukon vastaamaan koviin “kyllä/ei” -kysymyksiin maahan tai alueelle pääsyn suhteen.

Tätä kirjoitettaessa tämä tietojoukko sisälsi seuraavat 10 erillistä kategoriaa:

• Voiko maan asukas päästä maahan?
• Voiko ulkomaalainen päästä maahan?
• Sallitaanko maan läpikulku?
• Vaatiiko saapuminen testin (taudinpurkaus)?
• Sallitaanko testitodistus (taudinpurkaus)?
• Vaatiiko saapuminen karanteeniin (taudinpurkaus)? Vaatiiko rokote?
• Vaatiiko vakuutus?
• Vaatiiko testitodistus?
• Vaatiiko rekisteröintilomake? (terveys tai muu)

Jokaisella kategorialla voi olla yksi seuraavista arvoista:

• Kyllä
• Kyllä, poikkeuksin
• Ei
• Ei, poikkeuksin

Vaikka valtaosa arvoista on “kyllä” ja “ei”, tilanne maassa ei aina ole niin yksinkertainen. Joskus on olemassa todella outoja ja hulluja sääntöjä, jotka eri hallitukset ovat asettaneet käyttöön ja jotka vaativat “poikkeuksin” -tyyppisiä arvoja.

Sisäänpääsyvaatimus on olennaisesti tietue, joka dokumentoi joukon sääntöjä, jotka toimija on asettanut yhdelle tai useammalle maalle tai alueelle. Toimija voi olla maa, osavaltio tai jopa kunta datamallissamme. Yleisesti ottaen Sitata kattaa tällä hetkellä tason maatason tiedot. Meillä on kuitenkin joitakin osavaltio-/maakuntatason tietueita valituille alueille, kuten Yhdysvalloille ja muille.

Mikä tahansa tietue, jolla on merkintä kentässä **origin_country_division_id** tai **origin_country_region_id**, on vastaavasti osavaltio- tai kuntatason tietue. Jos haluat käyttöösi hienojakoisempia tietoja, ota yhteyttä ja voimme keskustella käyttötapauksestasi.

Käytä hetki aikaa tutustuaksesi sisäänpääsyvaatimusten tietorakenteeseen katsomalla API-dokumentaatiotamme täältä.

Hieman hämmentävä osa tietorakenteesta on termin “alkuperä” käyttömme. Tämä on hämmentävää, koska kehittäjät usein ajattelevat, että alkuperä on lähtöpaikka tai lähtömaa. Kuitenkin tarkoitamme alkuperällä itse asiassa sääntöjen alkuperää, joka on asetettu muille, eli maata tai aluetta, joka on luonut rajoituksen.

Toinen tärkeä huomioitava seikka on, kuinka vaikutetut maat -listamme toimii. Jos affected_countries on tyhjä, sitä tulisi tulkita globaaliksi säännöksi. eli kaikki maat ovat vaikutuksen alaisia.

Muutamia esimerkkejä

Kuten olette nähneet dokumentaatiossa, API:sta on useita tapoja hakea tietoja. Tarkastelemme alla joitain yleisimmistä käyttötapauksista.

Miten saan vaatimukset kahden maan välillä?

Tämän tyyppistä pyyntöä voi tehdä parilla tavalla. Yksinkertaisin versio on käyttää **destination** ja **departure** -parametreja. Nämä parametrit hyväksyvät syötteinä ISO 3166-1 alfa-2 -koodeja.

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

Vastaus sisältää kaikki vaatimukset (maan ja osavaltion tasolla), jotka on ymmärrettävä matkustajalle, joka lähtee lähtömaasta ja matkustaa määränpäähän.

Entä jos haluan osavaltiotason tietoja?

Sitata sisältää osavaltiotason tietoja tietyille alueille. Tiedät, että tietty merkintä on osavaltiolle, jos origin_country_division -kentässä on arvo. Voit myös suodattaa vain osavaltiotason tietojen hakemiseksi käyttämällä **destination_country_division** -parametria. Se odottaa ISO_3166-2 -arvoa. Esimerkiksi US-TX Texasille, Yhdysvalloille.

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

Huomaa, että saattaa olla yksinkertaisempaa tehdä kysely maan mukaan ja sitten suodattaa osavaltioiden tiedot nähdäksesi, onko niitä olemassa, ja käyttää niitä, jos ne ovat olemassa.

Miten saan vaatimukset kahden lentokentän välillä?

Kuten maidenkin tapauksessa, Sitatan API voi palauttaa tuloksia kahden lentokentän välillä. Parametrit departure_airport ja destination_airport käyttävät ICAO - tai IATA -koodeja tulosten suodattamiseen. Vastaus sisältää kaikki rajoitukset (maan ja osavaltion tasolla), jotka on ymmärrettävä matkustajalle, joka lähtee vastaavasta lähtömaasta ja matkustaa määränpäähän.

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

Vastaus sisältää kaikki rajoitukset (maan ja osavaltion tasolla), jotka on ymmärrettävä matkustajalle, joka lähtee lähtömaasta ja matkustaa määränpäähän.

Entä jos minulla on vain kaupungin tiedot?

Sitata päätti olla sallimatta kyselyitä tietyn kaupungin nimellä, koska se saattaisi aiheuttaa ristiriitoja ja sekaannusta. Sen sijaan päätimme sallia kyselyn API:imme leveys- ja pituusastekoordinaateilla, mikä ei aiheuta mitään epäselvyyttä tuloksissamme. Parametrit ovat departure_lat, departure_lng, destination_lat ja 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

Jos selvität kaupunkisi sijainnit ja teet kyselyn koordinaattien perusteella, API:imme vastaa kaikilla rajoituksilla (maan ja osavaltion tasolla), jotka on ymmärrettävä matkustajalle, joka lähtee lähtömaasta ja matkustaa määränpäähän.

Lisätiedot

Joillekin sisäänpääsyvaatimustyypeille voi olla lisätietoja liitettynä metatietotyyppiseen kenttään nimeltä extras. Tämä kenttä on avain/arvo -kartoitus erilaisista ylimääräisistä tiedonpaloista tietylle vaatimukselle.

Mikä on karanteenin päivien määrä?

Tämä tietomerkintä liittyy sisäänpääsyvaatimukseen tyyppi 5. Tässä merkinnässä **extras** -kartoitus sisältää kentän nimeltä quarantine_days, joka sisältää kokonaisluvun määrätyille karanteenipäiville.

Mikä on tuntien määrä ennen sisäänpääsyä negatiiviselle covid-testille?

Tämä tietomerkintä liittyy sisäänpääsyvaatimukseen tyyppi 8. Tässä merkinnässä **extras** -kartoitus sisältää kentän nimeltä entry_hours, joka sisältää kokonaisluvun sille tunneille, jolloin negatiivinen covid-testi on sallittu ennen sisäänpääsyä.

Kerro meille

Uskomme, että meillä on erittäin kattava järjestelmä, joka todennäköisesti täyttää kaikki tarpeenne auttaaksenne matkustajianne ymmärtämään, mitä he todennäköisesti kohtaavat matkalla. Jos sinulla on erityinen käyttötapaus, jota emme kata, kerro se meille!

Odota… siinä on lisää!

Tämä merkintä on osa kaksiosaisesta sarjasta, joka selittää, kuinka vuorovaikutetaan Sitatan API:n kanssa sisäänpääsyvaatimuksia ja matkarajoitustietoja varten. Olemme toistaiseksi puhuneet Sisäänpääsyvaatimuksista, jotka kuvaavat kovia kyllä/ei -tyyppisiä vaatimuksia maahan tai alueelle pääsyyn, mutta emme ole myöskään puhuneet siitä, mitä maan sisällä tapahtuu. On eri asia tietää maahan pääsystä ja ymmärtää, onko mahdollista liikkua maassa tai vierailla rannoilla tai onko voimassa pakollinen ulkonaliikkumiskielto.

Pysy kuulolla toista postausta varten, joka sukeltaa Matkarajoitus -tietojoukkoomme. Vihje - se on lähes identtinen, joten voit aina katsoa API-dokumentaatiotamme sillä välin.