Poate că mulți dintre dumneavoastră nu știți acest lucru, dar fundațiile inițiale 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 contribui la prevenirea răspândirii bolilor. Nu ar trebui să fie o surpriză faptul că am preluat COVID-19 atunci când a fost raportat ca un grup neobișnuit de cazuri de pneumonie la începutul lunii decembrie 2019. Până la 2 ianuarie 2020, echipa noastră de sănătate a stabilit că ar trebui să emitem primul avertisment adresat călătorilor și partenerilor noștri de afaceri. Asta se întâmpla cu câteva zile înainte chiar de Organizația Mondială a Sănătății!

În timpul inevitabilelor consecințe, am avut o revelație. Boala se răspândea atât de repede încât ne era clar că răspunsul global va fi, în cel mai bun caz, haotic. Fiecare țară va adopta propriul set de reglementări și reguli pentru a controla răspândirea. Acest lucru ar provoca inevitabil un haos în călătoriile la nivel mondial și ar fi o sursă uriașă de confuzie pentru cei care încă mai doresc să călătorească. Am avut dreptate și ne-am propus să facem ceva în acest sens. Sitata a fost una dintre primele companii din lume care a creat un API dedicat și un serviciu de monitorizare a modificărilor în ceea ce privește 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 când am lansat acest nou serviciu, o serie de organizații au profitat de aceste date în beneficiul propriilor clienți, printre care Eddy Travels, Flight Centre și Etihad Airways, iar altele 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 în detaliu mai jos o serie de exemple care să ne ajute să explicăm cum să folosim API-ul pentru o varietate de cazuri de utilizare. Sper ca aceste explicații să vă ajute 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 merge acolo?" și "voi fi pus în carantină?", așa că acesta este un bun punct de plecare. Am creat setul de date privind cerințele de intrare pentru a răspunde la întrebările dificile de tipul "da/nu" referitoare la intrarea într-o țară sau regiune.

La momentul redactării acestui document, 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 (focar de boală)?
• Este permis un certificat de testare (focar de boală)?
• Este necesară carantina la sosire (focar de boală)? Este necesară o vaccinare?
• Asigurare necesară?
• Este necesar un certificat de testare?
• Formular de înscriere necesar? (sănătate sau altele)

Fiecare categorie poate avea una dintre următoarele valori:

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

În timp ce marea majoritate a valorilor sunt "da" și "nu", situația de pe teren nu este întotdeauna atât de simplă. Uneori, există reguli cu adevărat ciudate și nebunești pe care diverse guverne le-au pus în aplicare, ceea ce impune tipurile de valori "cu excepții".

O cerință de intrare este, în esență, un document care consemnează un set de reguli impuse de un actor față de una sau mai multe alte țări sau regiuni. Actorul poate fi o țară, un stat sau chiar o municipalitate în arhitectura noastră de date. În general, Sitata acoperă în prezent date la nivel de țară. Cu toate acestea, avem câteva înregistrări de stat/provincie pentru anumite regiuni, cum ar fi Statele Unite și altele.

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

Vă rugăm să vă acordați puțin timp pentru a vă familiariza cu structura de date privind cerințele de intrare prin consultând documentația noastră API aici.

O parte ușor confuză a structurii de date este utilizarea termenului "origine." Acest lucru este derutant, deoarece adesea dezvoltatorii se gândesc la origine ca fiind locul de origine sau locul de plecare. Cu toate acestea, ceea ce înțelegem prin origine este, de fapt, originea regulii impuse altora. adică țara sau regiunea care a creat restricția.

Un alt aspect important de reținut este modul în care funcționează lista țărilor afectate. Dacă affected_countries este goală, aceasta trebuie interpretată ca o regulă globală, adică toate țările sunt afectate.

Câteva exemple

După cum probabil ați văzut în documentație, există mai multe modalități de a prelua date din API. Mai jos vom trece în revistă câteva dintre cele mai comune cazuri de utilizare.

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

Există mai multe modalități de a face acest tip de cerere. Cea mai simplă variantă este să folosiți opțiunea destinație și plecare parametrii. Acești parametri acceptă 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 se deplasează în țara de destinație.

Ce se întâmplă dacă vreau date la nivel de stat?

Sitata dispune de date la nivel de stat pentru anumite regiuni. Veți ști că o anumită intrare se referă la un stat dacă origin_country_division are o valoare. De asemenea, puteți filtra pentru a prelua numai datele la nivel de stat utilizând funcția diviziunea_țării_de_destinație parametru. Se așteaptă un ISO_3166-2 valoare. De exemplu, US-TX pentru Texas, Statele Unite.

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 în funcție de țară și apoi să filtrați după datele de stat pentru a vedea dacă există astfel de date ș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 aeroport_departare și destinație_aeroport utilizați fie OACI 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 călătorul care pleacă din țara de plecare corespunzătoare și se deplasează în ț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) pe care trebuie să le înțeleagă călătorul care pleacă din țara de plecare și se deplasează în țara de destinație.

Ce se întâmplă dacă am doar informații despre oraș?

Sitata a ales să nu permită interogări după numele unui anumit oraș, deoarece acest lucru ar putea duce la conflicte și confuzii. În schimb, am ales să permitem interogarea API-ului nostru după coordonatele de latitudine și longitudine, ceea ce nu produce nicio ambiguitate în setul nostru de rezultate. Parametrii sunt plecare_lat, plecare_lng, destinație_lat, și destinație_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ă transformați orașele în locații și interogați pe baza coordonatelor, API-ul nostru vă va răspunde cu toate restricțiile (la nivel de țară și de stat) necesare pentru a înțelege călătorul care pleacă din țara de plecare și călătorește spre țara de destinație.

Date suplimentare

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

Care este numărul de zile de carantină?

Această introducere de date se încadrează în cerința de intrare tip 5. În această rubrică, se utilizează figuranți va conține un câmp numit zile_de_carantină 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 covidian negativ?

Această introducere de date se încadrează în cerința de intrare tip 8. În această rubrică, se utilizează figuranți va conține un câmp numit orele_de_intrare care va conține un număr întreg pentru numărul de ore în care este permis un test covidic negativ înainte de intrare.

Să ne anunțați

Credem că avem o soluție foarte solidă care va răspunde probabil tuturor nevoilor dvs. pentru a-i ajuta pe călători să înțeleagă ce vor întâlni probabil pe parcurs. Dacă aveți un anumit caz de utilizare pe care nu îl abordăm, vă rugăm să ne anunțați!

Așteaptă... mai e ceva!

Această intrare face parte dintr-o serie de două părți care explică modul de interacțiune cu API-ul Sitata pentru informații privind cerințele de intrare și restricțiile de călătorie. Până acum am vorbit despre Cerințele de intrare, care descriu cerințele de tip "da/nu" necesare pentru a intra într-o țară sau regiune, dar nu am vorbit nici despre ceea ce se întâmplă în interiorul țării. Una este să știi despre intrarea într-o țară, alta este să înțelegi dacă este posibil să te deplasezi în țară sau să vizitezi plajele sau dacă există o stare de asediu obligatorie.

Rămâneți cu noi pentru a doua postare care va analiza în profunzime setul nostru de date privind restricțiile de călătorie. Indicație - este aproape identic, așa că puteți arunca o privire la Documentația API între timp.

Vă rugăm să ne urmăriți și să ne dați like: