Beaucoup d'entre vous ne le savent peut-être pas, mais les premières fondations de Sitata ont été construites pour la détection précoce des maladies. De facto, a nossa fundadora organizou um discurso TedX a partir de 2016 sobre as razões pelas quais devemos evitar os viajantes a fim de prevenir a propagação de doenças. Il n'est donc pas surprenant que nous ayons appris l'existence du COVID-19, qui a été signalé comme un groupe inhabituel de cas de pneumonie au début du mois de décembre 2019. Le 2 janvier 2020, notre équipe de santé a décidé que nous devions émettre un primeira advertência aos nossos viajantes e parceiros comerciais. Era apenas alguns dias antes da Organização Mundial da Saúde!
Durante as inevitáveis retomas, tivemos uma revelação. A doença propagou-se tão rapidamente que ficou claro para nós que a resposta mundial seria, no mínimo, caótica. Cada país promulgará as suas próprias normas e regras para controlar a propagação. Isso causaria inevitavelmente estragos em todo o mundo e seria uma fonte enorme de confusão para aqueles que quisessem viajar. Temos razão e decidimos fazer alguma coisa para nos livrarmos disso. A Sitata foi uma das primeiras empresas do mundo a criar uma API dedicada e um serviço de acompanhamento das alterações aplicadas às restrições de viagem e às condições de entrada na sequência da COVID-19. Graças a um sistema lógico avançado de deteção de eventos e a uma equipa de analistas especializados, dispomos já de todos os utensílios e processos necessários para o nosso avanço.
Desde o lançamento deste novo serviço, várias organizações já tiraram partido dos dados em benefício dos seus próprios clientes, nomeadamente a Eddy Travels, a Flight Centre e a Etihad Airways; outras informações serão anunciadas em breve! Para ajudar um número ainda maior de organizações com foco em viagens a tirar proveito desta oferta, nós criamos em detalhes um certo número de exemplos para explicar como utilizar a API em diversos casos de uso. Esperamos que estas explicações vos ajudem a concretizar as vossas próprias iniciativas.
As primeiras questões que um viajante coloca são, sem dúvida, as seguintes: "Posso ir para o estrangeiro?" e "Vou ficar na quarentena", ou seja, é um bom ponto de partida. Criámos um conjunto de dados sobre as condições de entrada para responder a perguntas difíceis do tipo "oui/non" relativas à entrada num país ou numa região.
No momento da redação do presente documento, este conjunto de dados incluía as seis categorias distintas seguintes
Cada categoria pode ter um dos seguintes valores :
Se a grande maioria dos valores são "oui" e "non", a situação no terreno não é tão simples como isso. Por vezes, existem regras muito bizarras e duvidosas que vários governos aplicam e que exigem os tipos de valores "com excepções"
Uma condição de entrada é essencialmente um documento que documenta um conjunto de regras impostas por um ator em relação a um ou mais países ou regiões. O ator pode ser um país, um Estado ou mesmo um município na nossa arquitetura de dados. No seu conjunto, o Sitata abrange atualmente os dados ao nível dos países. No entanto, dispomos de alguns registos de estados/províncias para certas regiões, como os Estados Unidos e outras
Qualquer registo que inclua uma entrada no campo origine_pays_division_id ou origine_pays_région_id é um nível que se situa respetivamente no nível do Estado ou no nível municipal. Se pretender dispor de dados mais pormenorizados, queira contacte-nos e podemos falar sobre o seu caso de utilização.
É necessário dedicar algum tempo a familiarizar-se com a estrutura dos dados das condições de acesso ao consultor os nossos documentos API ici.
Uma parte da estrutura dos dados é bastante déroutante, nomeadamente a nossa utilização do termo"origem" Cette confusion est due au fait que les développeurs considèrent souvent l'origine comme étant le lieu d'origine ou le lieu de départ. Ou, o que entendemos por "origem" é, de facto, a origem da regra imposta a 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 você pôde constatar na documentação, existem várias maneiras de recuperar os dados da API. A seguir, vamos passar em revista alguns casos de utilização mais actuais.
Existem várias formas de efetuar este tipo de pedido. A versão mais simples consiste em utilizar o destino et partida parâmetros. Estes parâmetros aceitam os códigos ISO 3166-1 alfa-2 comme entrées
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 ao nível do Estado para determinadas regiões. Pode afirmar que uma entrada específica é para um Estado se o divisão_de_pagamentos_de_origem a une valeur. Também pode filtrar para não recolher mais do que os dados ao nível do estado, utilizando o botão destino_paga_divisão paramètre. Ele apresenta um valor ISO_3166-2. Por exemplo, US-TX para o Texas, Estados Unidos.
OBTER https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination_country_division=IN-APNotez qu'il pourrait être plus simple d'effectuer une recherche par pays, puis de filtrer les données par État pour voir si ces données existent, et de les utiliser si elles existent.
Tal como para os países, a API Sitata pode comparar os resultados entre dois aeroportos. Os parâmetros départ_aéroport et destino_aéroport utilizar os códigos de l'OACI ou de l'IATA para filtrar os resultados. A resposta inclui todas as restrições (a nível do país e do Estado) necessárias para a compreensão do viajante que parte do país de partida correspondente e se encontra no país de destino.
OBTER https://www.sitata.com/api/v2/entry_requirements?departure_airport=MUC&destination_airport=BOMA resposta compreende todas as restrições (a nível do país e do Estado) necessárias para o viajante que parte do país de partida e se instala no país de destino.
O Sitata optou por não responder a pedidos que envolvam um nome de cidade em particular, uma vez que tal poderia originar conflitos e confusões. Em vez disso, optámos por aceitar os pedidos da nossa API por coordenadas de latitude e de longitude, o que não produz qualquer ambiguidade no nosso conjunto de resultados. Os parâmetros são os seguintes départ_lat, local de partida, destino_latet 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 resolverem as vossas vilas em função dos locais e os vossos pedidos em função das coordenadas, a nossa API responde a todas as restrições (a nível do país e do Estado) necessárias à compreensão do viajante que parte do país de partida e regressa ao país de destino.
Para certos tipos de condições de entrada, é possível obter dados suplementares associados a uma categoria de tipo de métadonnées denominada extras. Este campo é um mapa de valor de vários elementos de informação suplementares para uma exigência específica
Esta recolha de dados está sujeita à obrigação de recolha de dados tipo 5. Nesta entrada, o extras a cartografia contém um campo denominado quarantaine_days que contém um número inteiro para o número de dias de quarentena impostos.
Esta recolha de dados está sujeita à obrigação de recolha de dados tipo 8. Nesta entrada, o extras a cartografia contém um campo denominado horas_de_entrada que contém um número inteiro para o número de horas durante as quais é autorizado um teste negativo de covid antes da entrada.
Pensamos que dispomos de um utensílio muito robusto que responderá provavelmente a todas as vossas necessidades para ajudar os vossos viajantes a compreenderem o que são susceptíveis de encontrar no decurso da rota. Se tiver um caso de utilização específico que não tratamos, contacte-nos saber!
Esta entrada faz parte de uma série de duas partes que explicam como interagir com a API Sitata para obter informações sobre as condições de entrada e as restrições de viagem. Até à data, falámos das condições de entrada que descrevem os tipos de condições estritas de tipo oui/non necessárias para entrar num país ou numa região, mas não falámos ainda do que se passa no interior do país. É uma escolha para saber como entrar num país, outra para saber se é possível deslocar-se no país ou visitar as praias ou se existe um couvre-feu obrigatório.
Continue a ler o segundo artigo que aborda a nossa série de dados sobre as restrições de viagem. Atenção: é praticamente idêntico, pode também consultar o nosso documentação sobre a API e assistente.
English 
Español 
Français 
Italiano 
Deutsch 
Magyar 
Română 
العربية 
Polski 
Português 
Nederlands 
Svenska 
Suomi 
Norsk bokmål 
Dansk