Listas de referência geográfica

Listas de referência são disponibilizadas para ajudar você a entender melhor as informações da região geográfica.

De maneira geral, as informações geográficas exibidas pelas APIs de geografia da Rapid são representadas como listas ou IDs predefinidos. Use essas listas de referência para entender o que essas informações sobre a região significam.

Identificando Entidades Regionais

O processo de identificação de entidades de regiões geográficas no Rapid depende de três conceitos fundamentais: tipos de região, categorias e tags. Esses elementos são projetados para refinar a experiência do usuário, aprimorando os recursos de pesquisa, destacando atrações locais e facilitando o planejamento de itinerários. Suas funções são as seguintes:

• Os tipos de região esclarecem a natureza de um local por meio de identificadores simples, baseados em sequências de caracteres, que são intuitivos de interpretar. Por exemplo, 178921 Tsing Yi é um tipo de região city em Rapid.

• As categorias oferecem um equilíbrio entre especificidade detalhada e ampla aplicabilidade, fornecendo uma estrutura estável, porém versátil, que captura os diversos aspectos de uma região. Por exemplo, 178921 Tsing Yi é categorizado como city, tourism region e também como point of interest para entusiastas da natureza.
• As tags servem como metadados estruturados para identificar as características definidoras de uma região. 178921 Tsing Yi, por exemplo, é marcado como city e como island.

Cada um desses componentes desempenha um papel fundamental na otimização da descoberta e exploração de regiões dentro do Rapid, garantindo que os sistemas parceiros possam encontrar e interagir com regiões geográficas de maneira significativa e eficiente.

Tipos de região

A geografia é categorizada por tipos de região.

As regiões são categorizadas pela entidade geográfica representada. Nas APIs de geografia da Rapid, essa representação é exibida no campo type.

Lista de referência

Categorias de região

As categorias oferecem uma abordagem confiável e adaptável para compreender as várias facetas de uma região, enquanto o tipo de região fornece apenas uma visão geral de alto nível. Uma região pode ser associada a várias categorias de nível superior quando relevante. Essas categorias são intencionalmente autoexplicativas, garantindo uma compreensão clara sem exigir contexto adicional.

Lista de referência

Etiquetas de região

Tags são metadados estruturados. Eles são utilizados para identificar as características definidoras de uma região, criando um índice pesquisável que melhora a capacidade de descoberta e recuperação de informações.

Lista de referência

Regiões de nível superior

Em geral, as regiões no nível superior da hierarquia são usadas na API de regiões.

Na API de regiões da Rapid, você pode solicitar todas as regiões de um continente, país ou outro nível específico inserindo o ID da região.

Os IDs de região dos continentes e países estão indicados abaixo.

Continentes

Países

Os países são definidos no sentido geográfico, que pode ser diferente do sentido político. Por exemplo, Guadalupe é um departamento francês no Caribe. Essa região é francesa em termos políticos, mas tem a sua própria entidade geográfica.