Geografia

Com as APIs de geografia, você tem acesso às definições geográficas e aos mapeamentos da propriedade para todas as 600 mil 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 o seu banco de dados de mapeamento de propriedades se você mantiver as suas próprias definições geográficas e não usar as regiões geográficas da Rapid. É 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

Esses parâmetros permitem filtrar mais os resultados para que clientes possam fazer buscas mais precisas.

supply_source indica se as propriedades são originárias da Expedia ou da Vrbo. Quando não é incluído, esse filtro usa o padrão supply_source=expedia.
country_code permite filtrar os resultados por país.
type explica a entidade geográfica representada, como uma cidade ou área.
country_subdivision_code permite filtrar para a subdivisão de país ISO 3166-2.
area permite buscar 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 só usa pares hifenizados de códigos de dois dígitos referentes a idioma e país. Consulte todas as opções de idioma aqui. 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 (por exemplo, ponto de interesse, estação de trem, aeroporto etc.) 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.
Os principais pontos de interesse (POI) para uma região específica. Isso permite recomendar Pontos de Interesse 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.

Com tags e categories, os parceiros conseguem dar informações mais detalhadas aos clientes sobre as características geográficas.

tags dão mais detalhes sobre os recursos geográficos ao incluir descrições que refletem como eles se chamam 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 criam uma hierarquia global de características para oferecer níveis geográficos comparáveis, seja qual for a estrutura governamental de cada país ou região. Os exemplos incluem continente, país ou província.

Observação: os parceiros com várias fontes de fornecimento vão precisar colocar os próprios dados na geografia que pretendem 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, state_province, 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.

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.