Kuinka käyttää Sitatan API:ita matkustajien matkarajoitusten selvittämiseen

Monet teistä eivät ehkä tiedä tätä, mutta Sitatassa varhaiset perustat rakennettiin varhaista tautien havaitsemista varten. Itse asiassa perustajallamme on TedX-puhe vuodelta 2016 aiheesta miksi meidän on varoitettava matkustajia auttaaksemme estämään tautien leviämisen. Ei siis pitäisi tulla yllätyksenä, että huomasimme COVID-19:n, kun siitä raportoitiin epätavallisena keuhkokuumeen tapausryhmänä jo joulukuun alussa 2019. 2. tammikuuta 2020 terveyttä koskeva tiimimme päätti, että meidän tulisi antaa 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ä meille kävi selväksi, että maailmanlaajuinen reaktio olisi parhaimmillaankin sekasortoinen. Jokainen maa toteuttaisi omat säädöksensä ja säännöt leviämisen hillitsemiseksi. Tämä aiheuttaisi väistämättä kaaosta maailmanlaajuiseen matkustamiseen ja suurta hämmennystä 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 seurantapalvelun COVID-19:stä johtuvien matkarajoitusten ja sisäänpääsyvaatimusten muutoksille. Kehittyneellä ohjelmistojärjestelmällämme tapahtumien havaitsemiseen ja omistetulla analyytikkotiimillämme meillä oli jo kaikki oikeat työkalut ja prosessit paikoillaan tehdäksemme niin.

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ää on tulossa pian! Auttaaksemme lisää matkustukseen keskittyviä organisaatioita hyötymään tästä tarjonnasta, olemme kirjoittaneet alla yksityiskohtaisesti useita esimerkkejä auttaaksemme selittämään, kuinka API:ta käytetään erilaisissa käyttötapauksissa. Toivon, että nämä selitykset auttavat sinua saamaan omat aloitteesi käyntiin.

Sisäänpääsyvaatimukset

Epäilemättä ensimmäiset kysymykset, joita matkustaja kysyy, ovat “voinko mennä sinne?” ja “joudunko karanteeniin”, joten tämä on hyvä paikka aloittaa. Loimme Sisäänpääsyvaatimukset -tietoaineiston vastaamaan koviin “kyllä/ei” -tyyppisiin kysymyksiin, jotka koskevat maahan tai alueelle pääsyä.

Kirjoitushetkellä tämä tietoaineisto sisälsi seuraavat 10 erillistä kategoriaa:

• Voiko maan asukas päästä maahan?
• Voiko ulkomaalainen päästä maahan?
• Sallitaanko maan läpikulku?
• Vaatiiko saapumista testi (tautiepäilys)?
• Sallitaanko testitodistus (tautiepäilys)?
• Vaatiiko saapumista karanteeni (tautiepäilys)? Vaatiiko rokotus?
• Vakuutus vaaditaan?
• Testitodistus vaaditaan?
• Sisäänpääsymuoto vaaditaan? (terveys tai muu)

Jokaisella kategorialla voi olla yksi seuraavista arvoista:

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

Vaikka valtaosa arvoista on “kyllä” ja “ei”, tilanne paikan päällä ei aina ole niin suoraviivainen. Joskus eri hallitukset ovat asettaneet käyttöön todella outoja ja hulluja sääntöjä, mikä edellyttää “poikkeuksin” -arvojen käyttöä.

Sisäänpääsyvaatimus on olennaisesti tietue, joka dokumentoi sääntöjä, jotka toimija on asettanut yhdelle tai useammalle muulle maalle tai alueelle. Toimija voi olla maa, osavaltio tai jopa kunta datarakenteessamme. Suurimmaksi osaksi Sitata kattaa tällä hetkellä maatasoiset tiedot. Meillä on kuitenkin joitakin osavaltio-/maakuntatietueita tietyille alueille, kuten Yhdysvalloille ja muille.

Mikä tahansa tietue, jolla on kentässä **origin_country_division_id** tai **origin_country_region_id** oleva merkintä, on joko osavaltio- tai kunnallistasoinen. Jos haluat käyttöösi tarkempaa dataa, ota yhteyttä ja voimme keskustella käyttötapauksestasi.

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

Yksi hieman hämmentävä osa tietorakenteesta on termin “origin” käyttömme. Tämä on hämmentävää, koska usein kehittäjät ajattelevat lähtöpaikan olevan alkuperä tai lähtöpaikka. Kuitenkin tarkoitamme alkuperällä itse asiassa sääntöjen alkuperää, joka on asetettu muille. Eli maa tai alue, joka on luonut rajoituksen.

Toinen tärkeä huomioitava seikka on, kuinka vaikutetut maiden listamme toimii. Jos affected_countries on tyhjä, sitä tulisi tulkita maailmanlaajuiseksi säännöksi. Eli kaikki maat ovat vaikutetut.

Muutamia esimerkkejä

Kuten olet ehkä nähnyt dokumentaatiosta, API:sta on useita tapoja noutaa dataa. Alla käymme läpi muutamia yleisimpiä käyttötapauksia.

Kuinka haen vaatimukset kahden maan välillä?

Tämän tyyppiseen pyyntöön on pari tapaa. Yksinkertaisin versio on käyttää parametreja **destination** ja **departure**. Nämä parametrit hyväksyvät syötteinä ISO 3166-1 alpha-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 dataa?

Sitatalla on osavaltiotason dataa tietyille alueille. Tiedät, että tietty merkintä on osavaltiolle, jos kentässä origin_country_division on arvo. Voit myös suodattaa vain osavaltiotason datan noutamiseen käyttämällä parametria **destination_country_division**. 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 hakea maan mukaan ja sitten suodattaa osavaltiodatan mukaan nähdäksesi, onko sellaista dataa olemassa, ja käyttää sitä, jos se on olemassa.

Kuinka haen vaatimukset kahden lentokentän välillä?

Aivan kuten maiden kanssa, Sitatan API voi palauttaa tuloksia kahden lentokentän välillä. Parametrit departure_airport ja destination_airport käyttävät joko 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 mukauttamatta kyselyjä tietyn kaupungin nimen mukaan, koska se voisi aiheuttaa ristiriitoja ja hämmennystä. Sen sijaan päätimme mukauttaa API:imme kyselyjä leveys- ja pituusastekoordinaattien mukaan, mikä ei aiheuta mitään epäselvyyttä tulossarjassamme. 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 ratkaiset kaupunkisi sijainneiksi 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ädata

Joillekin Sisäänpääsyvaatimusten tyypeille voi olla lisädataa metadatatyyppisessä kentässä nimeltä extras. Tämä kenttä on avain/arvo-kartoitus erilaisista lisätiedoista tietylle vaatimukselle.

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

Tämä datamerkintä kuuluu sisäänpääsyvaatimuksen tyyppiin 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ä negatiiviseen covid-testiin?

Tämä datamerkintä kuuluu sisäänpääsyvaatimuksen tyyppiin 8. Tässä merkinnässä **extras**-kartoitus sisältää kentän nimeltä entry_hours, joka sisältää kokonaisluvun tuntien määrälle, jonka negatiivinen covid-testi on sallittu ennen sisäänpääsyä.

Kerro meille

Uskomme, että meillä on erittäin vankka järjestelmä, joka todennäköisesti vastaa kaikkiin tarpeisiisi auttaaksesi matkustajiasi ymmärtämään, mitä he todennäköisesti kohtaavat matkalla. Jos sinulla on erityinen käyttötapaus, jota emme käsittele, 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, jotka tarvitaan maahan tai alueelle pääsyyn, mutta emme ole puhuneet siitä, mitä maan sisällä tapahtuu. On yksi asia tietää maahan menemisen ehdoista, toinen ymmärtää, onko mahdollista liikkua maassa tai vierailla rannoilla tai onko voimassa pakollinen ulkonaliikkumiskielto.

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