Cum să utilizezi API-urile Sitata pentru a determina restricțiile de călătorie pentru călători

Mulți dintre voi poate nu știu, dar primele fundații ale Sitata au fost construite pentru detectarea timpurie a bolilor. De fapt, fondatorul nostru are un discurs TedX din 2016 despre de ce trebuie să avertizăm călătorii pentru a preveni răspândirea bolilor. Nu ar trebui să fie surprinzător atunci că am aflat despre COVID-19 când a fost raportat un grup neobișnuit de cazuri de pneumonie la începutul lunii decembrie 2019. Pe 2 ianuarie 2020, echipa noastră de sănătate a decis că trebuie să emită prima noastră avertizare către călătorii și partenerii noștri de afaceri. Acest lucru s-a întâmplat cu zile înaintea Organizației Mondiale a Sănătății!

În timpul inevitabilelor consecințe am avut o epifanie. Boala se răspândea atât de repede încât era clar că răspunsul global va fi haotic în cel mai bun caz. Fiecare țară va promulga propriul set de reguli și reglementări pentru a controla răspândirea. Acest lucru va provoca inevitabil haos în călătoriile globale și va fi o sursă uriașă de confuzie pentru cei care încă doresc să călătorească. Am avut dreptate și ne-am propus să facem ceva în legătură cu asta. Sitata a fost una dintre primele companii din lume care a creat un API dedicat și un serviciu de monitorizare pentru schimbările în restricțiile de călătorie și cerințele de intrare ca urmare a COVID-19. Cu un sistem software avansat pentru detectarea evenimentelor și o echipă dedicată de analiști, aveam deja toate instrumentele și procesele potrivite pentru a face acest lucru.

De la lansarea acestui nou serviciu, am avut o varietate de organizații care au valorificat datele în beneficiul propriilor clienți, inclusiv Eddy Travels, Flight Centre și Etihad Airways; și sunt mai multe care vor fi anunțate în curând! Pentru a ajuta mai multe organizații axate pe călătorii să beneficieze de această ofertă, am scris mai jos în detaliu o serie de exemple pentru a ajuta la explicarea modului de utilizare a API-ului pentru o varietate de cazuri de utilizare. Sper că aceste explicații vă vor ajuta să vă lansați propriile inițiative.

Cerințe de intrare

Fără îndoială, primele întrebări pe care și le pune un călător sunt “pot să merg acolo?” și “voi fi pus în carantină?”, așa că acesta este un loc bun de început. Am creat setul de date Cerințe de intrare pentru a răspunde la întrebările dure “da/nu” referitoare la intrarea într-o țară sau regiune.

În momentul redactării, acest set de date includea următoarele 10 categorii distincte:

• Poate un rezident să intre în țară?
• Poate un străin să intre în țară?
• Este permis tranzitul prin țară?
• Este necesar un test la sosire (în caz de epidemie)?
• Este permis un certificat de testare (în caz de epidemie)?
• Este necesară o carantină la sosire (în caz de epidemie)? Este necesară o vaccinare?
• Este necesară asigurare?
• Este necesar un certificat de testare?
• Este necesar un formular de înregistrare? (sanitar sau altul)

Fiecare categorie poate avea una dintre următoarele valori:

• Da
• Da, cu excepții
• Nu
• Nu, cu excepții

Deși marea majoritate a valorilor sunt “da” și “nu”, situația pe teren nu este întotdeauna atât de simplă. Uneori există reguli cu adevărat ciudate și nebunești pe care diferite guverne le-au implementat și care necesită tipurile de valori “cu excepții”.

O cerință de intrare este în esență o înregistrare care documentează un set de reguli impuse de un actor împotriva uneia sau mai multor țări sau regiuni. Actorul ar putea fi o țară, un stat sau chiar o municipalitate în arhitectura noastră de date. În general, Sitata acoperă date la nivel de țară în prezent. Cu toate acestea, avem câteva înregistrări la nivel de stat/provincie pentru regiuni selectate precum Statele Unite și altele.

Orice înregistrare care are o intrare în câmpul **origin_country_division_id** sau **origin_country_region_id** este una la nivel de stat sau municipal, respectiv. Dacă doriți să aveți date mai granulare, vă rugăm să ne contactați și putem discuta despre cazul dvs. de utilizare.

Vă rugăm să vă familiarizați cu structura datelor pentru cerințele de intrare aruncând o privire la documentația noastră API aici.

Un lucru puțin confuz despre structura datelor este utilizarea termenului “origine”. Acest lucru este confuz pentru că deseori dezvoltatorii cred că originea este locul de origine sau de plecare. Cu toate acestea, ceea ce înțelegem noi prin origine este de fapt originea regulii impuse altora, adică țara sau regiunea care a creat restricția.

Un alt punct important de notat este modul în care funcționează lista noastră de țări afectate. Dacă affected_countries este gol, ar trebui interpretat ca o regulă globală. Adică toate țările sunt afectate.

Câteva exemple

După cum ați văzut în documentație, există mai multe moduri de a prelua date din API. Vom analiza mai jos câteva dintre cele mai comune cazuri de utilizare.

Cum pot obține cerințele între două țări?

Există câteva moduri de a face acest tip de solicitare. Cea mai simplă versiune este să utilizați parametrii **destination** și **departure**. Acești parametri acceptă codurile ISO 3166-1 alfa-2 ca intrări.

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

Răspunsul va include toate cerințele (la nivel de țară și de stat) necesare pentru a înțelege pentru călătorul care pleacă din țara de plecare și călătorește către țara de destinație.

Dar dacă doresc date la nivel de stat?

Sitata are date la nivel de stat pentru anumite regiuni. Veți ști că o anumită intrare este pentru un stat dacă câmpul origin_country_division are o valoare. De asemenea, puteți filtra pentru a prelua doar datele la nivel de stat folosind parametrul **destination_country_division**. Așteaptă o valoare ISO_3166-2. De exemplu, US-TX pentru Texas, SUA.

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

Rețineți că ar putea fi mai simplu să interogați pe țară și apoi să filtrați datele la nivel de stat pentru a vedea dacă aceste date există și să le utilizați dacă există.

Cum pot obține cerințele între două aeroporturi?

La fel ca în cazul țărilor, API-ul Sitata poate returna rezultate între două aeroporturi. Parametrii departure_airport și destination_airport folosesc codurile ICAO sau IATA pentru a filtra rezultatele. Răspunsul va include toate restricțiile (la nivel de țară și de stat) necesare pentru a înțelege pentru călătorul care pleacă din țara de plecare corespunzătoare și călătorește către țara de destinație.

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

Răspunsul va include toate restricțiile (la nivel de țară și de stat) necesare pentru a înțelege pentru călătorul care pleacă din țara de plecare și călătorește către țara de destinație.

Dar dacă am doar informații despre oraș?

Sitata a ales să nu accepte interogări după un anumit nume de oraș, deoarece acest lucru ar putea duce la conflicte și confuzie. În schimb, am ales să acceptăm interogarea către API-ul nostru prin coordonate de latitudine și longitudine, ceea ce nu produce nicio ambiguitate în setul nostru de rezultate. Parametrii sunt departure_lat, departure_lng, destination_lat și 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

Dacă rezolvați orașele dvs. în locații și interogați pe baza coordonatelor, API-ul nostru va răspunde cu toate restricțiile (la nivel de țară și de stat) necesare pentru a înțelege pentru călătorul care pleacă din țara de plecare și călătorește către țara de destinație.

Date suplimentare

Pentru unele tipuri de cerințe de intrare, pot exista date suplimentare asociate într-un câmp de tip metadate numit extras. Acest câmp este o mapare cheie/valoare a diferitelor informații suplimentare pentru o anumită cerință.

Care este numărul de zile de carantină?

Această intrare de date este supusă cerinței de intrare tip 5. În această intrare, maparea **extras** va conține un câmp numit quarantine_days care va conține un număr întreg pentru numărul de zile de carantină impuse.

Care este numărul de ore înainte de intrare pentru un test covid negativ?

Această intrare de date este supusă cerinței de intrare tip 8. În această intrare, maparea **extras** va conține un câmp numit entry_hours care va conține un număr întreg pentru numărul de ore în care un test covid negativ este permis înainte de intrare.

Spuneți-ne

Credem că avem o ofertă foarte robustă care probabil satisface toate nevoile dvs. de a vă ajuta călătorii să înțeleagă ce este probabil să întâlnească pe drum. Dacă aveți un caz de utilizare particular pe care nu îl acoperim, vă rugăm să ne spuneți!

Așteptați… mai este!

Această postare face parte dintr-o serie în două părți care explică cum să interacționați cu API-ul Sitata pentru cerințele de intrare și informațiile despre restricțiile de călătorie. Până acum am vorbit despre Cerințele de intrare care conturează tipurile dure de cerințe da/nu necesare pentru a intra într-o țară sau regiune, dar nu am vorbit încă despre ce se întâmplă în interiorul țării. Una este să știi despre intrarea într-o țară, și alta este să înțelegi dacă este posibil să te miști în țară sau să vizitezi plajele sau dacă există o stare de alertă obligatorie.

Rămâneți pe fază pentru al doilea post care se va scufunda în setul nostru de date Restricție de călătorie. Indiciu - este aproape identic, așa că puteți arunca oricând o privire la documentația API în timp ce așteptați.