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. Itse asiassa perustajamme piti TedX-puheen jo vuonna 2016 siitä, miksi matkustajia on varoitettava taudin leviämisen estämiseksi. Ei siis ole yllätys, että saimme tietää COVID-19:stä, josta raportoitiin epätavallisena keuhkokuumeen tapausryhmänä joulukuun alussa 2019. 2. tammikuuta 2020 terveystiimimme päätti, että meidän on annettava ensimmäinen varoitus matkustajillemme ja liikekumppaneillemme. Tämä tapahtui jopa muutama päivä ennen Maailman terveysjärjestöä!

Väistämättömien seurausten myötä saimme oivalluksen. Tauti levisi niin nopeasti, että meille oli selvää, että maailmanlaajuinen reaktio olisi parhaimmillaankin kaaosta. Jokainen maa aikoi säätää omat säädöksensä ja säännöt taudin leviämisen hillitsemiseksi. Tämä aiheuttaisi väistämättä hämmennystä ympäri maailmaa ja olisi valtava sekaannuksen lähde niille, jotka halusivat silti matkustaa. Olikimme oikeassa ja päätimme tehdä asialle jotain. Sitata oli yksi maailman ensimmäisistä yrityksistä, joka loi dedikoidun API:n ja palvelun matkarajoitusten ja sisäänpääsyvaatimusten muutosten seuraamiseen COVID-19:n seurauksena. Kehittyneen tapahtumien havaitsemisen ohjelmistojärjestelmän ja erikoistuneiden analyytikoiden tiimin ansiosta meillä oli jo kaikki tarvittavat työkalut ja prosessit tämän saavuttamiseksi.

Tämän uuden palvelun lanseerauksen jälkeen useat organisaatiot ovat hyödyntäneet dataa omien asiakkaidensa hyväksi, mukaan lukien Eddy Travels, Flight Centre ja Etihad Airways; lisätietoja julkaistaan pian! Auttaaksemme useampia matkailualan organisaatioita hyötymään tarjonnasta, olemme alla yksityiskohtaisesti kirjoittaneet useita esimerkkejä selittääksemme, kuinka API:a voidaan käyttää erilaisissa käyttötapauksissa. Toivon, että nämä selitykset auttavat käynnistämään omia aloitteitanne.

Sisäänpääsyvaatimukset

Ensimmäiset kysymykset, joita matkustaja varmasti kysyy, ovat: “Voinko mennä sinne?” ja “Joudunko karanteeniin?”, joten se on hyvä lähtökohta. Loimme sisäänpääsyvaatimusten tietojoukon vastaamaan vaikeisiin “kyllä/ei”-tyyppisiin kysymyksiin maahan tai alueelle pääsemisestä.

Tämän kirjoittamisen hetkellä tämä tietojoukko sisälsi seuraavat kymmenen erillistä kategoriaa:

• Voiko maan asukas päästä maahan?
• Voiko ulkomaalainen päästä maahan?
• Sallitaanko maan läpikulku?
• Vaaditaanko testiä saapumisen yhteydessä (sairauden ilmaantuminen)?
• Hyväksytäänkö testitodistus (sairauden ilmaantuminen)?
• Tarvitaanko saapumisen yhteydessä karanteenia (sairauden ilmaantuminen)? Tarvitaanko rokotus?
• Vaaditaanko vakuutusta?
• Vaaditaanko testitodistusta?
• Vaaditaanko rekisteröintilomaketta? (terveys tai muu)

Jokaisella kategorialla voi olla yksi seuraavista arvoista:

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

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

Sisäänpääsyvaatimus on pohjimmiltaan asiakirja, joka dokumentoi sääntöjoukon, jonka toimija on asettanut yhtä tai useampaa muuta maata tai aluetta vastaan. Toimija voi olla maa, osavaltio tai jopa kunta datamallissamme. Kaiken kaikkiaan Sitata kattaa tällä hetkellä tiedot valtiotasolla. Meillä on kuitenkin muutamia osavaltioiden/maakuntien tietueita joillekin alueille, kuten Yhdysvalloille ja muille.

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

Tutustu sisäänpääsyvaatimusten tietorakenteeseen API-dokumentaatiostamme täältä.

Osa tietorakenteesta on hieman hämmentävää, nimittäin termin “origin” käyttömme. Tämä sekoitus johtuu siitä, että kehittäjät pitävät usein alkuperää lähtöpaikkana tai lähtöpaikkana. Kuitenkin, mitä tarkoitamme “alkuperällä”, on 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 vaikutettuja.

Muutamia esimerkkejä

Kuten olet ehkä huomannut dokumentaatiosta, API-datan hakemiseen on useita tapoja. Alla käymme läpi muutamia yleisimpiä käyttötapauksia.

Kuinka saada vaatimukset kahden maan välillä?

Tällaisen kyselyn tekemiseen on useita tapoja. Yksinkertaisin versio on käyttää parametreja **destination** ja **departure**. Nämä parametrit hyväksyvät syötteiksi ISO 3166-1 alpha-2 -koodeja.

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

Vastaus sisältää kaikki vaatimukset (valtio- ja osavaltiotasolla), jotka matkustajan on ymmärrettävä lähtiessään lähtömaasta ja matkustaessaan kohdemaahan.

Entä jos haluan osavaltiotason tietoja?

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

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

Huomaa, että saattaa olla yksinkertaisempaa hakea maittain ja sitten suodattaa tiedot osavaltion mukaan nähdäksesi, onko tällaisia tietoja olemassa, ja käyttää niitä, jos ne ovat olemassa.

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

Aivan kuten maissa, Sitatan API voi palauttaa tulokset 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 (valtio- ja osavaltiotasolla), jotka matkustajan on ymmärrettävä lähtiessään vastaavasta lähtömaasta ja matkustaessaan kohdemaahan.

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

Vastaus sisältää kaikki rajoitukset (valtio- ja osavaltiotasolla), jotka matkustajan on ymmärrettävä lähtiessään lähtömaasta ja matkustaessaan kohdemaahan.

Entä jos minulla on vain tietoja kaupungista?

Sitata on päättänyt olla vastaamatta kyselyihin, jotka koskevat tiettyä kaupungin nimeä, koska se saattaisi aiheuttaa ristiriitoja ja sekaannusta. Sen sijaan olemme päättäneet hyväksyä API-kyselymme leveys- ja pituusastekoordinaateilla, mikä ei aiheuta 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 ratkaiset kaupunkisi sijaintien perusteella ja teet kyselyjä koordinaattien perusteella, API:imme vastaa kaikilla rajoituksilla (valtio- ja osavaltiotasolla), jotka matkustajan on ymmärrettävä lähtiessään lähtömaasta ja matkustaessaan kohdemaahan.

Lisätiedot

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

Kuinka monta päivää karanteenia on?

Tämä datan syöttö on sidottu 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.

Kuinka monta tuntia ennen sisäänpääsyä negatiivinen covid-testi on voimassa?

Tämä datan syöttö on sidottu sisäänpääsyvaatimukseen tyyppi 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 voimassa ennen sisäänpääsyä.

Kerro meille

Uskomme, että meillä on erittäin vankka työkalu, 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 kata, kerro siitä meille!

Odota… siinä on lisää!

Tämä merkintä on osa kaksiosaisia sarjaa, joka selittää, kuinka vuorovaikutetaan Sitatan API:n kanssa sisäänpääsyvaatimusten ja matkarajoitusten tietojen saamiseksi. Toistaiseksi olemme puhuneet sisäänpääsyvaatimuksista, jotka kuvaavat tiukkoja kyllä/ei-tyyppisiä ehtoja maahan tai alueelle pääsemiseksi, mutta emme ole myöskään puhuneet siitä, mitä maan sisällä tapahtuu. On yksi asia tietää, kuinka päästä maahan, ja toinen ymmärtää, onko maassa mahdollista liikkua tai vierailla rannoilla tai onko voimassa pakollinen ulkonaliikkumiskielto.

Pysy kuulolla toista artikkelia varten, joka syventyy matkarajoitusten tietosarjaamme. Vihje: se on lähes identtinen, joten voit aina tarkistaa API-dokumentaatiomme odotellessa.