Większość z nas nie wie, że pierwsze fundacje Sitata zostały stworzone w celu ochrony przed chorobami. Nasza założycielka zorganizowała w 2016 roku wykład TedX na temat powody, dla których powinniśmy unikać podróżowania, aby zapobiec rozprzestrzenianiu się chorób. Nie jest zaskoczeniem, że dowiedzieliśmy się o istnieniu COVID-19, który na początku miesiąca grudnia 2019 r. został zasygnalizowany jako grupa mieszkańców z przypadkami zapalenia płuc. W dniu 2 stycznia 2020 r. nasz zespół ds. zdrowia podjął decyzję, że będziemy musieli opublikować Pierwsze ostrzeżenie dla naszych podróżników i partnerów handlowych. C'était quelques jours avant même l'Organisation mondiale de la santé!
Podczas nieuchronnych retombées, mamy do czynienia z nową sytuacją. Choroba rozprzestrzeniała się tak szybko, że było dla nas jasne, że reakcja na całym świecie będzie chaotyczna. Każdy kraj mógł promować swoje własne przepisy i zasady w celu kontrolowania 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. Mieliśmy rację i zdecydowaliśmy się zrobić coś, by to naprawić. Sitata jest pierwszą firmą na świecie, która stworzyła dedykowany interfejs API i usługę śledzenia zmian wprowadzonych w ograniczeniach podróży i warunkach wejścia w związku z COVID-19. Dzięki zaawansowanemu systemowi logistycznemu do wykrywania zdarzeń i zespołowi wyspecjalizowanych analityków dysponujemy wszystkimi niezbędnymi narzędziami i procesami.
Od momentu uruchomienia nowej usługi wiele organizacji, w tym Eddy Travels, Flight Centre i Etihad Airways, zaczęło czerpać zyski z danych dla swoich klientów; inne informacje zostaną wkrótce ogłoszone! Aby pomóc większej liczbie organizacji zajmujących się podróżami w czerpaniu korzyści z tej oferty, szczegółowo opisaliśmy poniżej kilka przykładów wyjaśniających, jak korzystać z API w różnych przypadkach. Mam nadzieję, że te objaśnienia pomogą Ci opracować własne inicjatywy.
Pierwsze pytania, jakie zadaje podróżnik, brzmią bez wątpienia: "Czy mogę wyjechać?" i "Czy mogę wyjechać na kwarantannę", co stanowi dobry punkt wyjścia. Stworzyliśmy zestaw danych dotyczących warunków wjazdu, aby odpowiedzieć na trudne pytania typu "oui/non" dotyczące wjazdu do kraju lub regionu.
W momencie redagowania niniejszego dokumentu zbiór danych obejmował sześć odrębnych kategorii:
Każda kategoria może mieć jedną z poniższych wartości:
Jeśli większość wartości brzmi "tak" lub "nie", sytuacja w terenie nie zawsze jest tak prosta. 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".
Warunkiem wejścia jest zasadniczo dokument, który dokumentuje zespół zasad narzuconych przez podmiot wobec jednego lub kilku innych państw lub regionów. Aktorem może być kraj, państwo lub gmina w naszej architekturze danych. Sitata obejmuje obecnie dane na poziomie krajów. Niemniej jednak dysponujemy kilkoma rejestrami państw/prowincji dla niektórych regionów, takich jak Stany Zjednoczone i inne.
Wszystkie zapisy zawierające wejście pod nazwą główną origine_pays_division_id ou origine_pays_région_id to poziom, który znajduje się odpowiednio na poziomie państwa lub na poziomie gminy. Jeśli chcesz dysponować większymi danymi, możesz nous contact et nous pourrons discuter de votre cas d'utilisation.
Prosimy o zapoznanie się ze strukturą danych dotyczących warunków przystąpienia do konsultanta. nasze dokumenty API ici.
Jedna część struktury danych jest w znacznym stopniu zniekształcona, a mianowicie nasze użycie tego terminu"pochodzenie" To nieporozumienie wynika z faktu, że deweloperzy często uważają pochodzenie za miejsce pochodzenia lub miejsce wyjazdu. Albo to, co rozumiemy jako "pochodzenie", jest w rzeczywistości pochodzeniem przepisów nałożonych na innych, tj. na państwo lub region, który ustanowił ograniczenie.
Kolejną ważną kwestią, na którą należy zwrócić uwagę, jest sposób działania naszej listy dotkniętych krajów. Jeśli affected_countries jest pusta, powinna być interpretowana jako reguła globalna, tj. dotyczy wszystkich krajów.
Jak można zauważyć w dokumentacji, istnieje wiele sposobów na odzyskanie danych z API. Poniżej przedstawiamy kilka najczęstszych przypadków użycia.
Istnieją różne sposoby zgłaszania tego typu żądań. Najprostsza wersja polega na użyciu le miejsce docelowe et départ paramètres. Parametry te akceptują kody ISO 3166-1 alpha-2 comme entrées
GET https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination=INOdpowiedź będzie zawierać wszystkie wymagania (na poziomie kraju i stanu) niezbędne do zrozumienia dla podróżnego wyjeżdżającego z kraju wylotu i podróżującego do kraju docelowego.
Sitata udostępnia dane na poziomie państwa dla niektórych regionów. Możesz być pewien, że dany wpis dotyczy państwa, jeśli le origin_pays_division a une valeur. Można również filtrować dane, aby nie zostały one odzyskane na poziomie stanu, korzystając z mistrza destination_pays_division parametr. Ma on wartość 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-APNależy pamiętać, że najprościej jest przeprowadzić wyszukiwanie według kraju, a następnie przefiltrować dane według państwa, aby sprawdzić, czy dane istnieją, i wykorzystać je, jeśli istnieją.
Podobnie jak w przypadku krajów, API Sitata może przesyłać wyniki między dwoma portami lotniczymi. Parametry départ_aéroport et destination_aéroport wykorzystywać kody l'OACI ou de l'IATA w celu filtrowania wyników. Odpowiedź zawiera wszystkie ograniczenia (na poziomie kraju i państwa) niezbędne do zrozumienia podróżnego opuszczającego odpowiedni kraj wyjazdu i przebywającego w kraju docelowym.
GET https://www.sitata.com/api/v2/entry_requirements?departure_airport=MUC&destination_airport=BOMOdpowiedź obejmuje wszystkie ograniczenia (na poziomie kraju i państwa) niezbędne do uwzględnienia przez podróżnego, który opuszcza kraj wyjazdu i udaje się do kraju docelowego.
Sitata zdecydowała się nie odpowiadać na żądania dotyczące konkretnej nazwy miejscowości, ponieważ może to prowadzić do konfliktów i nieporozumień. Zamiast tego zdecydowaliśmy się akceptować żądania naszego API za pomocą 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, departure_lng, destination_latet 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.8777W przypadku, gdy określisz swoje miejscowości w zależności od kraju i żądania w zależności od granic, nasz interfejs API odpowie na wszystkie ograniczenia (na poziomie kraju i państwa) niezbędne do zrozumienia podróżnego, który rozstaje się z krajem wyjazdu i udaje się do kraju docelowego.
W przypadku niektórych rodzajów warunków wejścia, mogą istnieć dodatkowe dane powiązane z typem metadonnów, które są nazywane dodatki. Czołówka jest mapą klarowności/wartości różnych elementów informacji uzupełniających dla konkretnego przypadku.
Takie ujawnienie danych podlega obowiązkowi ujawnienia typ 5. Dans cette entrée, le dodatki Kartografia zawiera mistrza zwanego quarantaine_days qui contiendra un nombre entier pour le nombre de jours de quarantaine imposés.
Takie ujawnienie danych podlega obowiązkowi ujawnienia typ 8. Dans cette entrée, le dodatki Kartografia zawiera mistrza zwanego entry_hours który zawiera całkowitą liczbę godzin, w ciągu których test na obecność COVID-19 jest wykonywany przed wejściem.
Uważamy, że dysponujemy bardzo solidnym narzędziem, które prawdopodobnie spełni wszystkie potrzeby podróżników w zakresie zrozumienia tego, co mogą napotkać na trasie. Jeśli masz szczególny przypadek użycia, którego nie omawiamy, skontaktuj się z nami. savoir !
Ten wpis jest częścią serii dwóch stron, które wyjaśniają, jak komunikować się 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 określają rodzaje surowych warunków typu oui/non niezbędnych do wjazdu do kraju lub regionu, ale nie mówiliśmy jeszcze o tym, co dzieje się wewnątrz kraju. Jest to jeden wybór, aby dowiedzieć się, jak wjechać do kraju, a drugi, aby dowiedzieć się, czy możliwe jest osiedlenie się w kraju lub odwiedzenie plaż, czy też jest to obowiązkowe.
Zachęcamy do zapoznania się z drugim artykułem, który omawia naszą serię informacji na temat ograniczeń w podróży. Uwaga: to prawie to samo, możesz zawsze skonsultować się z nami dokumentacja dotycząca interfejsu API en attendant.
English 
Español 
Français 
Italiano 
Deutsch 
Magyar 
Română 
العربية 
Polski 
Português 
Nederlands 
Svenska 
Suomi 
Norsk bokmål 
Dansk