Muitos de vós já não sabem, mas os primeiros cimientos do Sitata foram construídos para a deteção precoce de doenças. De hecho, nuestro fundador tiene una charla de TedX a partir de 2016 sobre porque é que precisamos de avisar os viajantes para ajudar a prevenir a propagação da doença. Não é de admirar que tenhamos entrado em COVID-19 quando fomos informados de um grupo invulgar de casos de neumonía a principios de diciembre de 2019. A 2 de janeiro de 2020, a nossa equipa de saúde determinou que deveríamos emitir a nossa primeira publicidade aos nossos viajantes e parceiros comerciais. Isso foi dias antes inclusive da Organização Mundial da Saúde!
Durante a inevitável lava radioactiva, tivemos uma epifania. A doença estava a estender-se tão rapidamente que tínhamos a certeza de que a resposta global seria caótica na maioria dos casos. Cada país promulgou o seu próprio conjunto de regulamentos e normas para controlar a propagação. Isso inevitavelmente causaria estragos nas viagens mundiais e seria um enorme motivo de confusão para aqueles que ainda desejassem viajar. Tínhamos razão e propusemo-nos fazer algo a este respeito. O Sitata foi uma das primeiras empresas do mundo a criar uma API dedicada e um serviço de supervisão para as mudanças nas restrições de viagem e nos requisitos de entrada como resultado da COVID-19. Com um sistema avançado de software para a deteção de eventos e uma equipa dedicada de analistas, já tínhamos todos os instrumentos e processos adequados para o fazer.
Desde o lançamento deste novo serviço, temos tido uma variedade de organizações que utilizam os dados em benefício dos seus próprios clientes, incluindo Eddy Travels, Flight Centre e Etihad Airways; ¡y hay más que se anunciarán pronto! Com o objetivo de ajudar a que mais organizações centradas nas viagens beneficiem desta oferta, escrevemos detalhadamente a seguir uma série de exemplos para ajudar a explicar como utilizar a API para uma variedade de casos de utilização. Espero que estas explicações ajudem a pôr em marcha as suas próprias iniciativas.
Sem dúvida, as primeiras perguntas que um viajante faz são "¿puedo ir allí?" e "¿seré puesto en cuarentena?", pelo que este é um bom lugar para começar. Criámos o conjunto de dados de Requisitos de Entrada para responder aos duros "sí/no" das perguntas relativas à entrada num país ou região.
En el momento de redactar el presente informe, este conjunto de datos incluía las siguientes 10 categorías distintas:
Cada categoria pode ter um dos seguintes valores:
Embora a grande maioria dos valores seja "sí" e "no", a situação no terreno nem sempre é tão simples. Por vezes, há regras realmente extrañas e locas que vários governos puseram em marcha e que exigem os tipos de valores "com excepções"
Um requisito de entrada é essencialmente um registo que documenta um conjunto de normas impostas por um agente contra um ou vários países ou regiões. O ator pode ser um país, estado ou mesmo município na nossa arquitetura de dados. Em geral, o Sitata cobre os dados a nível de país na atualidade. No entanto, dispomos de alguns registos estatais/provinciais para regiões selecionadas como os Estados Unidos e outros
Qualquer registo que tenha uma entrada abaixo do campo origin_country_division_id o id_região_do_país_de_origem es uno que es de nivel estatal o municipal, respetivamente. Se desejar dispor de mais dados granulares, por favor, entre em contacto com connosco e podemos falar do seu caso de utilização.
Por favor, dedique algum tempo a familiarizar-se com a estrutura de dados dos requisitos de entrada, visitando nossos documentos sobre a API aqui.
Uma parte um pouco confusa sobre a estrutura dos dados é a utilização que fazemos do termo"origem" 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 o la región que ha creado la restricción.
Outro ponto importante a ter em conta é a forma como a nossa lista de países afectados funciona. Se affected_countries estiver vazia, deve ser interpretada como uma regra global, ou seja, todos os países são afectados.
Como já vimos na documentação, existem várias formas de recuperar dados da API. A seguir, veremos alguns dos casos de uso mais comuns.
Existem várias formas de fazer este tipo de pedido. A versão mais simples é usar o destino y sálida parámetros. Estes parâmetros aceitam os códigos ISO 3166-1 alfa-2 como entradas
OBTER https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination=INA resposta incluirá todos os requisitos (a nível nacional e estatal) necessários para compreender o viajante que parte do país de partida e viaja para o país de destino.
O Sitata dispõe de dados a nível estatal para determinadas regiões. O utilizador saberá que uma entrada particular é para um estado se o división_país_original o campo tem um valor. Também é possível filtrar para recuperar apenas os dados de nível de estado usando o divisão_país_destino parámetro. Espera um valor ISO_3166-2. Por exemplo, US-TX para Texas, Estados Unidos.
OBTER https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination_country_division=IN-APObserva-se que poderia ser mais simples fazer uma consulta por país e depois filtrar os dados dos estados para ver se esses dados existem e utilizá-los se existirem.
Da mesma forma que no caso dos países, a API do Sitata pode devolver resultados entre os aeroportos. Os parâmetros aeroporto de salida y aeroporto de destino utilizar os códigos de la OACI o de la IATA para filtrar os resultados. A resposta incluirá todas as restrições (a nível de país e de estado) necessárias para compreender o viajante que vende do país de saída correspondente e viaja para o país de destino.
OBTER https://www.sitata.com/api/v2/entry_requirements?departure_airport=MUC&destination_airport=BOMLa 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.
O Sitata escolheu não dar cabida às consultas por um nome de cidade em particular porque isso poderia dar lugar a conflitos e confusões. Em vez disso, optámos por acomodar a consulta à nossa API por coordenadas de latitude e longitude, o que não produz qualquer ambiguidade no nosso conjunto de resultados. Os parâmetros são partida_lat, local de partida, destino_lat...y.. destino_lng.
OBTER https://www.sitata.com/api/v2/entry_requirements?departure_lat=48.13743&departure_lng=11.57549&destination_lat=19.0760&destination_lng=72.8777Se resolver as suas cidades com base nas localizações e consultas, a nossa API responderá com todas as restrições (a nível de país e de estado) necessárias para compreender o viajante que vende do país de saída e viaja para o país de destino.
Para alguns tipos de requisitos de entrada, podem existir dados adicionais associados num campo de tipo de metadados denominado extras. Este campo é uma cartografia clara/valor de vários bits extra de informação para um requisito específico
Esta entrada de dados está sujeita ao requisito de entrada tipo 5. Nesta entrada, o extras o mapa contém um campo denominado dias_de_cuarentena que contendrá un número entero para el número de días de cuarentena impuestos.
Esta entrada de dados está sujeita ao requisito de entrada tipo 8. Nesta entrada, o extras o mapa contém um campo denominado horas_de_entrada que contenha um número entero para o número de horas que se permite una prueba covid negativa antes de la entrada.
Acreditamos que dispomos de uma solução muito robusta que provavelmente satisfaz todas as suas necessidades para ajudar os seus viajantes a compreender o que é provável que encontrem no caminho. Se tiver um caso de uso particular que não estamos a abordar, por favor háganoslo saber!
Esta entrada faz parte de uma série de duas partes que explicam como interagir com a API do Sitata para os requisitos de entrada e a informação sobre restrições de viagem. Até agora falámos sobre os Requisitos de Entrada que incluem os duros tipos de requisitos necessários para entrar num país ou região, mas também não falámos sobre o que ocorre dentro do país. Uma coisa é saber acerca de entrar num país, e outra é entender se é possível deslocar-se pelo país ou visitar as praias ou se há um toque de queda obrigatório.
Mantenham-se em sintonia para o segundo post que se juntará ao nosso conjunto de dados de Restricción de Viaje. Pista - é praticamente idêntico, pelo que pode sempre ver a nossa documentação da API, enquanto isso.
English 
Español 
Français 
Italiano 
Deutsch 
Magyar 
Română 
العربية 
Polski 
Português 
Nederlands 
Svenska 
Suomi 
Norsk bokmål 
Dansk