Listas de referência geográfica

Listas de referência ajudam você a entender melhor as informações sobre a região geográfica.

As informações geográficas fornecidas nas APIs do Rapid Geography são frequentemente representadas como listas predefinidas ou IDs. Use essas listas de referência para entender o que essas informações sobre a região significam.

Identificação de entidades regionais

O processo de identificação de entidades de regiões geográficas dentro de Rapid API depende de três conceitos fundamentais: tipos de região, categorias e tags. Esses elementos foram projetados para aprimorar a experiência do viajante, melhorando as capacidades de busca, 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, string-based, que são intuitivos de interpretar. Por exemplo, 178921 Tsing Yi é um tipo de região city em Rapid API.
As categorias oferecem um equilíbrio entre especificidade detalhada e ampla aplicabilidade, proporcionando uma estrutura estável, porém versátil, que captura os diversos aspectos de uma região. Por exemplo, 178921 Tsing Yi é categorizado como um city, um tourism region e também como um 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, é etiquetado como city e como um island.

Cada um desses componentes ajuda você a agilizar a descoberta e a exploração de regiões dentro de Rapid API. Eles garantem que seus sistemas possam encontrar e interagir com regiões geográficas de maneira significativa e eficiente.

Tipos de região

A geografia é categorizada por tipo de região, e as regiões são categorizadas pela entidade geográfica que representam. No campo APIs de Geografia Rápida ](lodging/geography/about-geography-api this representation is provided in the type.

Tipo	Descrição
`continent`	Grandes continentes como a Europa, a Ásia ou a América do Sul. Consulte a seção das regiões de nível superior abaixo para ver a lista de continentes.
`country`	Nações como os Estados Unidos da América, a Austrália ou a Alemanha. 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. Consulte a seção das regiões de nível superior abaixo para ver a lista de países.
`province_state`	Áreas administrativas dentro de um país, como o estado da Califórnia ou a província de Nova Gales do Sul. Inclui áreas administrativas de nível inferior, como condados e departamentos de um país.
`high_level_region`	Regiões turísticas como o Alto Reno na Alemanha ou o Wine Country na Califórnia.
`multi_city_vicinity`	Áreas metropolitanas maiores que contêm uma cidade primária e os seus arredores, como Cairo e os seus arredores. Seus limites de polígonos são definidos de maneira ampla com base no valor turístico.
`city`	Áreas urbanas como Bellevue, Washington. Uma cidade pode existir em áreas metropolitanas maiores, como Londres. Nesse caso, a cidade vai abranger uma área menor que a `multi_city_vicinity` equivalente. Como `city` é nossa unidade fundamental de cobertura geográfica, cada propriedade que contratamos deve ser vinculado a um. Os limites do polígono da cidade são definidos com base em fontes administrativas oficiais.
`neighborhood`	Áreas geográficas menores que uma cidade, como o Centro Histórico, em Bonn, Alemanha. Os limites do polígono de vizinhança são baseados em valor turístico, não em definições administrativas.
`airport`	Aeroportos como o LHR (London Heathrow).
`point_of_interest`	Lugares como museus, centros de convenções, praias e parques. Esta lista vai além das atrações turísticas óbvias para cobrir uma grande variedade de lugares, como o Centro de Exposições de Xangai, o Capitólio do Estado do Texas ou o Zoológico de Praga.
`train_station`	Estações de trem como a Grand Central Station, em Nova York.
`metro_station`	Estações de metrô, como a estação de Avtovo em São Petersburgo, Rússia.
`bus_station`	Rodoviárias como Port Authority Bus Terminal em Nova York, NY, EUA.

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. Uma região pode ser associada a múltiplas categorias top-level quando relevante. Essas categorias são intencionalmente self-explanatory, garantindo uma compreensão clara sem exigir contexto adicional.

Sequência hierárquica	Valor da categoria
1	`place:administrative`
1	`place:service`
1	`place:tourism`
1	`place:transport`
2	`administrative:city`
2	`administrative:province`
2	`administrative:subProvince1`
2	`administrative:subProvince2`
2	`administrative:subProvince3`
2	`administrative:subProvince4`
2	`administrative:village`
2	`service:embassy`
2	`service:medicalClinic`
2	`tourism:metropolitanArea`
2	`tourism:neighborhood`
2	`tourism:placeOfInterest`
2	`tourism:region`
2	`tourism:restrictedRegion`
2	`tourism:route`
2	`transport:airport`
2	`transport:busStation`
2	`transport:heliport`
2	`transport:metroStation`
2	`transport:trainStation`
3	`neighborhood:subdivision`
3	`placeOfInterest:attraction`
3	`placeOfInterest:landmark`
3	`placeOfInterest:nature`
3	`placeOfInterest:shopping`
3	`placeOfInterest:social`
4	`attraction:adventureActivity`
4	`attraction:amusementRide`
4	`attraction:aquarium`
4	`attraction:artGallery`
4	`attraction:botanicalGarden`
4	`attraction:cableCar`
4	`attraction:campground`
4	`attraction:casino`
4	`attraction:conventionCenter`
4	`attraction:fairground`
4	`attraction:golf`
4	`attraction:miniGolf`
4	`attraction:museum`
4	`attraction:onsen`
4	`attraction:outdoor`
4	`attraction:park`
4	`attraction:racetrack`
4	`attraction:ski`
4	`attraction:spa`
4	`attraction:stadium`
4	`attraction:theater`
4	`attraction:themePark`
4	`attraction:trailAccess`
4	`attraction:waterPark`
4	`attraction:zoo`
4	`landmark:boardwalk`
4	`landmark:bridge`
4	`landmark:building`
4	`landmark:businessArea`
4	`landmark:castle`
4	`landmark:cemetery`
4	`landmark:education`
4	`landmark:esplanade`
4	`landmark:historicSite`
4	`landmark:library`
4	`landmark:lighthouse`
4	`landmark:lookout`
4	`landmark:marina`
4	`landmark:military`
4	`landmark:monument`
4	`landmark:placeOfWorship`
4	`landmark:square`
4	`landmark:townHall`
4	`landmark:visitorCenter`
4	`nature:archipelago`
4	`nature:beach`
4	`nature:canyon`
4	`nature:cave`
4	`nature:desert`
4	`nature:forest`
4	`nature:glacier`
4	`nature:mountain`
4	`nature:valley`
4	`nature:waterBody`
4	`nature:waterfall`
4	`shopping:area`
4	`shopping:center`
4	`shopping:famousShop`
4	`shopping:market`
4	`social:bar`
4	`social:brewery`
4	`social:cafe`
4	`social:distillery`
4	`social:restaurant`
4	`social:venue`
4	`social:winery`
5	`museum:art`
5	`museum:aviation`
5	`museum:childrens`
5	`museum:history`
5	`museum:holocaust`
5	`museum:industrial`
5	`museum:maritime`
5	`museum:military`
5	`museum:music`
5	`museum:naturalHistory`
5	`museum:railway`
5	`museum:science`
5	`museum:sports`
5	`museum:transport`
5	`museum:wax`
5	`park:national`
5	`park:natureReserve`
5	`ski:lift`
5	`ski:shuttle`
5	`waterBody:bay`
5	`waterBody:hotSpring`
5	`waterBody:lake`
5	`waterBody:river`

Etiquetas de região

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

Tag
`activity:vineyard`
`activity:skiShuttle`
`activity:skiLift`
`activity:nationalPark`
`activity:generic`
`activity:childrensMuseum`
`attraction:generic`
`civic:medicalCentre`
`civic:generic`
`civic:embassyConsulate`
`civic:conventionCentre`
`cultural:waxMuseum`
`cultural:transportMuseum`
`cultural:sportsMuseum`
`cultural:scienceMuseum`
`cultural:railwayMuseum`
`cultural:opera`
`cultural:naturalHistoryMuseum`
`cultural:musicMuseum`
`cultural:militaryMuseum`
`cultural:maritimeMuseum`
`cultural:industrialMuseum`
`cultural:holocaustMuseum`
`cultural:historyMuseum`
`cultural:generic`
`cultural:aviationMuseum`
`cultural:artMuseum`
`entertainment:generic`
`geo-admin:suburb`
`geo-admin:subProvince`
`geo-admin:state`
`geo-admin:regency`
`geo-admin:prefecture`
`geo-admin:parish`
`geo-admin:municipality`
`geo-admin:local-authority`
`geo-admin:lander`
`geo-admin:federal-subject`
`geo-admin:emirate`
`geo-admin:district`
`geo-admin:department`
`geo-admin:county`
`geo-admin:canton`
`geo-admin:borough`
`geo-admin:autonomous-region`
`geo-admin:autonomous-community`
`landmark:historicPlace`
`landmark:generic`
`meta:fakeRegion`
`naturalFeature:waterFeature`
`naturalFeature:island`
`naturalFeature:generic`
`route:skiRun`
`route:scenicDrive`
`route:footpath`
`route:cyclingRoute`
`shopping:shoppingCentre`
`shopping:shoppingArea`
`social:generic`
`tourism:resort`
`tourism:event`

Top-level regiões

Regiões no topo da hierarquia são normalmente usadas na API de Geografia.

Com a API de Geografia, você pode solicitar todas as regiões em um continente, país ou outro nível específico, fornecendo o ID da região correspondente.

>> Saiba mais sobre a API de Geografia

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

Continentes

Nome	ID
África e Oceano Índico	6023185
Antártida	11700
Ásia	6023099
Austrália, Nova Zelândia e Pacífico Sul	6023180
Caribe	6022969
Europa	6022967
México e América Central	6023181
Oriente Médio	6023182
América do Norte	500001
América do Sul	6023117

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.

Nome	ID
Albânia	2
Argélia	3
Samoa Americana	11399
Andorra	4
Angola	5
Anguila	6
Antígua e Barbuda	7
Argentina	8
Armênia	11398
Aruba	9
Austrália	10
Áustria	11
Azerbaijão	12
Bahamas	13
Bahrain	14
Bangladesh	15
Barbados	16
Bielorrússia	11401
Bélgica	17
Belize	18
Benim	19
Bermuda	20
Butão	11400
Bolívia	21
Bonaire, Santo Eustáquio e Saba	6143084
Bósnia e Herzegovina	11414
Botsuana	22
Ilha Bouvet	11702
Brasil	23
Território Britânico do Oceano Índico	11704
Ilhas Virgens Britânicas	24
Brunei	25
Bulgária	26
Burquina Fasso	27
Burundi	28
Camboja	29
Camarões	30
Canadá	31
Cabo Verde	32
Ilhas Cayman	33
Chade	35
Chile	36
China	37
Ilha Christmas	11706
Ilhas Cocos	11708
Colômbia	38
Comores	39
Ilhas Cook	41
Costa Rica	42
Costa do Marfim	87
Croácia	43
Cuba	44
Curaçao	6143269
Chipre	45
República Tcheca	46
República Democrática do Congo	198
Dinamarca	47
Djibouti	48
Dominica	49
República Dominicana	50
Equador	51
Egito	52
El Salvador	53
Guiné Equatorial	54
Eritreia	11402
Estônia	55
Etiópia	56
Ilhas Falkland	11711
Ilhas Faroé	11714
Estados Federados da Micronésia	118
Fiji	57
Finlândia	58
França	59
Guiana Francesa	60
Polinésia Francesa	61
Terras Austrais e Antárticas Francesas	11712
Gabão	62
Gâmbia	63
Geórgia	11403
Alemanha	64
Gana	65
Gibraltar	66
Grécia	67
Groenlândia	11107
Granada	68
Guadalupe	69
Guam	70
Guatemala	71
Guiné	72
Guiné-Bissau	73
Guiana	74
Haiti	75
Ilhas Heard e McDonald	11713
Honduras	76
RAE de Hong Kong	77
Hungria	78
Islândia	79
Índia	80
Indonésia	81
Irlanda	84
Israel	85
Itália	86
Jamaica	88
Japão	89
Jordânia	90
Cazaquistão	91
Quênia	92
Kiribati	93
Kuwait	95
Quirguistão	11404
Laos	96
Letônia	97
Líbano	98
Lesoto	99
Libéria	100
Líbia	101
Liechtenstein	11405
Lituânia	102
Luxemburgo	103
RAE de Macau	104
Madagáscar	106
Malawi	107
Malásia	108
Maldivas	109
Mali	110
Malta	111
Ilhas Marshall	11407
Martinica	113
Mauritânia	114
Ilhas Maurício	115
Maiote	116
México	117
Moldávia	11406
Mônaco	120
Mongólia	11408
Montenegro	6051403
Montserrat	121
Marrocos	122
Moçambique	123
Birmânia	124
Namíbia	125
Nauru	126
Nepal	127
Holanda	129
Nova Caledônia	131
Nova Zelândia	133
Nicarágua	134
Níger	135
Nigéria	136
Niuê	11409
Ilha Norfolk	137
Ilhas Marianas Setentrionais	112
Noruega	138
Omã	139
Paquistão	140
Palau	141
Territórios Palestinos	11726
Panamá	142
Papua Nova Guiné	132
Paraguai	143
Peru	144
Filipinas	145
Ilhas Pitcairn	11718
Polônia	146
Portugal	147
Porto Rico	148
Catar	149
República da Macedônia do Norte (FYR da Macedônia)	105
República do Congo	40
Reunião	150
Romênia	151
Rússia	153
Ruanda	154
Samoa	155
San Marino	11720
São Tomé e Príncipe	156
Arábia Saudita	157
Senegal	158
Sérvia	197
Seychelles	159
Serra Leoa	160
Singapura	161
São Martinho (Países Baixos)	6143274
Eslováquia	162
Eslovênia	11413
Ilhas Salomão	163
África do Sul	165
Coreia do Sul	94
Espanha	166
Sri Lanka	167
São Bartolomeu	6069953
Santa Helena	11721
São Cristóvão e Névis	130
Santa Lúcia	168
São Martinho	6069955
Saint-Pierre e Miquelon	11719
São Vicente e Granadinas	169
Sudão	170
Suriname	171
Svalbard	11722
Suazilândia	172
Suécia	173
Suíça	174
Taiwan	176
Tajiquistão	11410
Tanzânia	177
Tailândia	178
Togo	179
Toquelau	11723
Tonga	180
Trinidad e Tobago	181
Tunísia	182
Turquia	183
Turcomenistão	11411
Turcas e Caicos	184
Tuvalu	185
Ilhas Virgens Americanas	186
Uganda	187
Ucrânia	188
Emirados Árabes Unidos	189
Reino Unido	190
Estados Unidos da América	201
Uruguai	191
Ilhas Menores Distantes dos Estados Unidos	6190474
Uzbequistão	11412
Vanuatu	192
Cidade do Vaticano	11724
Venezuela	193
Vietnã	194
Wallis e Futuna	11725
Zâmbia	199
Zimbábue	200