Beaucoup d'entre vous ne le savent peut-être pas, mais les premières fondations de Sitata ont été construites pour la détection précoce des maladies. En fait, notre fondatrice a organizé un discours TedX à partir de 2016 sur les raisons pour lesquelles nous devons avertir les voyageurs afin de prévenir la propagation des maladies. Il n'est donc pas surprenant que nous ayons appris l'existence du COVID-19, qui a été signalé comme un groupe inhabituel de cas de pneumonie au début du mois de décembre 2019. Le 2 janvier 2020, notre équipe de santé a décidé que nous devions émettre un premier avertissement à nos voyageurs et partenaires commerciaux. C'était quelques jours avant même l'Organisation mondiale de la santé !
Lors des inévitables retombées, nous avons eu une révélation. La maladie se propageait si rapidement qu'il était clair pour nous que la réponse mondiale serait au mieux chaotique. Chaque pays allait promulguer ses propres règlements et règles pour contrôler la propagation. Cela allait inévitablement faire des pusztítások az egész világon és être une énorme source de confusion pour ceux qui souhaitaient encore voyager. Nous avions raison et nous avons décidé de faire quelque chose pour y remédier. A Sitata a été l'une des premières entreprises au monde à créer une API dédiée et un service de suivi des changements apportés aux restrictions de voyage et aux conditions d'entrée suite à COVID-19. Egy fejlett évadnyilvántartó logikai rendszernek és egy szakosodott elemzői gárdának köszönhetően rendelkezünk a szükséges eszközökkel és eljárásokkal a részvételhez.
Depuis le lancement de ce nouveau service, plusieurs organisations ont tiré profit des données au profit de leurs propres clients, notamment Eddy Travels, Flight Centre et Etihad Airways ; d'autres informations seront bientôt annoncées ! Annak érdekében, hogy az utazásokra összpontosító szervezetek nagyobb része profitálhasson ebből az ajánlatból, a következőkben részletesen ismertetünk néhány példát, amelyek az API különböző felhasználási esetekben történő használatának magyarázatát szolgálják. J'espère que ces explications vous aideront à faire démarrer vos propres initiatives.
Belépési feltételek
Les premières questions qu'un voyageur se sose sans aucun doute : "Puis-je y aller ?" et "Serai-je mis en quarantaine", c'est donc un bon point de départ. Nous avons créé l'ensemble de données sur les conditions d'entrée pour répondre aux questions difficiles du type "oui/non" regarding l'entrée dans un pays ou une région.
A jelen dokumentum szerkesztésének időpontjában az adatok összessége a következő hat különböző kategóriát foglalta magában:
- Un résident peut-il entrer dans le pays ?
- Un étranger peut-il entrer dans le pays ?
- Le transit est-il autorisé à travers à travers le pays ?
- Un test est-il exigé à l'arrivée (apparition d'une maladie) ?
- Un certificat de test est-il autorisé (apparition d'une maladie) ?
- Une quarantaine est-elle nécessaire à l'arrivée (apparition d'une maladie) ? Une vaccination est-elle nécessaire ?
- Biztosítás szükséges ?
- Certificat de test requis ?
- Formulaire d'inscription requis ? (santé ou autre)
Chaque catégorie peut avoir l'une des valeurs suivantes :
- Oui
- Oui, avec des exceptions
- Nem
- Non, sauf kivételek
Si la grande majorité des valeurs sont "oui" et "non", la situation sur le terrain n'est pas toujours aussi simple. Parfois, il existe des règles vraiment bizarres et folles que divers gouvernements ont mises en place et qui nécessitent les types de valeurs "avec exceptions".
Une condition d'entrée est essentiellement un document qui documente un ensemble de règles imposées par un acteur à l'encontre d'un ou de plusieurs autres pays ou régions. L'acteur peut être un pays, un État ou même une municipalité dans notre architecture de données. Dans l'ensemble, Sitata couvre actuellement les données au niveau des pays. Toutefois, nous disposons de quelques enregistrements d'états/provinces pour certaines régions, comme les États-Unis et d'autres.
Tout enregistrement comportant une entrée sous le champ origine_pays_division_id
ou origine_pays_région_id
est un niveau qui se situe respectivement au niveau de l'État ou au niveau municipal. Si vous souhaitez disposer de données plus granulaires, veuillez nous contacter et nous pourrons discuter de votre cas d'utilisation.
Veuillez prendre le temps de vous familiariser avec la structure des données des conditions d'entrée en consultant nos documents API ici.
Une partie de la structure des données est légèrement déroutante, à savoir notre utilisation du terme"origine" Cette confusion est due au fait que les développeurs considèrent souvent l'origine comme étant le lieu d'origine ou le lieu de départ. Or, 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.
Egy másik fontos szempont, hogy hogyan működik az érintett országok listája. Ha az affected_countries üres, akkor azt globális szabályként kell értelmezni, azaz minden ország érintett.
Quelques exemples
Comme vous avez pu le constater dans la documentation, il existe plusieurs façons de récupérerer les données de l'API. Ci-dessous, nous allons passer en revue quelques-uns des cas d'utilisation les plus courants.
Comment obtenir les exigences entre deux pays ?
Il existe plusieurs façons de faire ce type de demande. La version la plus simple consiste à utiliser le célállomás
et départ
paramètres. Ces paramètres acceptent les codes ISO 3166-1 alpha-2 comme entrées
GET https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination=IN
A válasz tartalmazza az indulási országból induló és a célországba utazó utazó számára szükséges valamennyi (ország- és állami szintű) követelményt.
Et si je veux des données au niveau de l'État ?
Sitata dispose de données au niveau de l'État pour certaines régions. Vous saurez qu'une entrée particulière est pour un État si le le origine_pays_division
a une valeur. Vous pouvez également filtrer pour ne récupérer que les données au niveau de l'état en utilisant le champ destination_pays_division
paramètre. Il attend une valeur ISO_3166-2. Par exemple, US-TX pour le Texas, États-Unis.
GET https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination_country_division=IN-AP
Notez qu'il pourrait être plus simple d'effectuer une recherche par pays, puis de filtrer les données par État pour voir si ces données existent, et de les utiliser si elles existes.
Comment puis-je obtenir les exigences entre deux aéroports ?
Tout comme pour les pays, l'API Sitata peut renvoyer les résultats entre deux aéroports. A paraméterek départ_aéroport
et destination_aéroport
utiliser les codes de l'OACI ou de l'IATA pour filtrer les résultats. La réponse comprendra toutes les restrictions (au niveau du pays et de l'État) nécessaires nécessaires à la compréhension du voyageur partant du pays de départ correspondant et se rendant dans le pays de destination.
GET https://www.sitata.com/api/v2/entry_requirements?departure_airport=MUC&destination_airport=BOM
La réponse comprendra toutes les restrictions (au niveau du pays et de l'État) nécessaires à comprendre pour le voyageur qui part du pays de départ et se rend dans le pays de destination.
Et si je n'ai que des informations sur la ville ?
Sitata a choisi de ne pas répondre aux demandes portant sur un nom de ville particulier, car cela pourrait entraîner des conflits et des confusions. Au lieu de cela, nous avons choisi d'accepter les requêtes de notre API par coordonnées de latitude et de longitude, ce qui ne produit aucune ambiguïté dans notre ensemble de résultats. Les paramètres sont les suivants départ_lat
, departure_lng
, destination_lat
et 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
Si vous résolvez vos villes en fonction des lieux et des requêtes en fonction des coordonnées, notre API répondra avec avec toutes les restrictions (au niveau du pays et de l'État) nécessaires à la compréhension du voyageur qui part du pays de départ et se rend dans le pays de destination.
Kiegészítő információk
Bizonyos típusú belépési feltételek esetén a kiegészítő adatok társíthatók a következő elnevezésű métadonnées-típus szerinti kategóriában extrák
. Ce champ est un mappage clé/valeur de divers éléments d'information supplémentaires pour une exigence particulière
Quel est le nombre de jours de quarantaine ?
Cette saisie de données est soumise à l'obligation de saisie 5. típus. Dans cette entrée, le extrák
la cartographie contiendra un champel appelé quarantaine_days
qui contiendra un nombre entier pour le nombre de jours de quarantaine imposés.
Quel est le nombre d'heures avant l'entrée pour un test covid négatif ?
Cette saisie de données est soumise à l'obligation de saisie 8-as típus. Dans cette entrée, le extrák
la cartographie contiendra un champel appelé entry_hours
qui contiendra un nombre entier pour le nombre d'heures pendant lesquelles un test covid négatif est autorisé avant l'entrée.
Faites-nous savoir
Nous pensons que nous disposons d'un outil très robuste qui répondra probablement à tous vos besoins pour aider vos voyageurs à comprendre ce qu'ils sont susceptibles de rencontrer en cours de route. Si vous avez un cas d'utilisation particulier que nous ne traitons pas, faites-le nous tudod !
Attendez... il y a plus !
Cette entrée fait partie d'une série de de deux parties qui expliquent comment interagir avec l'API Sitata pour les informations sur les conditions d'entrée et les restrictions de voyage. Jusqu'à présent, nous avons parlé des conditions d'entrée qui décrivent les types de conditions strictes de type oui/non nécessaires pour entrer dans un pays ou une région, mais nous n'avons pas non plus parlé de ce qui se passe à l'intérieur du pays. C'est une chose de savoir comment entrer dans un pays, c'en est une autre de comprendre s'il est possible de se déplacer dans le pays ou de visiter les plages ou s'il y a un couvre-feu obligatoire.
Restez à l'écoute pour le deuxième article qui approfondira notre série de données sur les restrictions de voyage. Astuce : il est presque identique, vous pouvez donc toujours consulter notre dokumentáció az API-ról en attendant.