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

Molti di voi forse non lo sanno, ma le prime fondamenta di Sitata furono costruite per il rilevamento precoce delle malattie. Infatti, il nostro fondatore ha un discorso TedX del 2016 su perché dobbiamo avvertire i viaggiatori per aiutare a prevenire la diffusione delle malattie. Non dovrebbe quindi sorprendere che siamo venuti a conoscenza del COVID-19 quando fu segnalato un insolito cluster di casi di polmonite all’inizio di dicembre 2019. Il 2 gennaio 2020, il nostro team sanitario determinò che dovevamo emettere il nostro primo avviso ai nostri viaggiatori e partner commerciali. Questo avvenne giorni prima persino dell’Organizzazione Mondiale della Sanità!

Durante l’inevitabile ricaduta radioattiva, abbiamo avuto un’epifania. La malattia si stava diffondendo così rapidamente che era chiaro che la risposta globale sarebbe stata caotica nel migliore dei casi. Ogni paese avrebbe emanato il proprio insieme di regolamenti e regole per controllare la diffusione. Ciò avrebbe inevitabilmente causato scompiglio nei viaggi globali e sarebbe stata un’enorme fonte di confusione per coloro che desideravano ancora viaggiare. Avevamo ragione e ci siamo impegnati a fare qualcosa al riguardo. Sitata è stata una delle prime aziende al mondo a creare un’API dedicata e un servizio di monitoraggio per i cambiamenti nelle restrizioni di viaggio e nei requisiti d’ingresso a causa del COVID-19. Con un sistema software avanzato per il rilevamento di eventi e un team dedicato di analisti, avevamo già tutti gli strumenti e i processi giusti per farlo.

Dal lancio di questo nuovo servizio, abbiamo avuto una varietà di organizzazioni che sfruttano i dati a beneficio dei propri clienti, tra cui Eddy Travels, Flight Centre ed Etihad Airways; e ce ne sono altre che saranno annunciate presto! Per aiutare più organizzazioni focalizzate sui viaggi a beneficiare di questa offerta, abbiamo scritto in dettaglio di seguito una serie di esempi per aiutare a spiegare come utilizzare l’API per una varietà di casi d’uso. Spero che queste spiegazioni ti aiutino a far partire le tue iniziative.

Requisiti d’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 dei Requisiti d’Ingresso per rispondere ai duri “sì/no” delle domande relative all’ingresso in un paese o regione.

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

• Un residente può entrare nel paese?
• Uno straniero può entrare nel paese?
• È consentito il transito attraverso il paese?
• È richiesto un test all’arrivo (epidemia di malattia)?
• È consentito un certificato di test (epidemia di una malattia)?
• È richiesta una quarantena all’arrivo (epidemia di malattia)? È richiesto un vaccino?
• È richiesta un’assicurazione?
• È richiesto un certificato di test?
• È richiesto un modulo di registrazione? (salute o altro)

Ogni categoria può avere uno dei seguenti valori:

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

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

Un requisito d’ingresso è essenzialmente un record che documenta un insieme di norme imposte da un attore contro uno o più paesi o regioni. L’attore potrebbe essere un paese, uno stato o persino un comune nella nostra architettura dati. In generale, Sitata copre i dati a livello nazionale al momento. Tuttavia, abbiamo alcuni record statali/provinciali per regioni selezionate come gli Stati Uniti e altri.

Qualsiasi record che abbia una voce nel campo **origin_country_division_id** o **origin_country_region_id** è uno a livello statale o comunale, rispettivamente. Se desideri avere dati più granulari, per favore contattaci e possiamo discutere il tuo caso d’uso.

Prenditi un momento per familiarizzare con la struttura dei dati dei requisiti d’ingresso dando un’occhiata alla nostra documentazione API qui.

Una parte un po’ confusa della struttura dei dati è il nostro uso del termine “origine”. Questo è confuso perché spesso gli sviluppatori pensano che l’origine sia il luogo di origine o di partenza. Tuttavia, ciò che intendiamo con origine è in realtà l’origine della regola imposta ad altri, cioè il paese o la regione che ha creato la restrizione.

Un altro punto importante da notare è come funziona la nostra lista dei paesi interessati. Se affected_countries è vuoto, dovrebbe essere interpretato come una regola globale. Cioè, tutti i paesi sono interessati.

Alcuni esempi

Come avrai visto nella documentazione, ci sono diversi modi per recuperare dati dall’API. Di seguito esamineremo alcuni dei casi d’uso più comuni.

Come posso ottenere i requisiti tra due paesi?

Ci sono un paio di modi per fare questo tipo di richiesta. La versione più semplice è usare i parametri **destinazione** e **partenza**. Questi parametri accettano codici ISO 3166-1 alfa-2 come input.

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

La risposta includerà tutti i requisiti (a livello nazionale e statale) necessari da comprendere per il viaggiatore che parte dal paese di partenza e viaggia verso il paese di destinazione.

E se voglio dati a livello statale?

Sitata ha dati a livello statale per certe regioni. Saprai che una voce particolare è per uno stato se il campo origin_country_division_id ha un valore. Puoi anche filtrare per recuperare solo i dati a livello statale usando il parametro **destination_country_division**. Si aspetta un valore ISO_3166-2. Ad esempio, US-TX per il Texas, USA.

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

Nota che potrebbe essere più semplice fare una query per paese e poi filtrare per i dati degli stati per vedere se quei dati esistono, e usarli se esistono.

Come posso ottenere i requisiti tra due aeroporti?

Proprio come per i paesi, l’API di Sitata può restituire risultati tra due aeroporti. I parametri departure_airport e destination_airport utilizzano i codici ICAO o IATA per filtrare i risultati. La risposta includerà tutte le restrizioni (a livello nazionale e statale) necessarie da comprendere per il viaggiatore che parte dal corrispondente paese di partenza e viaggia 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 nazionale e statale) necessarie da comprendere per il viaggiatore che parte dal paese di partenza e viaggia verso il paese di destinazione.

E se ho solo informazioni sulla città?

Sitata ha scelto di non accogliere query per un particolare nome di città perché ciò potrebbe portare a conflitti e confusione. Invece, abbiamo scelto di accogliere la query alla nostra API tramite coordinate di latitudine e longitudine, il che non produce alcuna ambiguità nel nostro set di risultati. I parametri sono departure_lat, departure_lng, destination_lat e destination_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 risolvi le tue città in posizioni e interroghi in base alle coordinate, la nostra API risponderà con tutte le restrizioni (a livello nazionale e statale) necessarie da comprendere per il viaggiatore che parte dal paese di partenza e viaggia verso il paese di destinazione.

Dati aggiuntivi

Per alcuni tipi di requisiti d’ingresso, potrebbero esserci dati aggiuntivi associati in un campo di tipo metadati chiamato extras. Questo campo è una mappatura chiave/valore di vari bit extra di informazione per un requisito particolare.

Qual è il numero di giorni di quarantena?

Questa voce di dati è soggetta al requisito d’ingresso tipo 5. In questa voce, la mappatura **extras** conterrà un campo chiamato quarantine_days 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?

Questa voce di dati è soggetta al requisito d’ingresso tipo 8. In questa voce, la mappatura **extras** conterrà un campo chiamato entry_hours che conterrà un numero intero per il numero di ore entro cui è consentito un test covid negativo prima dell’ingresso.

Facci sapere

Crediamo di avere un’API molto robusta che probabilmente soddisfa tutte le tue esigenze per aiutare i tuoi viaggiatori a capire cosa è probabile che incontrino lungo il percorso. Se hai un caso d’uso particolare che non stiamo affrontando, per favore faccelo sapere!

Aspetta… c’è di più!

Questo post fa parte di una serie in due parti che spiega come interagire con l’API di Sitata per i requisiti d’ingresso e le informazioni sulle restrizioni di viaggio. Finora abbiamo parlato dei Requisiti d’Ingresso che delineano i duri tipi di requisiti sì/no necessari per entrare in un paese o regione, ma non abbiamo ancora parlato di cosa succede all’interno del paese. Una cosa è sapere dell’ingresso in un paese, e un’altra è capire se è possibile spostarsi nel paese o visitare le spiagge o se c’è un coprifuoco obbligatorio.

Resta sintonizzato per il secondo post che approfondirà il nostro set di dati sulle Restrizioni di Viaggio. Suggerimento - è quasi identico, quindi puoi sempre dare un’occhiata alla nostra documentazione API nel frattempo.