Wiele osób nie wie o tym, ale pierwsze fundacje Sitata zostały stworzone w celu wczesnego wykrywania chorób. W związku z tym, nasza założycielka zorganizowała w 2016 roku konferencję TedX na temat 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 pierwsze ostrzeżenie dla naszych podróżnych i partnerów handlowych. C'était quelques jours avant même l'Organisation mondiale de la santé !

Podczas inévitables retombées, nous avons eu une révélation. Choroba rozprzestrzeniała się tak szybko, że było dla nas jasne, iż reakcja światowa będzie jeszcze bardziej chaotyczna. Każde państwo mogło wprowadzić swoje własne przepisy i zasady kontroli rozprzestrzeniania się choroby. Cela allait inévitablement faire des ravages dans le monde entier et être une énorme source de confusion pour ceux qui souhaitaient encore voyager. Mamy jednak rację i postanowiliśmy zrobić coś, co pozwoli nam to zmienić. Sitata była jednym z pierwszych przedsiębiorstw na świecie, które stworzyło dedykowane API i usługę śledzenia zmian wprowadzonych w ograniczeniach podróży i warunkach wejścia w ramach COVID-19. Dzięki zaawansowanemu systemowi logistycznemu rejestracji zdarzeń oraz wyspecjalizowanemu zespołowi analityków, dysponujemy wszystkimi niezbędnymi narzędziami i procesami.

Od momentu uruchomienia tej nowej usługi, wiele organizacji czerpie zyski z tych danych dla swoich klientów, w tym Eddy Travels, Flight Centre i Etihad Airways; inne informacje zostaną ogłoszone wkrótce! Aby pomóc większej liczbie organizacji zajmujących się podróżami w skorzystaniu z tej oferty, przedstawiliśmy poniżej kilka przykładów wyjaśniających, jak korzystać z API w różnych przypadkach. Liczymy na to, że te wyjaśnienia pomogą Ci rozwinąć Twoje własne inicjatywy.

Conditions d'entrée

Les premières questions qu'un voyageur se pose sont 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 difficile du type "oui/non" concernant l'entrée dans un pays ou une région.

Au moment de la rédaction du présent document, cet ensemble de données comprenait les dix catégories distinctes suivantes :

• Un résident peut-il entrer dans le pays ?
• Un étranger peut-il entrer dans le pays ?
• Czy tranzyt jest dozwolony na terenie całego kraju?
• Czy wymagane jest badanie po przybyciu (pojawieniu się) choroby?
• Un certificat de test est-il autorisé (apparition d'une maladie) ?
• Czy po przybyciu (pojawieniu się choroby) konieczne jest przeprowadzenie badania lekarskiego? Czy szczepienie jest konieczne?
• Wymagana pewność?
• Wymagany certyfikat z testu?
• Potrzebny formularz zapisu? (santé ou autre)

Chaque catégorie peut avoir l'une des valeurs suivantes :

• Oui
• Oui, avec des exceptions
• Nie
• Non, sauf exceptions

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"

Warunek wejścia to przede wszystkim dokument, który dokumentuje zespół przepisów narzuconych przez podmiot w stosunku do jednego lub kilku innych państw lub regionów. L'acteur peut être un pays, un État ou même une municipalité dans notre architecture de données. W sumie Sitata obejmuje obecnie dane na poziomie państw. Jednak dysponujemy kilkoma rejestrami państw/prowincji dla niektórych regionów, takich jak Stany Zjednoczone i inne.

Wszystkie rejestracje zawierające wejście pod klawiaturą identyfikator_początkowy_płatności_działu ou originine_pays_région_id to poziom, który znajduje się odpowiednio na poziomie państwa lub gminy. Jeśli chcesz dysponować danymi o większym rozmiarze, poproś o skontaktować się z nami i nie możemy dyskutować o przypadku użycia.

Należy poświęcić trochę czasu na zapoznanie się ze strukturą danych dotyczących warunków przystąpienia do konsultanta. nasze dokumenty API są tutaj.

Pewna część struktury danych jest bardzo skomplikowana, jak na przykład użycie terminu"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. Albo, to co rozumiemy pod pojęciem "pochodzenie", jest w rzeczywistości pochodzeniem przepisu narzuconego innym, tj. państwu lub regionowi, który stworzył ograniczenie.

Innym ważnym punktem, na który należy zwrócić uwagę jest to, jak działa nasza lista dotkniętych krajów. Jeśli affected_countries jest pusta, należy ją interpretować jako regułę globalną, tzn. wszystkie kraje są dotknięte.

Quelques exemples

Jak zauważyłeś w dokumentacji, istnieje wiele sposobów na odzyskanie danych z API. Poniżej przedstawiamy kilka najbardziej aktualnych przypadków użycia.

Comment obtenir les exigences entre deux pays ?

Istnieje kilka sposobów na złożenie tego typu żądania. Najprostsza z nich polega na użyciu przycisku miejsce przeznaczenia et départ paramètres. Te parametry akceptują kody ISO 3166-1 alfa-2 comme entrées

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

Odpowiedź będzie zawierać wszystkie wymagania (na poziomie kraju i państwa) niezbędne do zrozumienia dla podróżnego wyjeżdżającego z kraju wyjazdu i podróżującego do kraju docelowego.

Et si je veux des données au niveau de l'État?

Sitata posiada dane na poziomie państwa dla niektórych regionów. Możesz być pewny, że dany wpis dotyczy jednego państwa, jeśli źródło_płatności_dział a une valeur. Można również filtrować dane, aby nie odzyskiwać ich tylko na poziomie stanu, używając karty miejsce przeznaczenia_płatności_podział 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

Zwróć uwagę, że może to być prostsze niż przeprowadzenie badania według kraju, a następnie przefiltrowanie danych według państwa w celu sprawdzenia, czy dane te istnieją, i wykorzystania ich, jeśli istnieją.

Comment puis-je obtenir les exigences entre deux aéroports ?

Podobnie jak w przypadku państw, API Sitata może przekazywać wyniki pomiędzy dwoma portami lotniczymi. Parametry départ_aéroport et miejsce przeznaczenia_aéroport utiliser les codes de l'OACI ou de l'IATA pour filtre les résultats. Odpowiedź obejmuje wszystkie ograniczenia (na poziomie państwa i kraju) niezbędne do zrozumienia przez podróżnego opuszczającego państwo pochodzenia i przebywającego w państwie przeznaczenia.

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

Odpowiedź obejmuje wszystkie ograniczenia (na poziomie państwa i kraju), które należy uwzględnić w przypadku podróżnego, który opuszcza kraj wyjazdu i udaje się do kraju przeznaczenia.

Et si je n'ai que des informations sur la ville?

Sitata zdecydowała się nie odpowiadać na żądania dotyczące konkretnego miasta, ponieważ może to prowadzić do konfliktów i pomyłek. Zamiast tego zdecydowaliśmy się przyjąć zapytania z naszego API w postaci współrzędnych szerokości i długości geograficznej, co nie powoduje żadnych niejasności w naszym zestawie wyników. Parametry są następujące départ_lat, odlot_lng, miejsce przeznaczenia_latet cel_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

Jeśli rozwiążesz pola w oparciu o lokalizacje i żądania w oparciu o współrzędne, nasze API odpowie na wszystkie ograniczenia (na poziomie kraju i państwa) niezbędne do zrozumienia podróżnego, który opuszcza kraj wyjazdu i udaje się do kraju przeznaczenia.

Informacje uzupełniające

Pour certains types de conditions d'entrée, il peut y avoir des données supplémentaires associées dans un champ de type de métadonnées appelé dodatki. Mistrz jest mapą kolorów/wartości różnych elementów informacji uzupełniających dla szczególnych wymagań.

Quel est le nombre de jours de quarantaine ?

Badanie danych podlega obowiązkowi badania. typ 5. Dans cette entrée, le dodatki 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 ?

Badanie danych podlega obowiązkowi badania. typ 8. Dans cette entrée, le dodatki la cartographie contiendra un champel appelé wejście_godzin 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

Uważamy, że dysponujemy solidnym narzędziem, które z pewnością zaspokoi wszystkie potrzeby podróżników, pozwalając im zrozumieć, co mogą napotkać na swojej drodze. Jeśli masz jakiś szczególny przypadek użycia, którego nie opisujemy, powiedz nam, że savoir !

Attendez... il y a plus!

To wejście jest częścią serii dwóch stron, które wyjaśniają, jak korzystać z API Sitata w celu uzyskania informacji o warunkach wjazdu i ograniczeniach podróży. Do tej pory mówiliśmy o warunkach wjazdu, które opisują rodzaje rygorystycznych warunków typu tak/nie, niezbędnych do wjazdu do kraju lub regionu, ale nie mówiliśmy jeszcze o tym, co dzieje się wewnątrz kraju. 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.

Zapraszamy do drugiego artykułu, w którym przedstawimy informacje na temat ograniczeń w podróżowaniu. Uwaga: to jest prawie identyczne, vous pouvez donc toujours consulter notre dokumentacja na temat API en attendant.

Prosimy o śledzenie i polubienie nas: