Mulți dintre voi nu știți, dar primele centre de Sitata au fost construite pentru detectarea timpurie a bolilor. De fapt, fondatorul nostru are o prezentare de TedX din 2016 despre de ce trebuie să anunțăm călătorii pentru a preveni răspândirea bolii. Nu trebuie să ne surprindă atunci că am intrat în COVID-19 când am fost informați de un grup neobișnuit de cazuri de pneumonie la începutul lunii decembrie 2019. La 2 ianuarie 2020, echipa noastră de sănătate a decis că ar trebui să emită prima noastră reclamă către călătorii și partenerii noștri comerciali. A fost cu câteva zile înainte chiar și de Organizația Mondială a Sănătății!

În timpul inevitabilei ploi radioactive, am avut parte de o epidemie. Boala se extindea atât de repede încât era clar că răspunsul global ar fi fost fatal în cele mai multe cazuri. Fiecare țară și-a promulgat propriul ansamblu de reglementări și reguli pentru a controla răspândirea. Acest lucru va provoca inevitabil o serie de obstacole în călătoriile mondiale și va fi o sursă enormă de confuzie pentru cei care doresc încă să călătorească. Aveam dreptate și am propus să facem ceva în acest sens. Sitata a fost una dintre primele întreprinderi din lume care a creat o API dedicată și un serviciu de supraveghere pentru modificările aduse restricțiilor de călătorie și cerințelor de intrare ca urmare a COVID-19. Cu un sistem avansat de software pentru detectarea evenimentelor și un echipament dedicat de analiști, aveam deja toate instrumentele și procesele adecvate pentru a face acest lucru.

Încă de la lansarea acestui nou serviciu am avut o varietate de organizații care utilizează datele în beneficiul propriilor clienți, inclusiv Eddy Travels, Flight Centre și Etihad Airways; și mai sunt și altele care vor fi anunțate în curând! În scopul de a ajuta ca mai multe organizații axate pe călătorii să beneficieze de această ofertă, am scris în detaliu în cele ce urmează o serie de exemple pentru a explica cum să utilizați API pentru o varietate de cazuri de utilizare. Sperăm că aceste explicații vă vor ajuta să vă puneți în mișcare propriile inițiative.

Cerințe de intrare

Fără îndoială, primele întrebări pe care le pune un călător sunt "¿puedo ir allí?" și "¿seré puesto en cuarentena?", așa că acesta este un loc bun pentru a începe. Hemos creado el conjunto de datos de Requisitos de Entrada para responder a los duros "sí/no" de las preguntas relativas a la entrada en un país o región.

În momentul redactării prezentului raport, acest ansamblu de date includea următoarele 10 categorii diferite:

• Poate un rezident să intre în țară?
• Poate un străin să intre în țară?
• Se permite tranzitul prin țară?
• ¿Se necesită o testare la sosire (apariția bolii)?
• ¿Se permite un certificat de testare (brotă de o boală)?
• ¿Se requiere una cuarentena a la llegada (brote de boală)? Este nevoie de o vaccinare?
• ¿Se necesită o asigurare?
• Este necesar un certificat de testare?
• Este necesar un formular de înscriere? (sănătate sau altul)

Fiecare categorie poate avea una dintre următoarele valori:

• Sí
• Sí, con excepciones
• Nu
• Nu, cu excepții

Deși marea majoritate a valorilor sunt "da" și "nu", situația de pe teren nu este întotdeauna atât de simplă. De multe ori, există reguli cu adevărat extravagante și locale pe care mai multe guverne le-au pus în aplicare, care impun tipurile de valori "cu excepții"

Un requisito de entrada este în mod esențial un registru care documentează un ansamblu de norme impuse de un agent împotriva unuia 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ă datele la nivel de țară în prezent. Cu toate acestea, avem unele registre statale/provinciale pentru regiuni selecționate precum Statele Unite și altele.

Orice înregistrare care are o intrare sub câmp origin_country_division_id o origin_country_region_id este unul care este de nivel statal sau municipal, respectiv. Dacă doriți să dispuneți de mai multe date generale, vă rugăm să luați legătura cu noi. cu noi și putem vorbi despre cazul său de utilizare.

Vă rugăm să acordați o perioadă de timp pentru a vă familiariza cu structura de date a cerințelor de intrare, aruncând o privire la documentele noastre de la API aici.

O parte puțin confuză cu privire la structura datelor este utilizarea noastră a termenului"origen" Acest lucru este confuz deoarece, de cele mai multe ori, dezvoltatorii cred că originea este locul de origine sau de plecare. Cu toate acestea, ceea ce vrem să spunem cu origine este în realitate originea reglementării 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.

Unele exemple

După cum ați văzut în documentație, există mai multe forme de recuperare a datelor de la API. În continuare, vom vedea câteva dintre cele mai comune cazuri de utilizare.

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

Există mai multe moduri de a face acest tip de cerere. Cea mai simplă versiune este să folosești destinul y ieșire parametri. 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 se deplasează în țara de destinație.

¿Y si quiero datos a nivel estatal?

Sitata are date la nivel statal pentru anumite regiuni. Știți că o intrare particulară este pentru un stat dacă el diviziune_paș_original câmpul are o valoare. De asemenea, se poate filtra pentru a recupera doar datele de nivel de stare folosind el diviziune_pașilor_destino parámetru. Așteptați o valoare ISO_3166-2. De exemplu, US-TX pentru Texas, Statele Unite ale Americii.

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

Observați că ar putea fi mai simplu să faceți o consultare pe țară și apoi să filtrați datele statelor pentru a vedea dacă există aceste date și să le utilizați dacă există.

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

La fel ca și în cazul țărilor, API-ul Sitata poate trimite rezultate între două aeroporturi. Parametrii aeroport de ieșire y aeroport de destinație utilizând codurile de la OACI o de la IATA pentru a filtra rezultatele. Răspunsul include toate restricțiile (la nivel de țară și de stat) necesare pentru a înțelege călătorul care iese din țara de plecare corespunzătoare și călătorește în țara de destinație.

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

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

Și dacă am doar informații despre oraș?

Sitata a ales să nu dea curs consultărilor pentru un nume de oraș în special, deoarece acest lucru ar putea da naștere la conflicte și confuzii. În locul lor, am ales să acomodăm consultarea la API-ul nostru prin coordonate de latitudine și lungime, ceea ce nu produce nicio ambiguitate în ansamblul nostru de rezultate. Parametrii sunt plecare_lat, plecare_lng, destinație_lat...y.. 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ă își rezolvă orașele în funcție de locații și consultă în funcție de coordonate, 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 ieșire și călătorește în ț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 de metadate numit figuranți. Acest câmp este o cartografie cheie/valoare de mai mulți biți de informații suplimentare pentru o cerere specială.

Care este numărul de zile de cuarentena?

Această intrare de date este supusă cerinței de intrare Tipo 5. În această intrare, el figuranți harta va conține un câmp numit días_de_cuarentena care va conține un număr întreg pentru numărul de zile de cuarentena impuestos.

Care este numărul de ore înainte de intrare pentru o probă de covidie negativă?

Această intrare de date este supusă cerinței de intrare tipo 8. În această intrare, el figuranți harta 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 se permite o probă de covidă negativă înainte de intrare.

Háganos saber

Credem că avem una foarte robustă, care probabil că satisface toate necesitățile pentru a ajuta călătorii să înțeleagă ceea ce este probabil să găsească pe drum. În cazul în care aveți un caz special de utilizare pe care nu îl abordăm, por favor háganoslo saber!

Espera... ¡hay más!

Această intrare face parte dintr-o serie de 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 reprezintă tipurile de cerințe necesare pentru a intra într-o țară sau regiune, dar nu am vorbit despre ceea ce se întâmplă în interiorul țării. Una cosa es saber acerca de entrar a un país, y otra es entender si es posible moverse por el país o visitar las playas sau si hay un toque de queda obligatorio.

Rămâneți în așteptare pentru a doua postare care va fi inclusă în setul nostru de date de Restricție de călătorie. Pista - este aproape identic, așa că întotdeauna poți să arunci o privire la noi documentație de la API mientras tanto.

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