Come utilizzare le API di Sitata per determinare le restrizioni di viaggio per i viaggiatori

Scritto da Madeline Sharpe

22 dicembre 2020

Tecnologia

Molti di noi non lo sanno, ma i primi centri di Sitata sono stati costruiti per la diagnosi tempestiva delle malattie. Per questo motivo, il nostro fondatore ha tenuto un discorso al TedX a partire dal 2016 su perché è necessario avvisare i viaggiatori per prevenire la propagazione dell'infezione?. Non c'è da stupirsi, quindi, se siamo entrati nella COVID-19 quando, a inizio dicembre 2019, abbiamo ricevuto la notizia di un insolito gruppo di casi di neonite. Il 2 gennaio 2020, la nostra equipe sanitaria ha deciso di emettere nuestra primera advertencia a nuestros viajeros y socios comerciales. Questo avveniva già qualche tempo prima anche dell'Organizzazione Mondiale della Sanità!

Durante l'inevitabile pioggia radioattiva abbiamo avuto un'epidemia. L'epidemia si stava estendendo con una rapidità tale da rendere evidente che la risposta globale sarebbe stata caotica nella maggior parte dei casi. Ogni Paese promulgava il proprio insieme di norme e regole per controllare la propagazione. Questo inevitabilmente causerà estranei nei viaggi in tutto il mondo e sarà un'enorme fonte di confusione per coloro che desiderano viaggiare. Avevamo ragione e abbiamo proposto di fare qualcosa al riguardo. Sitata è stata una delle prime aziende al mondo a creare un'API dedicata e un servizio di supervisione per le modifiche alle restrizioni di viaggio e ai requisiti di ingresso come risultato della COVID-19. Con un sistema avanzato di software per la rilevazione degli eventi e un equipaggio dedicato di analisti, avevamo già tutti gli strumenti e i processi adatti per farlo.

Fin dall'avvio di questo nuovo servizio abbiamo avuto una serie di organizzazioni che utilizzano i dati a beneficio dei propri clienti, tra cui Eddy Travels, Flight Centre ed Etihad Airways; e ce ne sono altre che verranno annunciate a breve! Con l'obiettivo di aiutare un maggior numero di organizzazioni incentrate sui viaggi a beneficiare di questa offerta, abbiamo scritto in dettaglio una serie di esempi per aiutare a spiegare come utilizzare l'API in diversi casi d'uso. Spero che queste spiegazioni vi aiutino ad avviare le vostre iniziative.

Requisiti di ingresso

Senza dubbio, le prime domande che un viaggiatore si pone sono "posso venire qui?" e "mi trovo a casa a mezzanotte?", per cui questo è un buon punto di partenza. Abbiamo creato un insieme di dati di Requisitos de Entrada per rispondere ai duri "sì/no" delle domande relative all'ingresso in un Paese o in una regione.

Al momento di redigere la presente informativa, questo insieme di dati comprende le 10 categorie distinte:

  • Può un residente entrare nel paese?
  • Può un straniero entrare nel paese?
  • È consentito il viaggio nel paese?
  • Si richiede un esame alla partenza (brodo dell'infezione)?
  • È possibile ottenere un certificato di prova (certificato di malattia)?
  • Richiede una visita di controllo (brote de enfermedad)? Si richiede una vaccinazione?
  • Si richiede un seguro?
  • È necessario un certificato di prova?
  • Si richiede un modulo di iscrizione? (salute o altro)

Ogni categoria può avere uno dei seguenti valori:

  • Sì, con eccezioni
  • No
  • No, con eccezioni

Anche se la maggior parte dei valori sono "sì" e "no", la situazione sul terreno non è sempre così semplice. A volte ci sono regole realmente extra- e locali che vari governi hanno messo in atto che richiedono i tipi di valori "con eccezioni".

Un requisito di ingresso è essenzialmente un registro che documenta un insieme di norme imposte da un agente contro uno o più Paesi o regioni. L'attore può essere un Paese, uno Stato o un Comune nella nostra architettura di dati. In generale, Sitata raccoglie i dati a livello di Paese nell'attualità. Tuttavia, sono presenti alcuni registri statali/provinciali per regioni selezionate come gli Stati Uniti e altre regioni.

Tutti i registri che hanno un'entrata sotto il campo paese_divisione_di_origine o paese_origine_regione_id è uno di livello statale o comunale, rispettivamente. Se si desidera disporre di ulteriori dati, si prega di contattare con noi e possiamo parlare del suo caso d'uso.

Per favore, prendete un po' di tempo per familiarizzare con la struttura dei dati dei requisiti di ingresso e date un'occhiata a i nostri documenti sull'API qui.

Una parte un po' confusa sulla struttura dei dati è l'uso del termine "dati"."origen" Questo è confuso, perché di solito i sostenitori dello sviluppo pensano che l'origine sia il luogo di origine o di partenza. Sin embargo, lo que queremos decir con origen es en realidad el origen de la regla impuesta a otros, es decir, el país o la región que ha creado la restricción.

Un altro punto importante da notare è il funzionamento dell'elenco dei Paesi interessati. Se affected_countries è vuoto, deve essere interpretato come una regola globale, cioè tutti i paesi sono interessati.

Alcuni esempi

Come si è visto nella documentazione, esistono diverse forme di recupero dei dati dell'API. Di seguito vengono presentati alcuni dei casi d'uso più comuni.

Come posso ottenere i requisiti tra due paesi?

Esistono diversi modi per presentare questo tipo di richiesta. La versione più semplice è quella di usare il destino y salida parámetros. Questi parametri accettano i codici ISO 3166-1 alfa-2 como entradas

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

La risposta includerà tutti i requisiti (a livello di Paese e di Stato) necessari per comprendere il viaggiatore in partenza dal Paese di partenza e in viaggio verso il Paese di destinazione.

Si desidera avere dati a livello nazionale?

Sitata dispone di dati a livello statale per alcune regioni. L'utente sa che un'entrata particolare è per uno stato se il división_país_original il campo ha un valore. È inoltre possibile filtrare per recuperare solo i dati relativi al livello di stato utilizzando il filtro división_país_destino parámetro. Espera un valore ISO_3166-2. Ad esempio, US-TX per Texas, Estados Unidos.

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

Si noti che sarebbe più semplice fare una consultazione per Paese e poi filtrare i dati degli Stati per verificare se esistono e, in caso affermativo, utilizzarli.

Come posso ottenere i requisiti tra due aeroporti?

Analogamente a quanto avviene per i paesi, l'API di Sitata può fornire risultati tra due aeroporti. I parametri aeroporto di salida y aeroporto di destino utilizzare i codici di la OACI o de la IATA per filtrare i risultati. La risposta includerà tutte le restrizioni (a livello di Paese e di Stato) necessarie per comprendere il viaggiatore che parte dal Paese di destinazione e viaggia verso il Paese di destinazione.

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

La risposta comprende tutte le restrizioni (a livello di Paese e di Stato) necessarie per comprendere il viaggiatore che parte dal Paese di destinazione e viaggia verso il Paese di destinazione.

E se ho solo informazioni sulla città?

Sitata ha deciso di non dare credito alle consultazioni di un nome di città in particolare perché ciò potrebbe dare origine a conflitti e confusioni. In questo caso, abbiamo scelto di impostare la consultazione della nostra API su coordinate di latitudine e di lunghezza, il che non produce alcuna ambiguità nel nostro insieme di risultati. I parametri sono partenza_lat, partenza_lng, destinazione_lat...y.. destinazione_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

Se si utilizzano le località e si consulta in base alle coordinate, la nostra API risponde con tutte le restrizioni (a livello di paese e di stato) necessarie per comprendere il viaggiatore che parte dal paese di destinazione e viaggia verso il paese di arrivo.

Dati aggiuntivi

Per alcuni tipi di requisiti di ingresso, è possibile che vi siano dati aggiuntivi associati in un campo di tipo di metadati denominato extra. Questo campo è una cartografia di base/valore con diverse informazioni aggiuntive per un requisito particolare.

Qual è il numero di giorni di settembre?

Questo inserimento di dati è soggetto al requisito di ingresso tipo 5. In questa entrata, il extra il mappa contiene un campo chiamato "campo". días_de_cuarentena che contiene un numero intero per il numero di giorni di dodici imposte.

Qual è il numero di ore prima dell'ingresso per un esame di coagulazione negativa?

Questo inserimento di dati è soggetto al requisito di ingresso tipo 8. In questa entrata, il extra il mappa contiene un campo chiamato "campo". ore_di_ingresso che contiene un numero di ore in cui è possibile effettuare una prova negativa prima dell'ingresso.

Sappiamo che

Crediamo di possedere una struttura molto robusta che probabilmente soddisfa tutte le esigenze per aiutare i viaggiatori a comprendere ciò che è probabile incontrare lungo il cammino. Se avete un caso d'uso particolare che non stiamo esaminando, per favore, fatelo sapere!

Espera... ¡hay más!

Questo articolo fa parte di una serie di due parti che spiegano come interagire con l'API di Sitata per i requisiti di ingresso e le informazioni sulle restrizioni di viaggio. Finora abbiamo parlato dei Requisitos de Entrada, che sono i requisiti più o meno severi necessari per l'ingresso in un Paese o in una regione, ma non abbiamo parlato di ciò che avviene all'interno del Paese. Una cosa è sapere come si entra in un paese, un'altra è capire se è possibile spostarsi nel paese o visitare le spiagge o se c'è una richiesta obbligatoria.

Tenetevi in sintonia per il secondo post che verrà inserito nel nostro conjunto di dati di Restricción de Viaje. Pista - è davvero idilliaco, per questo potete sempre dare un'occhiata alla nostra documentazione dell'API, ma anche.

Seguiteci e mettete "mi piace":

Articoli correlati

Un'anteprima dei Giochi Olimpici di Parigi 2024

Un'anteprima dei Giochi Olimpici di Parigi 2024

I Giochi della XXXIII Olimpiade, noti anche come Giochi Olimpici e Paralimpici estivi del 2024, si svolgeranno a Parigi, in Francia, dal 26 luglio all'11 agosto e dal 28 agosto all'8 settembre. I tornei si svolgeranno attraverso i luoghi simbolo di Parigi...

Le migliori applicazioni di sicurezza per viaggiatori, donne o bambini

Le migliori applicazioni di sicurezza per viaggiatori, donne o bambini

Prevenire è meglio che curare. Indipendentemente dal fatto che qualcosa vada storto, la preparazione è l'ancora di salvezza. Uscire ed esplorare il mondo da soli può essere scoraggiante ma inevitabile. Che si tratti di un appuntamento di gioco con il proprio figlio, di una gita in campeggio o di un viaggio in solitaria...