Wielu z nas nie wie, że pierwsze ośrodki Sitaty zostały zbudowane w celu szybkiego wykrywania chorób. De hecho, nuestro fundador tiene una charla de TedX a partir de 2016 sobre por qué necesitamos advertir a los viajeros para ayudar a prevenir la propagación de la enfermedad. No debe sorprender entonces que nos enteramos de COVID-19 cuando se informó de un inusual grupo de casos de neumonía a principios de diciembre de 2019. El 2 de enero de 2020, nuestro equipo de salud determinó que debíamos emitir nuestra primera advertencia a nuestros viajeros y socios comerciales. ¡Esto fue días antes incluso de la Organización Mundial de la Salud!

W czasie nieuniknionego wycieku radioaktywnego mieliśmy epifanię. La enfermedad se estaba extendiendo tan rápido que teníamos claro que la respuesta global sería caótica en el mejor de los casos. Cada país promulgaría su propio conjunto de regulaciones y reglas para controlar la propagación. Esto inevitablemente causaría estragos en los viajes mundiales y sería una enorme fuente de confusión para aquellos que aún desean viajar. Teníamos razón y nos propusimos hacer algo al respecto. Sitata była jedną z pierwszych firm na świecie, która stworzyła dedykowane API i usługę nadzoru nad zmianami w ograniczeniach dotyczących wjazdu i wymaganiach dotyczących wjazdu w wyniku COVID-19. Dzięki zaawansowanemu systemowi oprogramowania do wykrywania zdarzeń oraz dedykowanemu zespołowi analityków, posiadaliśmy odpowiednie narzędzia i procesy, aby to zrobić.

Od momentu uruchomienia tej nowej usługi mamy wiele organizacji, które wykorzystują dane dla swoich klientów, w tym Eddy Travels, Flight Centre i Etihad Airways; ¡i mamy jeszcze więcej, o których poinformujemy wkrótce! W celu ułatwienia korzystania z tej oferty większej liczbie organizacji zajmujących się podróżami, opisaliśmy szczegółowo serię przykładów, które pomogą wyjaśnić, jak korzystać z API w różnych przypadkach użycia. Cieszymy się, że te wyjaśnienia pomogą nam w rozpoczęciu własnych inicjatyw.

Requisitos de entrada

Bez wątpienia pierwsze pytania, jakie zadaje podróżny, brzmią: "Czy mogę pojechać do tego miejsca?" oraz "Czy zostanę na miejscu w cuarentena?", dlatego jest to dobre miejsce na rozpoczęcie podróży. Stworzyliśmy zestaw danych z Requisitos de Entrada, aby odpowiedzieć na trudne "tak/nie" pytania związane z wejściem do kraju lub regionu.

En el momento de redactar el presente informe, este conjunto de datos incluía las siguientes 10 categorías distintas:

• Czy rezydent może wjechać do kraju?
• Czy można wjechać do kraju z zagranicy?
• Czy zezwalasz na podróżowanie po kraju?
• ¿Se requiere una prueba a la llegada (brote de la enfermedad)?
• ¿Se permite un certificado de prueba (brote de una enfermedad)?
• Czy wymagana jest wizyta u lekarza w szpitalu? Czy wymagana jest szczepionka?
• Czy wymagamy ubezpieczenia?
• Czy wymagane jest posiadanie certyfikatu?
• Czy wymagany jest formularz zapisu? (salud u otro)

Każda kategoria może mieć jedną z następujących wartości:

• Sí
• Sí, con excepciones
• Nie
• Nie, con excepciones

Aunque la gran mayoría de los valores son "sí" y "no", la situación sobre el terreno no siempre es tan sencilla. 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 państwom lub regionom. Aktor może być państwem, stanem lub gminą w naszej strukturze danych. Ogólnie rzecz biorąc, Sitata obejmuje dane na poziomie kraju w chwili obecnej. Mimo to, posiadamy kilka rejestrów państwowych/prowincjonalnych dla wybranych regionów, takich jak Los Estados Unidos i innych.

Każdy rejestrator, który ma wejście na końcu pola. origin_country_division_id o origin_country_region_id to jeden, który jest na poziomie krajowym lub miejskim, odpowiednio. Jeśli chcesz dysponować większą ilością danych, skontaktuj się z nami con nosotros y podemos hablar de su caso de uso.

Por favor, tómese un tiempo para familiarizarse con la estructura de datos de los requisitos de entrada echando un vistazo a nasze dokumenty dotyczące API są dostępne na stronie.

Jedną z części nieco zagmatwanej struktury danych jest nasze użycie terminu"origen" 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.

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.

Algunos ejemplos

Jak widać w dokumentacji, istnieją różne formy odzyskiwania danych z API. A continuación veremos algunos de los casos de uso más comunes.

¿Cómo puedo obtener los requisitos entre dos países?

Hay un par de maneras de hacer este tipo de petición. Najprostsza wersja to użycie el destino y salida parámetros. Estos parámetros aceptan los códigos ISO 3166-1 alfa-2 como entradas

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.

Czy chcesz uzyskać dane na poziomie krajowym?

Sitata posiada dane na poziomie krajowym 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ść. Można również filtrować, aby odzyskać tylko dane o poziomie stanu, używając opcji división_país_destino parámetro. Podaj wartość 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-AP

Zauważ, że łatwiej byłoby przeprowadzić konsultację według kraju, a następnie przefiltrować dane państw, aby sprawdzić, czy istnieją, i wykorzystać je, jeśli istnieją.

¿Cómo puedo obtener los requisitos entre dos aeropuertos?

Al igual que en el caso de los países, la API de Sitata puede devolver resultados entre dos aeropuertos. Los parámetros aeropuerto de salida y aeropuerto de destino wykorzystywać los códigos de la OACI o de la IATA do filtrowania wyników. La respuesta incluirá todas las restricciones (a nivel de país y de estado) necesarias para comprender al viajero que sale del país de salida correspondiente y viaja al país de destino.

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

La respuesta incluirá todas las restricciones (a nivel de país y de estado) necesarias para comprender para el viajero que sale del país de salida y viaja al país de destino.

¿Y si sólo tengo información de la ciudad?

Sitata zdecydowała się nie udzielać konsultacji po nazwie miasta w szczególności, ponieważ mogłoby to spowodować konflikty i zamieszanie. En su lugar, elegimos acomodar la consulta a nuestra API por coordenadas de latitud y longitud, lo que no produce ninguna ambigüedad en nuestro conjunto de resultados. Los parámetros son odlot_lat, odlot_lng, miejsce przeznaczenia_lat...y.. 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 podasz swoje miasta do wyboru i skonsultujesz się z nimi na podstawie umów, nasze API odpowie Ci z wszystkimi ograniczeniami (na poziomie kraju i stanu) potrzebnymi do obliczenia dla podróżnych, którzy sprzedają się z kraju, z którego pochodzą, i przejeżdżają do kraju docelowego.

Datos adicionales

W przypadku niektórych rodzajów wymagań wstępnych, mogą istnieć dodatkowe dane powiązane z jedną grupą metadanych nazwaną dodatki. Este campo es una cartografía clave/valor de varios bits extra de información para un requerimiento particular

Co to jest liczba dni tygodnia?

Wprowadzanie danych jest objęte wymogiem wprowadzenia. tipo 5. En esta entrada, el dodatki el mapeo contendrá un campo llamado días_de_cuarentena que contendrá un número entero para el número de días de cuarentena impuestos.

Czy jest to liczba godzin przed wejściem do szpitala?

Wprowadzanie danych jest objęte wymogiem wprowadzenia. tipo 8. En esta entrada, el dodatki el mapeo contendrá un campo llamado wejście_godzin que contendrá un número entero para el número de horas que se permite una prueba covid negativa antes de la entrada.

Háganos saber

Uważamy, że mamy bardzo solidne rozwiązanie, które prawdopodobnie zaspokoi wszystkie potrzeby związane z pomocą podróżnym w zrozumieniu, co mogą napotkać na swojej drodze. Jeśli masz jakiś szczególny przypadek użycia, którego nie chcemy ujawniać, por favor háganoslo saber!

Espera... ¡hay más!

Ten wpis jest częścią serii dwóch części, które wyjaśniają, jak współdziałać z API Sitata w zakresie wymagań wejściowych i informacji o ograniczeniach podróży. Hasta ahora hemos hablado de los Requisitos de Entrada que esbozan los duros sí/no tipos de requisitos necesarios para entrar en un país or región, pero tampoco hemos hablado de lo que ocurre dentro del país. Una cosa es saber acerca de entrar a un país, y otra es entender si es posible moverse por el país o visitar las playas o si hay un toque de queda obligatorio.

Manténgase en sintonía para el segundo post que se sumergirá en nuestro conjunto de datos de Restricción de Viaje. Pista - es casi idéntico, así que siempre puedes echar un vistazo a nuestra documentación de la API mientras tanto.

Prosimy o śledzenie i polubienie nas: