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

Scritto da Madeline Sharpe

2 ottobre 2020

Tecnologia

Molti di voi forse non lo sanno, ma le prime basi di Sitata sono state costruite per la diagnosi precoce delle malattie. Infatti, il nostro fondatore ha tenuto una conferenza TedX nel 2016 dedicata a Perché dobbiamo avvertire i viaggiatori per contribuire a prevenire la diffusione delle malattie. Non deve sorprendere quindi che abbiamo individuato la COVID-19 quando è stata segnalata come un insolito gruppo di casi di polmonite all'inizio di dicembre 2019. Entro il 2 gennaio 2020, il nostro team sanitario ha stabilito che avremmo dovuto emettere il nostro primo avvertimento ai nostri viaggiatori e partner commerciali. Questo avveniva giorni prima dell'Organizzazione Mondiale della Sanità!

Durante l'inevitabile fallout abbiamo avuto un'illuminazione. La malattia si stava diffondendo così velocemente che per noi era chiaro che la risposta globale sarebbe stata a dir poco caotica. Ogni Paese avrebbe emanato una propria serie di norme e regole per controllare la diffusione. Questo avrebbe inevitabilmente creato scompiglio nei viaggi globali e sarebbe stata un'enorme fonte di confusione per coloro che desideravano ancora viaggiare. Avevamo ragione e abbiamo deciso di fare qualcosa al riguardo. Sitata è stata una delle prime aziende al mondo a creare un'API dedicata e un servizio di monitoraggio per le modifiche alle restrizioni di viaggio e ai requisiti di ingresso a seguito della COVID-19. Grazie a un sistema software avanzato per il rilevamento degli eventi e a un team dedicato di analisti, disponevamo già di tutti gli strumenti e i processi giusti per farlo.

Da quando abbiamo lanciato questo nuovo servizio, diverse organizzazioni hanno sfruttato i dati a beneficio dei propri clienti, tra cui Eddy Travels, Flight Centre ed Etihad Airways, e presto ne verranno annunciate altre! Per aiutare un maggior numero di organizzazioni che si occupano di viaggi a trarre vantaggio da questa offerta, abbiamo scritto in dettaglio una serie di esempi per spiegare come utilizzare l'API per una serie di casi d'uso. Spero che queste spiegazioni vi aiutino a far decollare le vostre iniziative.

Requisiti di ingresso

Senza dubbio, le prime domande che un viaggiatore si pone sono "posso andarci?" e "sarò messo in quarantena", quindi questo è un buon punto di partenza. Abbiamo creato il set di dati Requisiti di ingresso per rispondere alle domande più difficili, del tipo "sì/no", relative all'ingresso in un Paese o in una regione.

Al momento della stesura del presente documento, questo set di dati comprendeva le seguenti 10 categorie distinte:

  • Un residente può entrare nel paese?
  • Uno straniero può entrare nel paese?
  • Il transito nel Paese è consentito?
  • È richiesto un test all'arrivo (focolaio di malattia)?
  • È consentito un certificato di prova (focolaio di malattia)?
  • È richiesta la quarantena all'arrivo (epidemia)? È richiesta una vaccinazione?
  • È necessaria un'assicurazione?
  • È necessario un certificato di prova?
  • È richiesto un modulo di iscrizione (sanitario o altro)

Ogni categoria può avere uno dei seguenti valori:

  • Sì, con alcune eccezioni
  • No
  • No, salvo eccezioni

Sebbene la stragrande maggioranza dei valori sia "sì" e "no", la situazione sul campo non è sempre così semplice. A volte ci sono regole davvero strane e folli che i vari governi hanno messo in atto e che richiedono i tipi di valore "con eccezioni".

Un requisito di ingresso è essenzialmente un record che documenta un insieme di regole imposte da un attore nei confronti di uno o più altri Paesi o regioni. Nella nostra architettura di dati, l'attore può essere un Paese, uno Stato o persino un Comune. In linea di massima, Sitata copre attualmente i dati a livello nazionale. Tuttavia, disponiamo di alcuni record statali/provinciali per regioni selezionate, come gli Stati Uniti e altre.

Ogni record che ha una voce nel campo paese_divisione_di_origine o paese_origine_regione_id è un dato a livello statale o comunale, rispettivamente. Se si desidera avere a disposizione dati più granulari, si prega di contattateci e possiamo parlare del vostro caso d'uso.

Prendete un po' di tempo per familiarizzare con la struttura dei dati dei Requisiti di iscrizione. dare un'occhiata ai nostri documenti API qui.

Una parte un po' confusa della struttura dei dati è l'uso del termine "origine." Questo è fonte di confusione perché spesso gli sviluppatori pensano all'origine come al luogo di provenienza o di partenza. Tuttavia, ciò che intendiamo per origine è in realtà l'origine della regola imposta agli altri, ovvero il Paese o la regione che ha creato la restrizione.

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 può notare dalla documentazione, esistono diversi modi per recuperare i dati dall'API. Di seguito illustreremo alcuni dei casi d'uso più comuni.

Come si recuperano i requisiti tra due paesi?

Esistono due modi per effettuare questo tipo di richiesta. La versione più semplice consiste nell'utilizzare il metodo destinazione e partenza parametri. Questi parametri accettano ISO 3166-1 alpha-2 come input.

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.

E se volessi dei dati a livello statale?

Sitata dispone di dati a livello statale per alcune regioni. Si sa che una particolare voce si riferisce a uno Stato se la dicitura divisione_paese_di_origine ha un valore. È anche possibile filtrare per recuperare solo i dati a livello di stato utilizzando il parametro destinazione_paese_divisione parametro. Si aspetta un parametro ISO_3166-2 valore. Ad esempio, US-TX per Texas, Stati Uniti.

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

Si noti che potrebbe essere più semplice eseguire una query per paese e poi filtrare i dati per stato per vedere se tali dati esistono e usarli se esistono.

Come si recuperano i requisiti tra due aeroporti?

Come per i Paesi, l'API Sitata può restituire risultati tra due aeroporti. I parametri aeroporto_di_partenza e aeroporto_di_destinazione utilizzare ICAO o IATA per filtrare i risultati. La risposta includerà tutte le restrizioni (a livello di Paese e di Stato) necessarie per comprendere il viaggiatore in partenza dal Paese di partenza corrispondente e in viaggio verso il Paese di destinazione.

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

La risposta includerà tutte le restrizioni (a livello di Paese e di Stato) necessarie per comprendere il viaggiatore in partenza dal Paese di partenza e in viaggio verso il Paese di destinazione.

E se ho solo informazioni sulla città?

Sitata ha scelto di non accettare interrogazioni in base al nome di una particolare città, perché ciò potrebbe generare conflitti e confusione. Invece, abbiamo scelto di utilizzare la nostra API per le coordinate di latitudine e longitudine, che non producono alcuna ambiguità nel nostro set di risultati. I parametri sono partenza_lat, partenza_lng, destinazione_lat, e 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 le città vengono trasformate in località e si effettua una query basata sulle coordinate, la nostra API risponderà con tutte le restrizioni (a livello di paese e di stato) necessarie per comprendere il viaggiatore in partenza dal paese di partenza e in viaggio verso il paese di destinazione.

Dati extra

Per alcuni tipi di Requisiti di ingresso, possono essere presenti dati aggiuntivi associati in un campo di tipo metadati chiamato extra. Questo campo è una mappatura chiave/valore di varie informazioni aggiuntive per un particolare requisito.

Qual è il numero di giorni di quarantena?

Questo inserimento di dati rientra nel requisito di ingresso tipo 5. In questa voce, il extra La mappatura conterrà un campo chiamato giorni_di_quarantena che conterrà un numero intero per il numero di giorni di quarantena imposti.

Qual è il numero di ore prima dell'ingresso per un test covid negativo?

Questo inserimento di dati rientra nel requisito di ingresso tipo 8. In questa voce, il extra La mappatura conterrà un campo chiamato ore_di_ingresso che conterrà un numero intero per il numero di ore in cui è consentito un test covid negativo prima dell'ingresso.

Fateci sapere

Pensiamo di avere una soluzione molto solida che probabilmente risponderà a tutte le vostre esigenze per aiutare i vostri viaggiatori a capire cosa potrebbero incontrare lungo il percorso. Se avete un caso d'uso particolare che non stiamo affrontando, fateci sapere!

Aspettate... c'è di più!

Questo articolo fa parte di una serie di due parti che spiegano come interagire con l'API Sitata per ottenere informazioni sui requisiti di ingresso e sulle restrizioni di viaggio. Finora abbiamo parlato dei requisiti di ingresso, che delineano i requisiti di tipo sì/no necessari per entrare in un Paese o in una regione, ma non abbiamo parlato di ciò che accade all'interno del Paese. Una cosa è sapere come entrare in un Paese, un'altra è capire se è possibile muoversi nel Paese o visitare le spiagge o se c'è un coprifuoco obbligatorio.

Rimanete sintonizzati per il secondo post che approfondirà il nostro set di dati sulle restrizioni di viaggio. Un suggerimento: è quasi identico, quindi potete sempre dare un'occhiata al nostro Documentazione API nel frattempo.

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...