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 voi non lo sanno, ma le prime fondazioni di Sitata sono state costruite per la cura preventiva delle malattie. In effetti, la nostra fondatrice ha organizzato un discorso TedX a partire dal 2016 sulle malattie. ragioni per le quali dobbiamo evitare i viaggi per prevenire la propagazione delle malattie. Non è quindi sorprendente che abbiamo appreso l'esistenza del COVID-19, che è stato segnalato come un gruppo abitativo di casi di polmonite all'inizio del mese di dicembre 2019. Il 2 gennaio 2020, la nostra équipe sanitaria ha deciso che dobbiamo inviare un il primo avvertimento ai nostri viaggiatori e partner commerciali. C'era qualche giorno prima dell'Organizzazione mondiale della sanità!

In occasione delle inimitabili ritombazioni, abbiamo avuto una rivelazione. La malattia si diffondeva così rapidamente che era chiaro che la risposta mondiale sarebbe stata più caotica. Ogni paese doveva promulgare le proprie norme e regole per controllare la propagazione. Ciò avrebbe causato inevitabilmente delle devastazioni nel mondo intero e sarebbe stato un'enorme fonte di confusione per coloro che volevano continuare a viaggiare. Abbiamo una ragione e abbiamo deciso di fare qualcosa per rimediare. Sitata è stata la prima impresa al mondo a creare un'API dedicata e un servizio di monitoraggio delle modifiche apportate alle restrizioni di viaggio e alle condizioni di ingresso in base alla COVID-19. Grazie a un sistema logico di rilevamento degli eventi all'avanguardia e a un'équipe di analisti specializzati, disponiamo già di tutti gli strumenti e i processi necessari per partecipare.

Dopo la messa in funzione di questo nuovo servizio, diverse organizzazioni hanno tratto profitto dai dati a vantaggio dei loro clienti, tra cui Eddy Travels, Flight Centre ed Etihad Airways; altre informazioni saranno rese note a breve! Per aiutare un numero maggiore di organizzazioni che si occupano di viaggi a trarre profitto da questa offerta, abbiamo riportato in dettaglio qui di seguito un certo numero di esempi per spiegare come utilizzare l'API in diversi casi di utilizzo. Sono certo che queste spiegazioni vi aiuteranno a mettere a punto le vostre iniziative.

Condizioni d'ingresso

Le prime domande che un viaggiatore si pone sono senza dubbio: "Puis-je y aller?" e "Serai-je mis en quarantaine", quindi un buon punto di partenza. Abbiamo creato un insieme di dati sulle condizioni di ingresso per rispondere alle domande difficili del tipo "oui/non" riguardanti l'ingresso in un paese o in una regione.

Al momento della stesura del presente documento, questo insieme di dati comprendeva sei categorie distinte di dati:

  • Un residente può entrare nel paese?
  • Un straniero può entrare nel paese?
  • Il transito è autorizzato in tutto il paese?
  • Un test è necessario all'arrivo (comparsa di una malattia)?
  • Un certificat de test est-il autorisé (apparition d'une maladie)?
  • Une quarantaine est-elle nécessaire à l'arrivée (apparition d'une maladie)? Una vaccinazione è necessaria?
  • Assicurazione necessaria?
  • Certificato di prova richiesto?
  • Formula d'iscrizione richiesta? (santé ou autre)

Ogni categoria può avere uno dei seguenti valori:

  • Oui
  • Oui, con alcune eccezioni
  • Non
  • Non, salvo eccezioni

Se la grande maggioranza dei valori è "oui" e "non", la situazione sul terreno non è sempre così semplice. In alcuni casi, infatti, esistono regole molto bizzarre e successive che diversi governi hanno messo in atto e che richiedono tipi di valori "con eccezioni".

Una condition d'entrée è essenzialmente un documento che documenta un insieme di regole imposte da un attore all'interno di uno o più altri Paesi o regioni. L'attore può essere un Paese, uno Stato o anche una municipalità nella nostra architettura di dati. Nell'insieme, Sitata copre attualmente le donazioni al livello dei Paesi. Tuttavia, disponiamo di alcune registrazioni di Stati/province per alcune regioni, come gli Stati Uniti e altre regioni.

Tutte le registrazioni che comportano un'entrata sotto il campione origine_pagamenti_divisione o origine_pagamenti_région_id è un livello che si colloca rispettivamente al livello dello Stato o al livello comunale. Se si desidera disporre di dati più consistenti, si consiglia di contattateci e noi possiamo discutere del vostro caso d'uso.

Prendete il tempo necessario per familiarizzare con la struttura dei dati delle condizioni d'ingresso nel sistema di consulenza. nos documents API ici.

Una parte della struttura delle donazioni è molto complessa, come dimostra il nostro uso del termine"origine" Questa confusione è dovuta al fatto che gli sviluppatori considerano spesso l'origine come il luogo di origine o il luogo di partenza. Oppure, ce que nous entendons par "origine" est en fait l'origine de la règle imposée à d'autres, c'est-à-dire le pays ou la région qui a créé la restriction.

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 avete potuto constatare nella documentazione, esistono diverse modalità di recupero dei dati dell'API. In questa sede, esaminiamo alcuni dei casi di utilizzo più ricorrenti.

Come ottenere le esigenze tra i due paesi?

Esistono diverse modalità per effettuare questo tipo di richiesta. La versione più semplice consiste nell'utilizzare le destinazione e partenza parametri. I parametri accettano i codici ISO 3166-1 alpha-2 come entrate

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 di Stato?

Sitata dispone di dati a livello di Stato per alcune regioni. Si è sicuri che un'entrata particolare è per uno Stato se le origine_pagamenti_divisione un valore. È inoltre possibile filtrare per non recuperare solo i dati al livello dello stato utilizzando il campione destinazione_paga_divisione parametro. Il valore è presente ISO_3166-2. Ad esempio, US-TX per il 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 effettuare una ricerca per Paese, poi filtrare i dati per Stato per vedere se esistono e utilizzarli.

Come si possono ottenere le esigenze tra due aeroporti?

Come per i paesi, l'API Sitata può rinviare i risultati tra due aeroporti. I parametri partenza_aeroporto e destinazione_aeroporto utilizzare i codici dell'OACI o de l'IATA per filtrare i risultati. La risposta comprende tutte le restrizioni (a livello di Paese e di Stato) necessarie alla comprensione del viaggiatore che parte dal Paese di partenza e arriva nel 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) che è necessario comprendere per il viaggiatore che parte dal Paese di partenza e arriva in quello di destinazione.

E se non avessi che informazioni sulla città?

Sitata ha scelto di non rispondere alle richieste relative a un nome di città particolare, in quanto ciò potrebbe generare conflitti e confusioni. Al posto di ciò, abbiamo scelto di accettare le richieste della nostra API tramite coordinate di latitudine e longitudine, il che non produce alcuna ambiguità nel nostro insieme di risultati. I parametri sono i seguenti départ_lat, partenza_lng, destinazione_late 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 risolvete i vostri villaggi in base ai luoghi e le richieste in base alle coordinate, la nostra API risponde con tutte le restrizioni (a livello di Paese e di Stato) necessarie alla comprensione del viaggiatore che parte dal Paese di partenza e arriva nel Paese di destinazione.

Informazioni supplementari

Per alcuni tipi di condizioni di ingresso, è possibile disporre di dati supplementari associati a un campione di tipo di métadonnées denominato "tipo". extra. Il campione è una mappatura cliché/valore di diversi elementi di informazione supplementari per un'esigenza particolare.

Qual è il numero di giorni di quarantena?

Questa verifica dei dati è soggetta all'obbligo di verifica. tipo 5. In questa sezione, le extra la cartografia contiene un campione chiamato "champ". quarantaine_giorni che contiene un numero intero per il numero di giorni di quarantena imposti.

Qual è il numero di ore prima dell'ingresso per un test covid négatif?

Questa verifica dei dati è soggetta all'obbligo di verifica. tipo 8. In questa sezione, le extra la cartografia contiene un campione chiamato "champ". ore_di_ingresso che contiene un numero intero per il numero di ore durante le quali è possibile effettuare un test covid négatif prima dell'ingresso.

Ci conosciamo meglio

Pensiamo di avere a disposizione uno strumento molto robusto che risponde probabilmente a tutte le vostre esigenze per aiutare i vostri viaggiatori a comprendere ciò che sono suscettibili di incontrare durante il viaggio. Se avete un caso di utilizzo particolare che non trattiamo, fatelo a noi. savoir !

Attendez... il y a plus!

Questa voce fa parte di una serie di due parti che spiegano come interagire con l'API Sitata per ottenere informazioni sulle condizioni di ingresso e sulle restrizioni di viaggio. Finora abbiamo parlato delle condizioni di ingresso che descrivono i tipi di condizioni rigorose di tipo oui/non nécessaires per entrare in un paese o in una regione, ma non abbiamo mai parlato di ciò che avviene all'interno del paese. Una cosa è sapere come si entra in un paese, un'altra è capire se è possibile trasferirsi nel paese o visitare le spiagge o se c'è un soggiorno obbligato.

Restate in attesa del secondo articolo che approfondisce la nostra serie di dati sulle restrizioni di viaggio. Astuce: è quasi identico, potete sempre consultare il nostro sito documentazione sull'API en attendant.

Seguiteci e mettete "mi piace":

Articoli correlati

To Paris! Transportation Guide to Reach Paris during the Olympics

To Paris! Transportation Guide to Reach Paris during the Olympics

Did you check the transport situation of Paris during the Olympics? Have you decided how you’re going to reach the venue? If not, Let us help you! The City of Lights is hosting the most prestigious sporting event in the world - the Olympics. Securing accommodation...

From Metro to Marathon: Transportation Tips for The Paris Olympics

From Metro to Marathon: Transportation Tips for The Paris Olympics

Millions of people are expected to visit Paris for the 2024 Summer Olympic and Paralympic Games from 26 July to 11 August and 28 August to 8 September. Are you also gearing up to witness the games this year and looking for a perfect travel guide? Consider it done,...