Muitos de vocês podem não saber disso, mas as primeiras fundações do Sitata foram construídas para a deteção precoce de doenças. De facto, o nosso fundador tem uma palestra TedX de 2016 sobre por que razão é necessário avisar os viajantes para ajudar a evitar a propagação de doenças. Não deve surpreender, portanto, que tenhamos detectado a COVID-19 quando foi notificada como um grupo invulgar de casos de pneumonia no início de dezembro de 2019. Em 2 de janeiro de 2020, a nossa equipa de saúde determinou que deveríamos emitir o nosso primeiro aviso aos nossos viajantes e parceiros comerciais. Isto foi dias antes da Organização Mundial de Saúde!
Durante as inevitáveis consequências, tivemos uma epifania. A doença estava a espalhar-se tão rapidamente que ficou claro para nós que a resposta global seria, na melhor das hipóteses, caótica. Cada país adoptaria o seu próprio conjunto de regulamentos e regras para controlar a propagação. Isto causaria inevitavelmente estragos nas viagens a nível mundial e seria uma enorme fonte de confusão para aqueles que ainda desejassem viajar. Tínhamos razão e decidimos fazer algo a esse respeito. A Sitata foi uma das primeiras empresas do mundo a criar uma API dedicada e um serviço de monitorização para as alterações nas restrições de viagem e requisitos de entrada em resultado da COVID-19. Com um sistema de software avançado para deteção de eventos e uma equipa dedicada de analistas, já dispúnhamos de todas as ferramentas e processos adequados para o fazer.
Desde o lançamento deste novo serviço, várias organizações tiraram partido dos dados para benefício dos seus próprios clientes, incluindo a Eddy Travels, a Flight Centre e a Etihad Airways; e outras serão anunciadas em breve! Para ajudar mais organizações focadas em viagens a beneficiarem desta oferta, escrevemos em pormenor abaixo 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 o ajudem a pôr em prática as suas próprias iniciativas.
Sem dúvida, as primeiras perguntas que um viajante faz são "posso ir para lá?" e "vou ficar em quarentena", pelo que este é um bom ponto de partida. Criámos o conjunto de dados Requisitos de entrada para responder às perguntas difíceis de tipo "sim/não" relativas à entrada num país ou região.
No momento da redação do presente relatório, este conjunto de dados incluía as seguintes 10 categorias distintas:
Cada categoria pode ter um dos seguintes valores:
Embora a grande maioria dos valores seja "sim" e "não", a situação no terreno nem sempre é tão direta. Por vezes, há regras muito estranhas e malucas que os vários governos puseram em prática, o que exige os tipos de valores "com excepções".
Um requisito de entrada é essencialmente um registo que documenta um conjunto de regras impostas por um interveniente contra um ou vários outros países ou regiões. O interveniente pode ser um país, um estado ou mesmo um município na nossa arquitetura de dados. De um modo geral, o Sitata abrange atualmente dados a nível nacional. No entanto, temos alguns registos estaduais/provinciais para regiões selecionadas, como os Estados Unidos e outras.
Qualquer registo que tenha uma entrada no campo origin_country_division_id ou id_região_do_país_de_origem é aquele que é de nível estadual ou municipal, respetivamente. Se pretender obter dados mais pormenorizados, por favor contactar-nos e podemos falar sobre o seu caso de utilização.
Dedique algum tempo a familiarizar-se com a estrutura de dados dos requisitos de entrada consulte os documentos da nossa API aqui.
Uma parte ligeiramente confusa da estrutura de dados é a nossa utilização do termo "origem." Isto é confuso porque muitas vezes os programadores pensam na origem como sendo o local de origem ou o local de partida. No entanto, o que queremos dizer com origem é, de facto, a origem da regra imposta aos outros, ou seja, o país ou a região que criou a restrição.
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 deve ter visto na documentação, existem várias formas de obter dados da API. De seguida, vamos analisar alguns dos casos de utilização mais comuns.
Existem algumas formas de efetuar este tipo de pedido. A versão mais simples é usar o destino e partida parâmetros. Estes parâmetros aceitam ISO 3166-1 alfa-2 códigos 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. Saberá que uma determinada entrada se refere a um estado se o país_de_origem_divisão tem um valor. Também é possível filtrar para obter apenas dados a nível de estado utilizando o campo divisão_do_país_de_destino parâmetro. Espera um ISO_3166-2 valor. Por exemplo, US-TX para Texas, Estados Unidos.
OBTER https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination_country_division=IN-APNote-se que pode ser mais simples consultar por país e depois filtrar por dados estatais para ver se esses dados existem e utilizá-los se existirem.
Tal como acontece com os países, a API do Sitata pode devolver resultados entre dois aeroportos. Os parâmetros aeroporto_de_partida e aeroporto_de_destino utilizar ICAO ou 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 parte do país de partida correspondente e viaja para o país de destino.
OBTER https://www.sitata.com/api/v2/entry_requirements?departure_airport=MUC&destination_airport=BOMA resposta incluirá todas as restrições (a nível nacional e estatal) necessárias para compreender o viajante que parte do país de partida e viaja para o país de destino.
O Sitata optou por não acomodar consultas por um nome de cidade específico porque isso poderia resultar em conflitos e confusão. Em vez disso, optámos por acomodar a consulta da 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_late 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 transformar as suas cidades em localizações e consultar com base em coordenadas, 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 parte do país de partida 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 é um mapeamento chave/valor de vários bits extra de informação para um requisito específico.
Esta entrada de dados é abrangida pelo requisito de entrada tipo 5. Nesta entrada, o extras conterá um campo chamado dias_de_quarentena que conterá um número inteiro para o número de dias de quarentena impostos.
Esta entrada de dados é abrangida pelo requisito de entrada tipo 8. Nesta entrada, o extras conterá um campo chamado horas_de_entrada que conterá um número inteiro para o número de horas que um teste de covid negativo é permitido antes da entrada.
Pensamos que temos uma solução muito robusta que irá provavelmente responder a todas as suas necessidades para ajudar os viajantes a compreenderem o que é provável que encontrem pelo caminho. Se tiver um caso de utilização específico que não estejamos a abordar, por favor, informe-nos!
Esta entrada faz parte de uma série de duas partes que explica como interagir com a API do Sitata para obter informações sobre requisitos de entrada e restrições de viagem. Até agora, falámos sobre os requisitos de entrada, que descrevem os tipos de requisitos necessários para entrar num país ou região, mas também não falámos sobre o que está a acontecer dentro do país. Uma coisa é saber como entrar num país, outra é saber se é possível circular no país ou visitar as praias ou se existe um recolher obrigatório.
Fique atento à segunda publicação, que irá aprofundar o nosso conjunto de dados sobre restrições de viagem. Dica - é quase idêntico, por isso pode sempre dar uma vista de olhos ao nosso Documentação da API entretanto.
English 
Español 
Français 
Italiano 
Deutsch 
Magyar 
Română 
العربية 
Polski 
Português 
Nederlands 
Svenska 
Suomi 
Norsk bokmål 
Dansk