Listas de referencias geográficas

Las listas de referencias te ayudan a entender mejor la información sobre la geografía de la región.

La información geográfica que ofrecen las API de Rapid Geography suele presentarse en forma de listas predefinidas o identificadores. Usa estas listas de referencia para comprender el significado de la información de la región.

Identificar las entidades de la región

El proceso para identificar entidades de regiones geográficas en Rapid API se basa en tres conceptos fundamentales: tipos de regiones, categorías y etiquetas. Estos elementos están pensados para mejorar la experiencia del viajero, optimizando las funciones de búsqueda, destacando los lugares de interés locales y facilitando la planificación del itinerario. Sus funciones son las siguientes:

Los tipos de región aclaran la naturaleza de una ubicación mediante identificadores sencillos y « string-based » que son fáciles de entender. Por ejemplo, 178921 Tsing Yi es una región de tipo « city » en Rapid API.
Las categorías ofrecen un equilibrio entre la especificidad detallada y la amplia aplicabilidad, lo que proporciona un marco estable y a la vez versátil que recoge los diversos aspectos de una región. Por ejemplo, 178921 Tsing Yi está clasificado como un « city », un « tourism region » y también como un « point of interest » para los amantes de la naturaleza.
Las etiquetas sirven como metadatos estructurados para identificar las características que definen una región. 178921 Tsing Yi, por ejemplo, está etiquetado tanto como « city » como «»island.

Cada uno de estos componentes te ayuda a agilizar el descubrimiento y la exploración de regiones dentro de Rapid API. Se encargan de que tus sistemas puedan localizar y relacionarse con regiones geográficas de forma eficaz y con sentido.

Tipos de región

La geografía se clasifica por tipo de región, y las regiones se clasifican según la entidad geográfica que representan. En el campo «](lodging/geography/about-geography-api this representation is provided in the type» de las API de Rapid Geography.

Tipo	Descripción
`continent`	Grandes masas continentales, como Europa, Asia o Sudamérica. Consulta la sección Regiones de nivel superior que aparece abajo para ver la lista de continentes.
`country`	Estados nacionales, como los Estados Unidos de América, Australia o Alemania. Los países se definen desde el punto de vista geográfico, no necesariamente desde el punto de vista político. Por ejemplo, Guadalupe es un departamento francés ubicado en el Caribe. Esta región es francesa desde el punto de vista político, pero tiene su propia entidad geográfica. Consulta la sección Regiones de nivel superior que aparece abajo para ver la lista de países.
`province_state`	Áreas administrativas dentro de un país, como el estado de California o la provincia de Nueva Gales del Sur. También se incluyen las áreas administrativas de nivel inferior, como los condados y departamentos que pertenecen a un país.
`high_level_region`	Regiones turísticas, como el Alto Rin en Alemania o Wine Country en California.
`multi_city_vicinity`	Áreas metropolitanas más extensas que contienen una ciudad principal y barrios residenciales circundantes, como El Cairo y su periferia. Las delimitaciones del polígono se definen de manera flexible en función del valor turístico.
`city`	Áreas urbanas, como Bellevue, Washington. Puede que haya una ciudad con un área metropolitana más extensa, como Londres. En ese caso, la ciudad abarcará un área menos extensa que la `multi_city_vicinity` relacionada. Como « `city` » es nuestra unidad básica de cobertura geográfica, cada propiedad que contratemos tiene que estar vinculada a una de ellas. Las delimitaciones del polígono de las ciudades se definen en función de las fuentes administrativas oficiales.
`neighborhood`	Áreas geográficas menos extensas que una ciudad, como el centro histórico de Bonn, Alemania. Las delimitaciones del polígono de los barrios se basan en el valor turístico, no en las definiciones administrativas.
`airport`	Aeropuertos, como LHR (Londres Heathrow).
`point_of_interest`	Lugares, como museos, centros de convenciones, playas o parques. Esta lista va más allá de las atracciones turísticas obvias y cubre una gama muy amplia de lugares, como el centro de convenciones de Shanghái, el Capitolio de Texas o el zoológico de Praga.
`train_station`	Estaciones de tren, como la estación de tren Grand Central Terminal de Nueva York.
`metro_station`	Estaciones de metro, como la estación Avtovo en San Petersburgo, Rusia.
`bus_station`	Estaciones de autobuses como Port Authority Bus Terminal en Nueva York, NY, Estados Unidos.

Categorías de regiones

Las categorías ofrecen un enfoque fiable y flexible para entender las distintas facetas de una región, mientras que el tipo de región solo te da una visión general « high-level ». Una región puede estar asociada a varias categorías de « top-level » cuando sea pertinente. Estas categorías son intencionadamente self-explanatory, para que se entiendan bien sin necesidad de contexto adicional.

Secuencia jerárquica	Valor de la categoría
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ón

Las etiquetas son metadatos estructurados. Se utilizan para identificar las características distintivas de una región, creando un índice en el que se pueden realizar búsquedas que mejora la visibilidad y la recuperación de la información.

Etiqueta
`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 regiones

Las regiones que están en la parte superior de la jerarquía suelen utilizarse en la API de Geografía.

Con la API de Geografía, puedes solicitar todas las regiones de un continente, país u otro nivel concreto indicando el ID de región correspondiente a esa región.

>> Más información sobre la API de Geografía

A continuación, verás los ID de región de los continentes y de los países.

Continentes

Nombre	ID
África y océano Índico	6023185
Antártida	11700
Asia	6023099
Australia, Nueva Zelanda y Pacífico Sur	6023180
Caribe	6022969
Europa	6022967
México y Centroamérica	6023181
Oriente Medio	6023182
Norteamérica	500001
Sudamérica	6023117

Países

Los países se definen desde el punto de vista geográfico, no necesariamente desde el punto de vista político. Por ejemplo, Guadalupe es un departamento francés ubicado en el Caribe. Esta región es francesa desde el punto de vista político, pero tiene su propia entidad geográfica.

Nombre	ID
Albania	2
Argelia	3
Samoa Estadounidense	11399
Andorra	4
Angola	5
Anguila	6
Antigua y Barbuda	7
Argentina	8
Armenia	11398
Aruba	9
Australia	10
Austria	11
Azerbaiyán	12
Bahamas	13
Baréin	14
Bangladés	15
Barbados	16
Bielorrusia	11401
Bélgica	17
Belice	18
Benín	19
Bermudas	20
Bután	11400
Bolivia	21
Bonaire, San Eustaquio y Saba	6143084
Bosnia y Herzegovina	11414
Botsuana	22
Isla Bouvet	11702
Brasil	23
Territorio británico del océano Índico	11704
Islas Vírgenes Británicas	24
Brunéi	25
Bulgaria	26
Burkina Faso	27
Burundi	28
Camboya	29
Camerún	30
Canadá	31
Cabo Verde	32
Islas Caimán	33
Chad	35
Chile	36
China	37
Isla de Navidad	11706
Islas Cocos	11708
Colombia	38
Comoras	39
Islas Cook	41
Costa Rica	42
Costa de Marfil	87
Croacia	43
Cuba	44
Curazao	6143269
Chipre	45
República Checa	46
República Democrática del Congo	198
Dinamarca	47
Yibuti	48
Dominica	49
República Dominicana	50
Ecuador	51
Egipto	52
El Salvador	53
Guinea Ecuatorial	54
Eritrea	11402
Estonia	55
Etiopía	56
Islas Malvinas	11711
Islas Feroe	11714
Estados Federados de Micronesia	118
Fiyi	57
Finlandia	58
Francia	59
Guayana Francesa	60
Polinesia Francesa	61
Tierras australes y antárticas francesas	11712
Gabón	62
Gambia	63
Georgia	11403
Alemania	64
Ghana	65
Gibraltar	66
Grecia	67
Groenlandia	11107
Granada	68
Guadalupe	69
Guam	70
Guatemala	71
Guinea	72
Guinea-Bisáu	73
Guyana	74
Haití	75
Islas Heard y McDonald	11713
Honduras	76
RAE de Hong Kong	77
Hungría	78
Islandia	79
India	80
Indonesia	81
Irlanda	84
Israel	85
Italia	86
Jamaica	88
Japón	89
Jordania	90
Kazajistán	91
Kenia	92
Kiribati	93
Kuwait	95
Kirguistán	11404
Laos	96
Letonia	97
Líbano	98
Lesoto	99
Liberia	100
Libia	101
Liechtenstein	11405
Lituania	102
Luxemburgo	103
Región Administrativa Especial de Macao	104
Madagascar	106
Malaui	107
Malasia	108
Maldivas	109
Mali	110
Malta	111
Islas Marshall	11407
Martinica	113
Mauritania	114
Mauricio	115
Mayotte	116
México	117
Moldavia	11406
Mónaco	120
Mongolia	11408
Montenegro	6051403
Montserrat	121
Marruecos	122
Mozambique	123
Birmania	124
Namibia	125
Nauru	126
Nepal	127
Países Bajos	129
Nueva Caledonia	131
Nueva Zelanda	133
Nicaragua	134
Níger	135
Nigeria	136
Niue	11409
Isla Norfolk	137
Islas Marianas del Norte	112
Noruega	138
Omán	139
Pakistán	140
Palaos	141
Territorios Palestinos	11726
Panamá	142
Papúa Nueva Guinea	132
Paraguay	143
Perú	144
Filipinas	145
Islas Pitcairn	11718
Polonia	146
Portugal	147
Puerto Rico	148
Catar	149
República de Macedonia del Norte (Antigua República Yugoslava de Macedonia)	105
República del Congo	40
Reunión	150
Rumanía	151
Rusia	153
Ruanda	154
Samoa	155
San Marino	11720
Santo Tomé y Príncipe	156
Arabia Saudí	157
Senegal	158
Serbia	197
Seychelles	159
Sierra Leona	160
Singapur	161
Sint Maarten	6143274
Eslovaquia	162
Eslovenia	11413
Islas Salomón	163
Sudáfrica	165
Corea del Sur	94
España	166
Sri Lanka	167
San Bartolomé	6069953
Santa Elena	11721
San Cristóbal y Nieves	130
Santa Lucía	168
Isla de San Martín	6069955
San Pedro y Miquelón	11719
San Vicente y las Granadinas	169
Sudán	170
Surinam	171
Svalbard	11722
Suazilandia	172
Suecia	173
Suiza	174
Taiwán	176
Tayikistán	11410
Tanzania	177
Tailandia	178
Togo	179
Tokelau	11723
Tonga	180
Trinidad y Tobago	181
Túnez	182
Turquía	183
Turkmenistán	11411
Islas Turcas y Caicos	184
Tuvalu	185
Islas Vírgenes de los Estados Unidos	186
Uganda	187
Ucrania	188
Emiratos Árabes Unidos	189
Reino Unido	190
Estados Unidos de América	201
Uruguay	191
Islas Ultramarinas Menores de Estados Unidos	6190474
Uzbekistán	11412
Vanuatu	192
Ciudad del Vaticano	11724
Venezuela	193
Vietnam	194
Wallis y Futuna	11725
Zambia	199
Zimbabue	200