Wielu z nas nie zdaje sobie z tego sprawy, ale pierwsze ośrodki Sitata zostały zbudowane w celu szybkiego wykrywania chorób. Co więcej, nasz założyciel ma na swoim koncie udział w TedX w 2016 roku na temat dlaczego musimy reklamować podróżnych, aby zapobiec rozprzestrzenianiu się choroby?. Nie powinno zatem dziwić, że weszliśmy w COVID-19, gdy poinformowano nas o nietypowej grupie przypadków neumonii na początku grudnia 2019 roku. W dniu 2 stycznia 2020 r. nasz zespół ds. zdrowia ustalił, że musimy wyemitować nasza pierwsza reklama dla naszych podróżników i partnerów handlowych. ¡Esto fue días antes incluso de la Organización Mundial de la Salud!
W czasie nieuniknionego opadu radioaktywnego mieliśmy do czynienia z epifanią. Choroba rozprzestrzeniała się tak szybko, że było jasne, iż w większości przypadków globalna reakcja na nią okaże się skuteczna. Każde państwo wprowadziło swój własny zestaw przepisów i regulacji mających na celu kontrolę rozprzestrzeniania się choroby. To nieuchronnie spowodowało zakłócenia w podróżach na całym świecie i było ogromnym źródłem dezorientacji dla tych, którzy chcieli podróżować. Mieliśmy swoje racje i zaproponowaliśmy, by coś z tym zrobić. Sitata była jedną z pierwszych firm na świecie, która stworzyła dedykowany interfejs API i usługę nadzoru nad zmianami w ograniczeniach dotyczących podróży i wymaganiach dotyczących wjazdu w wyniku COVID-19. Dzięki zaawansowanemu systemowi oprogramowania do wykrywania zdarzeń i dedykowanemu zespołowi analityków dysponowaliśmy odpowiednimi narzędziami i procesami.
Od momentu uruchomienia tej nowej usługi mamy do czynienia z różnymi organizacjami, które wykorzystują te dane z korzyścią dla swoich klientów, w tym Eddy Travels, Flight Centre i Etihad Airways; ¡y jest ich więcej, o czym wkrótce poinformujemy! Aby pomóc większej liczbie organizacji zajmujących się podróżami skorzystać z tej oferty, szczegółowo opisaliśmy serię przykładów, które pomogą wyjaśnić, jak korzystać z API w różnych przypadkach. Mamy nadzieję, że te wyjaśnienia pomogą w realizacji własnych inicjatyw.
Nie ulega wątpliwości, że pierwsze pytania, jakie zadaje podróżnik, brzmią "czy mogę tu przyjechać?" i "czy jestem na miejscu w cuarentena?", więc jest to dobre miejsce na rozpoczęcie podróży. Stworzyliśmy zestaw danych Requisitos de Entrada, aby odpowiedzieć na trudne pytania dotyczące wjazdu do kraju lub regionu.
W momencie redagowania niniejszego komunikatu dane te obejmowały 10 różnych kategorii:
Każda kategoria może mieć jedną z poniższych wartości:
Chociaż większość wartości brzmi "tak" i "nie", sytuacja na ziemi nie zawsze jest tak prosta. A veces hay reglas realmente extrañas y locas que varios gobiernos han puesto en marcha que requieren los tipos de valores "con excepciones".
Wymóg wejścia jest przede wszystkim rejestrem, który dokumentuje połączenie norm narzuconych przez agenta przeciwko jednemu lub kilku krajom lub regionom. Aktor może być państwem, stanem lub nawet gminą w naszej strukturze danych. Ogólnie rzecz biorąc, Sitata zawiera dane na poziomie kraju w aktualnej sytuacji. Mimo to posiadamy kilka rejestrów stanowych/wojewódzkich dla wybranych regionów, takich jak Stany Zjednoczone i inne.
Dowolny rejestr, do którego wejście znajduje się poniżej pola origin_country_division_id o origin_country_region_id es uno que es de nivel estatal o municipal, respectivamente. Si desea disponer de más datos granulares, por favor, póngase en contacto con nosotros y podemos hablar de su caso de uso.
Prosimy o poświęcenie czasu na zapoznanie się ze strukturą danych i wymaganiami wstępnymi, odwiedzając stronę nasze dokumenty API tutaj.
Częścią nieporozumień dotyczących struktury danych jest nasze użycie terminu"pochodzenie" Esto es confuso porque a menudo los desarrolladores piensan que el origen es el lugar de origen o de partida. Sin embargo, lo que queremos decir con origen es en realidad el origen de la regla impuesta a otros, es decir, el país or la región que ha creado la restricción.
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 widać w dokumentacji, istnieją różne formy odzyskiwania danych z API. Poniżej przedstawiamy kilka najbardziej powszechnych przypadków użycia.
Istnieje kilka sposobów na złożenie takiej petycji. Najprostszą wersją jest użycie el destino y salida parámetros. Parametry te akceptują kodeksy ISO 3166-1 alfa-2 como entradas
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 regionalnym dla niektórych regionów. Usted sabrá que una entrada particular es para un estado si el división_país_original pole ma swoją wartość. También puede filtar para recuperar sólo los datos de nivel de estado usando el división_país_destino parametr. Espera un valor ISO_3166-2. Por ejemplo, US-TX para Texas, Estados Unidos.
GET https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination_country_division=IN-APZauważ, że prostsze może być sprawdzenie kraju, a następnie przefiltrowanie danych z poszczególnych stanów w celu sprawdzenia, czy takie dane istnieją, i wykorzystanie ich, jeśli istnieją.
Podobnie jak w przypadku innych krajów, API de Sitata może wyświetlać wyniki między dwoma lotniskami. Parametry aeropuerto de salida y aeropuerto de destino wykorzystanie kodów la OACI o de la IATA do filtrowania wyników. Odpowiedź zawiera wszystkie ograniczenia (na poziomie kraju i stanu) niezbędne do zrozumienia podróżnego, który sprzedaje się z kraju docelowego i podróżuje do kraju docelowego.
GET https://www.sitata.com/api/v2/entry_requirements?departure_airport=MUC&destination_airport=BOMOdpowiedź zawiera wszystkie ograniczenia (na poziomie kraju i stanu) niezbędne do zrozumienia dla podróżnego, który sprzedaje kraj wyjścia i podróżuje do kraju docelowego.
Firma Sitata zdecydowała, że nie będzie konsultować się w szczególności z nazwami miast, ponieważ może to prowadzić do konfliktów i nieporozumień. W związku z tym zdecydowaliśmy się na rozszerzenie konsultacji z naszym API o współrzędne szerokości i długości geograficznej, co nie spowodowało żadnych niejasności w naszym zestawieniu wyników. Parametry to departure_lat, departure_lng, destination_lat...y.. 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 podasz lokalizację i skonsultujesz się w oparciu o koordynaty, nasz interfejs API odpowie na wszystkie ograniczenia (na poziomie kraju i stanu) niezbędne do obliczenia dla podróżnego, który sprzedaje kraj wyjścia i podróżuje do kraju docelowego.
W przypadku niektórych rodzajów wymagań wstępnych mogą istnieć dodatkowe dane powiązane w polu typu metadanych o nazwie dodatki. To pole jest kartografią clave/valor zawierającą różne dodatkowe informacje dla konkretnego wymagania
Ten wpis danych podlega wymogowi wpisu tipo 5. En esta entrada, el dodatki Mapa zawiera pole o nazwie días_de_cuarentena który zawiera numer entero dla liczby dni dla kilku opłat.
Ten wpis danych podlega wymogowi wpisu tipo 8. En esta entrada, el dodatki Mapa zawiera pole o nazwie entry_hours który zawiera numer entero dla liczby godzin, w których można przeprowadzić test negatywny przed wejściem.
Uważamy, że mamy bardzo solidną wersję, która prawdopodobnie zaspokoi wszystkie potrzeby, aby pomóc podróżnym w zrozumieniu tego, co prawdopodobnie napotkają na trasie. Jeśli masz szczególny przypadek użycia, o którym nie mówimy, por favor háganoslo saber!
Ten wpis jest częścią dwuczęściowej serii, która wyjaśnia, jak korzystać z interfejsu API Sitata w celu uzyskania wymagań dotyczących wjazdu i informacji o ograniczeniach dotyczących podróży. Do tej pory rozmawialiśmy o wymaganiach wjazdu, które obejmują wszystkie rodzaje wymagań niezbędnych do wjazdu do kraju lub regionu, ale nie rozmawialiśmy o tym, co dzieje się w kraju. Jedną rzeczą jest wiedza na temat wjazdu do danego kraju, a drugą jest zrozumienie, czy można przemieszczać się po kraju lub odwiedzać ośrodki wypoczynkowe, czy też jest to obowiązkowe.
Zachowaj czujność na drugi post, który pojawi się w naszym zestawieniu danych dotyczących ograniczeń podróży. Pista - jest to idealne rozwiązanie, ponieważ zawsze możesz spojrzeć na nasze dokumentacja de la API mientras tanto.
English 
Español 
Français 
Italiano 
Deutsch 
Magyar 
Română 
العربية 
Polski 
Português 
Nederlands 
Svenska 
Suomi 
Norsk bokmål 
Dansk