Muitos de vós podem não saber disto, mas as fundações iniciais do Sitata foram construídas para a detecção precoce de doenças. De facto, o nosso fundador tem uma palestra de TedX de 2016 sobre porque precisamos de avisar os viajantes para ajudar a prevenir a propagação de doenças. Não deve ser surpresa, então, que tenhamos apanhado o COVID-19 quando este foi reportado como um grupo invulgar de casos de pneumonia no início de Dezembro de 2019. Até 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 de negócios. Isto foi dias antes mesmo da Organização Mundial de Saúde!

Durante as inevitáveis precipitações, tivemos uma epifania. A doença estava a alastrar tão rapidamente que ficou claro para nós que a resposta global seria, na melhor das hipóteses, caótica. Cada país promulgaria o seu próprio conjunto de regulamentos e regras de como controlar a propagação. Isto iria inevitavelmente causar estragos nas viagens globais e seria uma enorme fonte de confusão para aqueles que ainda desejam viajar. Tínhamos razão e decidimos fazer algo a esse respeito. A Sitata foi uma das primeiras empresas no mundo a criar um serviço dedicado de API e monitorização para as mudanças nas restrições de viagem e requisitos de entrada em resultado da COVID-19. Com um sistema avançado de software para detecção de eventos e uma equipa dedicada de analistas, já tínhamos todas as ferramentas e processos adequados para o fazer.

Desde o lançamento deste novo serviço, temos tido uma variedade de organizações a tirar partido dos dados em benefício dos seus próprios clientes, incluindo Eddy Travels, Flight Centre e Etihad Airways; e há mais para anunciar em breve! A fim de ajudar mais organizações focadas em viagens a beneficiar desta oferta, escrevemos em detalhe abaixo uma série de exemplos para ajudar a explicar como utilizar o API para uma variedade de casos de utilização. Espero que estas explicações o ajudem a lançar as suas próprias iniciativas.

Requisitos de entrada

Sem dúvida, as primeiras perguntas que um viajante faz são "posso lá ir?" e "ficarei em quarentena" e por isso este é um bom lugar para começar. Criámos o conjunto de dados de Requisitos de Entrada para responder aos tipos de perguntas difíceis "sim/não" relativas à entrada num país ou região.

No momento da redacção deste relatório, este conjunto de dados incluía as seguintes 10 categorias distintas:

• Um residente pode entrar no país?
• Um estrangeiro pode entrar no país?
• É permitido o trânsito através do país?
• É necessário um teste à chegada (surto de doença)?
• É permitido um certificado de teste (surto de doença)?
• É necessária quarentena à chegada (surto de doença)? É necessária uma vacinação?
• Seguro necessário?
• Certificado de teste exigido?
• Formulário de inscrição necessário? (saúde ou outro)

Cada categoria pode ter um dos seguintes valores:

• Sim
• Sim, com excepções
• Não
• Não, com excepções

Embora a grande maioria dos valores sejam "sim" e "não", a situação no terreno nem sempre é tão simples. Por vezes existem regras realmente estranhas e loucas que vários governos puseram em prática e que exigem os tipos de valores "com excepções".

Um requisito de entrada é essencialmente um registo que documenta um conjunto de regras impostas por um actor contra um ou vários outros países ou regiões. O actor pode ser um país, estado, ou mesmo município na nossa arquitectura de dados. De um modo geral, Sitata abrange actualmente dados a nível de país. Contudo, temos alguns registos estatais/provinciais para regiões seleccionadas, tais como os Estados Unidos e outras.

Qualquer registo que tenha uma entrada debaixo do campo origin_country_division_id ou origem_país_região_id é uma que é a nível estadual ou municipal, respectivamente. Se desejar mais dados granulares disponíveis, por favor contacte-nos e podemos falar sobre o seu caso de uso.

Por favor, tome algum tempo para se familiarizar com a estrutura de dados dos Requisitos de Entrada dar uma vista de olhos aos nossos documentos API aqui.

Uma parte um pouco confusa sobre a estrutura de dados é a nossa utilização do termo "origem.” Isto é confuso porque muitas vezes os criadores pensam na origem como sendo o local de origem ou o local de partida. Contudo, o que entendemos por origem é na realidade a origem da regra imposta aos outros, ou seja, o país ou região que criou a restrição.

Outro ponto importante a salientar é como funciona a nossa lista de condados afectados. Se os países afectados estão vazios, deve ser interpretado como uma regra global, ou seja, todos os países são afectados.

Alguns exemplos

Como poderá ter visto pela documentação, há várias formas de recuperar dados do API. A seguir, vamos percorrer alguns dos casos de utilização mais comuns.

Como é que eu consigo os requisitos entre dois países?

Há algumas maneiras de fazer este tipo de pedido. A versão mais simples é utilizar o destino e partida parâmetros. Estes parâmetros aceitam ISO 3166-1 alfa-2 códigos como entradas.

GET https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination=IN

A resposta incluirá todos os requisitos (a nível de país e de estado) necessários para que o viajante que parte do país de partida e viaja para o país de destino.

E se eu quiser dados a nível estatal?

Sitata dispõe de dados a nível estatal para certas regiões. Saberá que uma determinada entrada é para um estado se o origem_do_país_divisão campo tem um valor. Também é possível filtrar para recuperar apenas dados de nível de estado usando o destino_país_divisão parâmetro. Espera um ISO_3166-2 valor. Por exemplo, US-TX para o Texas, Estados Unidos.

GET https://www.sitata.com/api/v2/entry_requirements?departure=DE&destination_country_division=IN-AP

Note-se que pode ser mais simples consultar por país e depois filtrar por dados estatais para ver se tais dados existem, e utilizá-los se existirem.

Como é que eu consigo os requisitos entre dois aeroportos?

Tal como nos países, o Sitata API pode devolver resultados entre dois aeroportos. Os parâmetros departure_airport e destino_aeroporto utilizar ICAO ou IATA códigos para filtrar os resultados. A resposta incluirá todas as restrições (nível de país e de estado) necessárias para que o viajante que parte do país de partida correspondente e viaja para o país de destino.

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

A resposta incluirá todas as restrições (a nível de país e de estado) necessárias para que o viajante que parte do país de partida e viaja para o país de destino possa compreender.

E se eu só tiver informações sobre a cidade?

Sitata optou por não acomodar consultas por um determinado nome de cidade porque isso poderia resultar em conflitos e confusão. Em vez disso, escolhemos acomodar as nossas consultas 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, partida_lng, destino_late destino_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

Se resolver as suas cidades para localizações e consulta com base em coordenadas, o nosso API responderá com todas as restrições (nível de país e estado) necessárias para que o viajante que parte do país de partida e viaja para o país de destino compreenda.

Dados adicionais

Para alguns tipos de Requisitos de Entrada, pode haver dados extra associados num campo do tipo de metadados chamado extras. Este campo é um mapeamento chave/valor de vários pedaços extra de informação para um requisito particular.

Qual é o número de dias de quarentena?

Esta entrada de dados é abrangida pelo requisito de entrada tipo 5. Nesta entrada, o extras cartografia irá conter um campo chamado dias_de_quarentena que conterá um número inteiro para o número de dias de quarentena impostos.

Qual é o número de horas antes da entrada para um teste covid negativo?

Esta entrada de dados é abrangida pelo requisito de entrada tipo 8. Nesta entrada, o extras cartografia irá conter um campo chamado entrada_horas que conterá um número inteiro para o número de horas que um teste covid negativo é permitido antes da entrada.

Avise-nos

Pensamos que temos uma grande robustez que provavelmente responderá a todas as suas necessidades para ajudar os seus viajantes a compreender o que provavelmente irão encontrar ao longo do caminho. Se tiver um caso de uso particular que não estejamos a tratar, por favor, diga-nos!

Espera... há mais!

Esta entrada faz parte de uma série de duas partes que explica como interagir com o Sitata API para requisitos de entrada e informação sobre restrições de viagem. Até agora, temos falado sobre Requisitos de Entrada que esboçam os tipos de requisitos difíceis de sim/não necessários para entrar num país ou região, mas também não temos falado sobre o que está a acontecer no interior do país. Uma coisa é saber sobre entrar num país, outra é compreender se é possível circular no país ou visitar as praias ou se há um recolher obrigatório.

Fique atento ao segundo posto que mergulhará profundamente no nosso conjunto de dados de Restrição de Viagem. Dica - é quase idêntico para que possa sempre dar uma vista de olhos aos nossos Documentação API entretanto.

Por favor, siga e como nós: