Wielu z was może tego nie wiedzieć, ale wczesne fundamenty Sitata zostały zbudowane z myślą o wczesnym wykrywaniu chorób. W rzeczywistości nasz założyciel ma wykład TedX z 2016 roku na temat Dlaczego musimy ostrzegać podróżnych, aby zapobiegać rozprzestrzenianiu się chorób?. Nie powinno więc dziwić, że zajęliśmy się COVID-19, gdy na początku grudnia 2019 r. zgłoszono go jako niezwykłe skupisko przypadków zapalenia płuc. Do 2 stycznia 2020 r. nasz zespół ds. zdrowia ustalił, że powinniśmy wydać nasze pierwsze ostrzeżenie dla podróżnych i partnerów biznesowych. Było to na kilka dni przed powstaniem Światowej Organizacji Zdrowia!
Podczas nieuniknionego opadu mieliśmy objawienie. Choroba rozprzestrzeniała się tak szybko, że było dla nas jasne, że globalna reakcja będzie w najlepszym razie chaotyczna. Każdy kraj wprowadziłby własny zestaw przepisów i zasad dotyczących kontrolowania rozprzestrzeniania się choroby. Nieuchronnie spowodowałoby to spustoszenie w globalnych podróżach i byłoby ogromnym źródłem zamieszania dla tych, którzy nadal chcieliby podróżować. Mieliśmy rację i postanowiliśmy coś z tym zrobić. Sitata była jedną z pierwszych firm na świecie, która stworzyła dedykowany interfejs API i usługę monitorowania zmian w ograniczeniach podróży i wymogach wjazdu w wyniku COVID-19. Dzięki zaawansowanemu systemowi oprogramowania do wykrywania zdarzeń i dedykowanemu zespołowi analityków, mieliśmy już wszystkie odpowiednie narzędzia i procesy, aby to zrobić.
Od czasu uruchomienia tej nowej usługi wiele organizacji skorzystało z danych z korzyścią dla swoich klientów, w tym Eddy Travels, Flight Centre i Etihad Airways; a wkrótce zostaną ogłoszone kolejne! Aby pomóc większej liczbie organizacji koncentrujących się na podróżach skorzystać z tej oferty, poniżej szczegółowo opisaliśmy szereg przykładów, które pomogą wyjaśnić, jak korzystać z API w różnych przypadkach. Mam nadzieję, że te wyjaśnienia pomogą ci rozpocząć własne inicjatywy.
Bez wątpienia pierwsze pytania zadawane przez podróżnych to "czy mogę tam pojechać?" i "czy zostanę poddany kwarantannie", więc jest to dobre miejsce na rozpoczęcie. Stworzyliśmy zestaw danych Entry Requirements, aby odpowiedzieć na trudne pytania typu "tak/nie" dotyczące wjazdu do kraju lub regionu.
W chwili pisania tego tekstu zestaw danych obejmował następujące 10 odrębnych kategorii:
Każda kategoria może mieć jedną z następujących wartości:
Podczas gdy zdecydowana większość wartości to "tak" i "nie", sytuacja w terenie nie zawsze jest tak prosta. Czasami istnieją naprawdę dziwne i szalone zasady wprowadzone przez różne rządy, które wymuszają stosowanie wartości typu "z wyjątkami".
Wymóg wejścia to zasadniczo zapis dokumentujący zestaw reguł nałożonych przez podmiot na jeden lub wiele innych krajów lub regionów. Aktorem może być kraj, stan, a nawet gmina w naszej architekturze danych. Ogólnie rzecz biorąc, Sitata obejmuje obecnie dane na poziomie kraju. Mamy jednak kilka rekordów stanowych/prowincjonalnych dla wybranych regionów, takich jak Stany Zjednoczone i inne.
Każdy rekord, który ma wpis w polu origin_country_division_id lub origin_country_region_id to odpowiednio poziom stanowy lub miejski. Aby uzyskać dostęp do bardziej szczegółowych danych, prosimy o skontaktuj się z nami i porozmawiamy o Twoim przypadku użycia.
Poświęć trochę czasu na zapoznanie się ze strukturą danych wymagań wstępnych poprzez Zapoznaj się z naszą dokumentacją API tutaj.
Nieco mylącą częścią struktury danych jest użycie terminu "pochodzenie." Jest to mylące, ponieważ często deweloperzy myślą o pochodzeniu jako o miejscu pochodzenia lub miejscu wyjścia. Jednak to, co rozumiemy przez pochodzenie, to w rzeczywistości pochodzenie reguły nałożonej na innych, tj. kraj lub region, który stworzył 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 pobierania danych z API. Poniżej omówimy kilka bardziej powszechnych przypadków użycia.
Istnieje kilka sposobów na wykonanie tego typu żądania. Najprostszą wersją jest użycie funkcji miejsce docelowe oraz odlot parametry. Parametry te akceptują ISO 3166-1 alpha-2 kody jako dane wejściowe.
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 posiada dane na poziomie stanu dla niektórych regionów. Będziesz wiedział, że dany wpis dotyczy stanu, jeśli origin_country_division pole ma wartość. Możesz także filtrować, aby pobierać tylko dane na poziomie stanu, używając opcji destination_country_division parametr. Oczekuje on wartości ISO_3166-2 wartość. Na przykład US-TX dla Teksas, Stany Zjednoczone.
GET https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination_country_division=IN-APNależy pamiętać, że prostsze może być wyszukiwanie według kraju, a następnie filtrowanie według danych stanu, aby sprawdzić, czy takie dane istnieją, i użyć ich, jeśli istnieją.
Podobnie jak w przypadku krajów, interfejs API Sitata może zwracać wyniki między dwoma lotniskami. Parametry departure_airport oraz destination_airport używać ICAO lub IATA aby przefiltrować wyniki. Odpowiedź będzie zawierać wszystkie ograniczenia (na poziomie kraju i stanu) niezbędne do zrozumienia dla podróżnego wyjeżdżającego z odpowiedniego kraju wyjazdu i podróżującego do kraju docelowego.
GET https://www.sitata.com/api/v2/entry_requirements?departure_airport=MUC&destination_airport=BOMOdpowiedź będzie zawierać wszystkie ograniczenia (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 zdecydowała się nie obsługiwać zapytań o konkretną nazwę miasta, ponieważ mogłoby to prowadzić do konfliktów i nieporozumień. Zamiast tego zdecydowaliśmy się na obsługę zapytań do naszego interfejsu 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 departure_lat, departure_lng, destination_latoraz 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.8777Jeśli zamienisz miasta na lokalizacje i zapytasz na podstawie współrzędnych, nasz interfejs API odpowie wszystkimi ograniczeniami (na poziomie kraju i stanu) niezbędnymi do zrozumienia dla podróżnego wyruszającego z kraju wylotu i podróżującego do kraju docelowego.
W przypadku niektórych typów wymagań wstępnych mogą istnieć dodatkowe powiązane dane w polu typu metadanych o nazwie dodatki. Pole to jest mapowaniem klucz/wartość różnych dodatkowych bitów informacji dla konkretnego wymagania.
Ten wpis danych podlega wymogowi wpisu typ 5. W tym wpisie dodatki mapowanie będzie zawierać pole o nazwie dni kwarantanny która będzie zawierać liczbę całkowitą określającą liczbę dni nałożonej kwarantanny.
Ten wpis danych podlega wymogowi wpisu typ 8. W tym wpisie dodatki mapowanie będzie zawierać pole o nazwie entry_hours który będzie zawierał liczbę całkowitą określającą liczbę godzin, przez które negatywny wynik testu na COVID-19 jest dozwolony przed wejściem.
Uważamy, że mamy bardzo solidne rozwiązanie, które prawdopodobnie zaspokoi wszystkie potrzeby, aby pomóc podróżnym zrozumieć, co mogą napotkać na swojej drodze. Jeśli masz konkretny przypadek użycia, którego nie uwzględniamy, daj nam znać!
Ten wpis jest częścią dwuczęściowej serii, która wyjaśnia, jak współdziałać z interfejsem API Sitata w celu uzyskania informacji o wymaganiach wjazdowych i ograniczeniach w podróżowaniu. Do tej pory rozmawialiśmy o wymaganiach wjazdowych, które określają twarde tak / nie wymagania niezbędne do wjazdu do kraju lub regionu, ale nie rozmawialiśmy też o tym, co dzieje się w kraju. Jedną rzeczą jest wiedzieć o wjeździe do kraju, inną jest zrozumienie, czy można poruszać się po kraju, odwiedzać plaże lub czy obowiązuje godzina policyjna.
Bądź na bieżąco z drugim postem, w którym zagłębimy się w nasz zestaw danych dotyczących ograniczeń w podróżowaniu. Podpowiedź - jest prawie identyczny, więc zawsze możesz rzucić okiem na nasz Dokumentacja API w międzyczasie.
English 
Español 
Français 
Italiano 
Deutsch 
Magyar 
Română 
العربية 
Polski 
Português 
Nederlands 
Svenska 
Suomi 
Norsk bokmål 
Dansk