Geografia

As APIs de Geografia Rápida fornecem acesso a configurações geográficas e mapeamentos propriedade para mais de 600.000 regiões e aeroportos.

Regiões

Mostra a definição geográfica e os mapeamentos de propriedades de regiões que correspondem aos parâmetros especificados.

Para solicitar todas as regiões do mundo, omita o parâmetro de consulta do ancestral. Para solicitar todas as regiões em um continente, país ou outro nível específico, especifique o ID daquela região como o ancestral. Consulte a lista de regiões de nível superior abaixo.

Região

Mostra a definição geográfica e os mapeamentos de propriedades do ID da região solicitado.

Use esta API para recuperar informações geográficas e mapeamentos da propriedade de um ID de região conhecido.

Busca de propriedades dentro da definição geográfica

Mostra as propriedades em um polígono personalizado com base nas suas definições geográficas.

Use esta API para criar seu banco de dados de mapeamento propriedade se você mantiver suas próprias configurações de geografia e não usar as regiões geográficas Rapid API. É uma maneira fácil de mapear propriedades nas suas definições geográficas de áreas como regiões metropolitanas, cidades e vizinhanças.

Parâmetros de filtro de busca

Três parâmetros de pesquisa permitem que os viajantes filtrem ainda mais seus resultados e sejam mais precisos em suas pesquisas.

supply_source: Indica se as propriedades são provenientes da Expedia ou da Vrbo. Quando não é incluído, esse filtro usa o padrão supply_source=expedia.
country_code: Permite filtrar resultados por país.
type: Explica a entidade geográfica representada, como cidade ou bairro.
country_subdivision_code: Permite filtrar para a subdivisão de país ISO 3166-2.
area: Permite pesquisar por geografia. Mais informações abaixo.

Mais informações de referência

Tipos de região

O objeto type explica a entidade geográfica representada, como uma cidade ou vizinhança. Consulte a lista de tipos de região para descrições detalhadas.

Área

O objeto area pode ser usado em conjunto com um raio de quilometragem e coordenadas de latitude/longitude central ou a fronteira de uma região.

O raio combinado com region_id buscaria uma área que se estende pelo número de quilômetros especificado a partir dos limites da região em todas as direções.
O raio combinado com um único ponto, especificado por um par de latitude/longitude, buscaria uma área em um círculo com o raio de quilometragem especificado.
O raio deve ser especificado em quilômetros inteiros não negativos. Decimais geram erro. Um raio de 0 é permitido.

Restrições

Ao especificar o parâmetro de área, há um limite de 100 resultados, que pode ser reduzido ainda mais pelo parâmetro de limite.
Devido ao número de resultados, a menos que point_of_interest seja especificado como o único type, as regiões do tipo point_of_interest não vão ser incluídas em uma solicitação que filtra para um objeto area.
Se point_of_interest for fornecido junto com outros tipos, point_of_interest vai ser ignorado sem erros e todas as outras seleções type vão ser aplicadas.

Exemplos:

Busca de aeroporto dentro de 50 km da latitude/longitude:

type=airport&limit=3&area=50,37.227924,93.310036

Busca de área com ID de região para o type de cidade com um limite de 3 e área de 5 km:

&area=5,602962&supply_score=expedia&type=city&limit=3

Código de subdivisão de país

Filtre os resultados apenas para a subdivisão de país ISO 3166-2, por exemplo, US-MO. country_subdivision_code é um campo e um parâmetro de busca.

Exemplo:

Busca de região por código ISO:

country_subdivision_code =US-MO

Localização

O objeto language usa apenas pares hifenizados de códigos de idioma e país two-digit, veja a lista de opções de idioma disponíveis . Revise os nossos idiomas compatíveis antes de integrar códigos. Apenas os campos name e name_full nas respostas são exibidos no idioma solicitado. Todas as outras definições geográficas na resposta vão ficar em inglês.

Polígonos

O objeto bounding_polygon mostra a lista de coordenadas que abrange o formato da região. As regiões podem cobrir áreas representadas por um único polígono ou vários. Os tipos de região representados por uma única coordenada (como ponto de interesse, estação de trem ou aeroporto) não têm um polígono delimitador.

Ao disponibilizar listas de coordenadas, o objeto bounding_polygon segue o padrão GeoJSON, com o valor de longitude primeiro, seguido pela latitude.

Associações entre regiões

A relação turística entre regiões é indicada pelo objeto associations. Dentro do objeto associations, modelamos:

A cidade associada pela região do tipo de aeroporto. Isso permite que você recomende um destino para qualquer aeroporto.
Principais pontos de interesse de uma determinada região. Isso permite que você recomende lugares para visitar quando um viajante estiver visitando uma região específica, como Califórnia, Londres ou Brooklyn.

Hierarquia entre regiões

A relação entre regiões é indicada pelos objetos ancestors e descendants. Devido às variações geográficas e políticas existentes no mundo, os tipos de região não têm uma hierarquia estrita. No entanto, em geral, uma cidade é associada à área metropolitana, à província/ao estado ou ao país. Para derivar a hierarquia de uma região específica, use os valores ancestors.

ancestors: Representa os níveis de hierarquia acima de uma determinada região. Por exemplo, o ancestral direto da área metropolitana de Atenas, Grécia, é a região da Ática, e mais acima na hierarquia, os seus ancestrais incluem a Grécia e a Europa. Uma região pode ter mais de um pai. Como a área metropolitana de Genebra está na fronteira da Suíça com a França, a área vai ter ancestrais em ambos os países.
descendants: Representa os níveis de hierarquia abaixo de uma determinada região. Em nosso exemplo, a cidade de Pireu, Grécia, é uma descendente da área metropolitana de Atenas, Grécia. O mapa dos descendentes em um objeto de região só contém os filhos diretos (um nível abaixo) dessa região.

Para fornecer informações mais detalhadas sobre características geográficas, use tagse categories:

tags: Forneça detalhes mais granulares sobre características geográficas descrevendo-as de uma forma que reflita como essas características são nomeadas na vida real. Os exemplos incluem descrições de atividades (esqui, pista de corrida etc.), atrações, áreas cívicas ou regiões administrativas geográficas como um cantão, paróquia ou distrito.
categories: Crie uma hierarquia globalmente aplicável de características geográficas e tenha como objetivo oferecer níveis geográficos comparáveis, independentemente da estrutura governamental de qualquer país ou região. Os exemplos incluem continente, país ou província.

Observação: se sua implementação tiver várias fontes de fornecimento, você precisará colocá-las em camadas na geografia que deseja usar.

Exemplo:

"categories": [
"place:administrative",
"administrative:country"
],
"tags": [
"geo-admin:country"
]

Mapeamentos de propriedades das regiões

Os mapeamentos de propriedades estão disponíveis para a região e a API de regiões. Os tipos de região com mapeamentos de propriedade são: high_level_region, province_state, multi_city_vicinity, city, neighborhood, point_of_interest e países selecionados. Mapeamentos da propriedade estão disponíveis em duas opções de parâmetro include:

property_ids: essa opção mostra apenas as propriedades dentro do polígono da região. O polígono é a forma da fronteira que representa a área da região.
property_ids_expanded: se o polígono da região não contiver, pelo menos, 100 propriedades, essa opção vai mostrar as propriedades dentro do polígono, além das propriedades a 30 km de distância da região. Esse conjunto expandido de propriedades deve garantir que propriedades suficientes sejam apresentadas nos resultados de busca de propriedades para um destino. Para tipos de região representados por uma única coordenada em vez de um polígono (um ponto de interesse, por exemplo), apenas essa opção expandida vai mostrar os mapeamentos de propriedades associados.

Para tipos de região maiores (high_level_region, province_state, countrye continent), até as 500 principais propriedades serão retornadas. Para obter uma lista completa de propriedades nessas regiões, você precisará solicitar propriedades de cada um dos descendentes que compõem a região maior.

Os polígonos são otimizados para usar dados de busca e transação e vão expandir regiões menores fora do polígono onde forem mais relevantes.

Detalhes da API

Explore as definições dos pontos de extremidade relacionados à geografia nesta página e use o API Explorer ou outro software de teste para comparar os exemplos e as definições de esquemas com o resultado real.

Recursos adicionais

Não importa se deseja testar todos os pontos de extremidade da Rapid API, ou baixar a especificação OpenAPI ou a nossa coleção Postman Collection, você pode contar conosco.