S-ar putea ca mulți dintre voi să nu știe acest lucru, dar fundațiile inițiale ale Sitata au fost construite pentru detectarea precoce 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. Prin urmare, nu ar trebui să fie o surpriză faptul că am luat în considerare 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 nostru avertisment pentru călătorii și partenerii noștri de afaceri. Acest lucru s-a întâmplat cu câteva zile înainte chiar de Organizația Mondială a Sănătății!
În timpul consecințelor inevitabile, am avut o revelație. Boala se răspândea atât de repede încât era clar pentru noi că răspunsul global va fi cel mult haotic. Fiecare țară își va adopta propriul set de reglementări și reguli pentru a controla răspândirea. În mod inevitabil, acest lucru ar fi făcut ravagii în ceea ce privește călătoriile la nivel mondial și ar fi fost o sursă uriașă de confuzie pentru cei care încă doreau să călătorească. Am avut dreptate și ne-am propus să facem ceva în această privință. 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, o serie de organizații au profitat de date în beneficiul propriilor clienți, inclusiv Eddy Travels, Flight Centre și Etihad Airways; în curând vor fi anunțate și altele! 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 pentru a ajuta la explicarea modului de utilizare a API pentru o varietate de cazuri de utilizare. Sper ca aceste explicații să vă ajute să vă puneți în aplicare propriile inițiative.
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ă" și, prin urmare, 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" privind intrarea într-o țară sau regiune.
La momentul redactării, acest set de date includea următoarele 10 categorii distincte:
Fiecare categorie poate avea una dintre următoarele valori:
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 pus în aplicare și care necesită tipuri 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 poate fi o țară, un stat sau chiar o municipalitate în arhitectura noastră de date. În general, Sitata acoperă în prezent date la nivel național. Cu toate acestea, avem unele înregistrări statale/provinciale 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 una la nivel de stat sau, respectiv, la nivel municipal. Dacă doriți să dispuneți de date mai granulare, vă rugăm să contactați-ne și putem discuta despre cazul dvs. de utilizare.
Vă rugăm să acordați puțin timp pentru a vă familiariza cu structura de date a cerinței de intrare prin aruncați o privire la documentele noastre API aici.
O parte ușor confuză a structurii de date este utilizarea de către noi a termenului "origine." Acest lucru este confuz, deoarece dezvoltatorii se gândesc adesea 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 punct important de reținut 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.
După cum ați putut observa din documentație, există o serie de modalități de a extrage date din API. Mai jos vom trece în revistă câteva dintre cele mai comune cazuri de utilizare.
Există câteva modalități de a face acest tip de cerere. Cea mai simplă versiune este de a utiliza destinație și plecare parametri. Acești parametri acceptă ISO 3166-1 alfa-2 ca intrări.
GET https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination=INRăspunsul va include toate cerințele (la nivel de țară și de stat) necesare pentru înțelegerea călătorului care pleacă din țara de plecare și călătorește către țara de destinație.
Sitata are date la nivel de stat pentru anumite regiuni. Veți ști că o anumită intrare este pentru un stat dacă origine_țară_diviziune are o valoare. De asemenea, puteți filtra pentru a extrage numai date la nivel de stat utilizând destinație_diviziune_țară 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-APRețineți că ar putea fi mai simplu să interogați în funcție de țară și apoi să filtrați în funcție de datele de stat pentru a vedea dacă există astfel de date și să le utilizați dacă există.
La fel ca în cazul țărilor, API-ul Sitata poate returna rezultate între două aeroporturi. Parametrii plecare_aeroport ș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 înțelegerea călătorului 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=BOMRăspunsul va include toate restricțiile (la nivel de țară și de stat) necesare pentru înțelegerea călătorului care pleacă din țara de plecare și călătorește către țara de destinație.
Sitata a ales să nu permită interogări după un anumit nume de oraș, deoarece acest lucru ar putea duce la conflicte și confuzii. În schimb, am ales să permitem interogarea API-ului nostru prin 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.8777Dacă vă transformați orașele în locații și efectuați interogarea 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 călătorul care pleacă din țara de plecare și călătorește către țara de destinație.
Pentru unele tipuri de cerințe de intrare, pot exista date asociate suplimentare într-un câmp de tip metadate numit plusuri. Acest câmp este o corespondență cheie/valoare a diferitelor informații suplimentare pentru o anumită cerință.
Această introducere de date intră sub incidența cerinței de intrare tip 5. În această intrare, plusuri va conține un câmp numit zile_carantină care va conține un număr întreg pentru numărul de zile de carantină impuse.
Această introducere de date intră sub incidența cerinței de intrare tip 8. În această intrare, plusuri 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.
Credem că avem o soluție foarte solidă care va răspunde probabil tuturor nevoilor dvs. pentru a vă ajuta călătorii să înțeleagă ce vor întâlni probabil pe drum. Dacă aveți un anumit caz de utilizare pe care nu îl abordăm, vă rugăm să ne anunțați!
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 interdicție obligatorie de intrare.
Rămâneți pe recepție 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 oricând o privire la Documentație API între timp.
English 
Español 
Français 
Italiano 
Deutsch 
Magyar 
Română 
العربية 
Polski 
Português 
Nederlands 
Svenska 
Suomi 
Norsk bokmål 
Dansk