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 de itinerarios. 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 un tipo de región
cityen 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 a una región. 178921 Tsing Yi, por ejemplo, está etiquetada 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 según el tipo de región, y las regiones se clasifican según la entidad geográfica que representan. En las API de Rapid Geography, esta información se incluye en el campo «type».
>> Más información sobre los tipos de regiones
| 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 debe 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 adaptable para comprender las distintas facetas de una región, mientras que el tipo de región solo ofrece 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 más contexto.
| 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.
Las etiquetas disponibles son:
activity:vineyardactivity:skiShuttleactivity:skiLiftactivity:nationalParkactivity:genericactivity:childrensMuseumattraction:genericcivic:medicalCentrecivic:genericcivic:embassyConsulatecivic:conventionCentrecultural:waxMuseumcultural:transportMuseumcultural:sportsMuseumcultural:scienceMuseumcultural:railwayMuseumcultural:operacultural:naturalHistoryMuseumcultural:musicMuseumcultural:militaryMuseumcultural:maritimeMuseumcultural:industrialMuseumcultural:holocaustMuseumcultural:historyMuseumcultural:genericcultural:aviationMuseumcultural:artMuseumentertainment:genericgeo-admin:suburbgeo-admin:subProvincegeo-admin:stategeo-admin:regencygeo-admin:prefecturegeo-admin:parishgeo-admin:municipalitygeo-admin:local-authoritygeo-admin:landergeo-admin:federal-subjectgeo-admin:emirategeo-admin:districtgeo-admin:departmentgeo-admin:countygeo-admin:cantongeo-admin:boroughgeo-admin:autonomous-regiongeo-admin:autonomous-communitylandmark:historicPlacelandmark:genericmeta:fakeRegionnaturalFeature:waterFeaturenaturalFeature:islandnaturalFeature:genericroute:skiRunroute:scenicDriveroute:footpathroute:cyclingRouteshopping:shoppingCentreshopping:shoppingAreasocial:generictourism:resorttourism: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 |
| Esuatini | 172 |
| 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 |
| Macedonia del Norte | 105 |
| 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 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 |
| 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 |