Los tipos de lugar son categorías que identifican las características de un lugar. Un lugar puede tener uno o más tipos de lugar asignados.
Los tipos de un lugar se incluyen en la respuesta de una solicitud a Place Details (nuevo), Nearby Search (nuevo), Text Search (nuevo) y Autocomplete (nuevo):
- Un lugar puede tener un solo tipo principal del tipo Tabla A o del tipo Tabla B asociado.
Por ejemplo, el tipo principal podría ser
mexican_restaurantosteak_house.Es posible que falte el tipo principal si el tipo principal del lugar no es un tipo admitido. Cuando hay un tipo principal, siempre es uno de los tipos en el campotypes. - Un lugar puede tener varios valores de tipo de la Tabla A o la Tabla B asociados.
Por ejemplo, un restaurante puede tener los siguientes tipos:
seafood_restaurant,restaurant,food,point_of_interest,establishment. - La dirección y los componentes de dirección de un lugar se pueden etiquetar con ciertos tipos de la tabla Tipos de dirección y tipos de componentes de dirección. Por ejemplo, una dirección se puede etiquetar como
street_addressy un componente de la dirección se puede etiquetar comostreet_number.
También puedes especificar tipos de lugares como parte de una solicitud. Cuando se especifica en la solicitud, el tipo actúa como un filtro para restringir la respuesta de modo que solo incluya los lugares que coincidan con los tipos especificados.
Acerca de las tablas de tipos
Tabla A contiene una lista de los valores admitidos para los distintos tipos de lugar:
- Como respuesta a Place Details (nuevo), Nearby Search (nuevo) y Text Search (nuevo): los valores incluidos en la Tabla A se utilizan para completar esos campos.
- Como respuesta a una solicitud de Nearby Search (nuevo), se utiliza como el valor de los parámetros
includedTypes,excludedTypes,includedPrimaryTypesyexcludedPrimaryTypes. Luego, se utilizan los valores de la tabla B para completar esos campos. - Como parte de una solicitud de Text Search (nuevo), se utiliza como el valor del parámetro
includedType. - Como parte de una solicitud de widget de Place Autocomplete (nuevo),
se utiliza como el valor del parámetro
includedPrimaryTypes. - Como parte de una respuesta del widget de Place Autocomplete (nuevo).
La tabla B incluye una lista de valores de tipos de lugar adicionales que también pueden mostrarse en las respuestas de Place Details (nuevo), Nearby Search (nuevo), Text Search (nuevo) y Place Autocomplete Widget (nuevo). La solicitud debe especificar al menos uno de los campos places.types o places.primaryType en la máscara de campo.
Los valores de la tabla B NO se pueden usar como parte de una solicitud, salvo que sean parámetros includedPrimaryTypes de una solicitud de Place Autocomplete Widget (nuevo).
La lista Tipos de dirección y tipos de componentes de dirección incluye los tipos que pueden aparecer en los arrays de tipos de dirección o de componentes de dirección, o en ambos, en el cuerpo de la respuesta. Los tipos de componentes de dirección están sujetos a cambios.
Tabla A
| Industria automotriz | ||
|---|---|---|
car_dealercar_rentalcar_repaircar_wash |
electric_vehicle_charging_stationgas_stationparkingrest_stop |
|
| Empresa | ||
corporate_office *farmranch * |
||
| Cultura | ||
art_galleryart_studio *auditorium *cultural_landmark *historical_place * |
monument *museumperforming_arts_theatersculpture * |
|
| Educación | ||
librarypreschoolprimary_school
|
schoolsecondary_schooluniversity
|
|
| Ocio y entretenimiento | ||
adventure_sports_center *amphitheatre *amusement_centeramusement_parkaquariumbanquet_hallbarbecue_area *botanical_garden *bowling_alleycasinochildrens_camp *comedy_club *community_centerconcert_hall *convention_centercultural_centercycling_park *dance_hall *dog_parkevent_venue |
ferris_wheel *garden *hiking_area *historical_landmarkinternet_cafe *karaoke *marinamovie_rentalmovie_theaternational_parknight_clubobservation_deck *off_roading_area *opera_house *parkphilharmonic_hall *picnic_ground *planetarium *plaza *roller_coaster * |
skateboard_park *state_park *tourist_attractionvideo_arcade *visitor_centerwater_park *wedding_venuewildlife_park *wildlife_refuge *zoo
|
| Instalaciones | ||
public_bath *public_bathroom *stable *
|
||
| Finanzas | ||
accountingatmbank
|
||
| Comidas y bebidas | ||
acai_shop *afghani_restaurant *african_restaurant *american_restaurantasian_restaurant *bagel_shop *bakerybarbar_and_grill *barbecue_restaurantbrazilian_restaurantbreakfast_restaurantbrunch_restaurantbuffet_restaurant *cafecafeteria *candy_store *cat_cafe *chinese_restaurantchocolate_factory *chocolate_shop *coffee_shopconfectionery * |
deli *dessert_restaurant *dessert_shop *diner *dog_cafe *donut_shop *fast_food_restaurantfine_dining_restaurant *food_court *french_restaurantgreek_restauranthamburger_restaurantice_cream_shopindian_restaurantindonesian_restaurantitalian_restaurantjapanese_restaurantjuice_shop *korean_restaurant *lebanese_restaurantmeal_deliverymeal_takeawaymediterranean_restaurant |
mexican_restaurantmiddle_eastern_restaurantpizza_restaurantpub *ramen_restaurantrestaurantsandwich_shopseafood_restaurantspanish_restaurantsteak_housesushi_restauranttea_house *thai_restaurantturkish_restaurantvegan_restaurantvegetarian_restaurantvietnamese_restaurantwine_bar *
|
| Áreas geográficas | ||
administrative_area_level_1administrative_area_level_2country
|
localitypostal_codeschool_district
|
|
| Gobierno | ||
city_hallcourthouseembassyfire_stationgovernment_office *
|
local_government_officeneighborhood_police_station (solo en Japón)policepost_office
|
|
| Salud y bienestar | ||
chiropractor *dental_clinicdentistdoctordrugstorehospitalmassage *medical_lab *
|
pharmacyphysiotherapistsauna *skin_care_clinic *spatanning_studio *wellness_center *yoga_studio *
|
|
| Vivienda | ||
apartment_building *apartment_complex *condominium_complex *housing_complex *
|
||
| Alojamiento | ||
bed_and_breakfastbudget_japanese_inn *campgroundcamping_cabincottageextended_stay_hotelfarmstayguest_househostel *hotel * |
inn *japanese_inn *lodgingmobile_home_park *motelprivate_guest_roomresort_hotelrv_park
|
|
| Atractivos naturales | ||
beach*
|
||
| Lugares de culto | ||
churchhindu_templemosquesynagogue
|
||
| Servicios | ||
astrologer *barber_shopbeautician *beauty_salonbody_art_service *catering_service *cemeterychild_care_agencyconsultantcourier_serviceelectricianfloristfood_delivery *foot_care *funeral_homehair_carehair_saloninsurance_agencylaundry * |
lawyerlocksmithmakeup_artist *moving_companynail_salon *painterplumberpsychic *real_estate_agencyroofing_contractorstoragesummer_camp_organizer *tailortelecommunications_service_providertour_agency *tourist_information_center *travel_agencyveterinary_care
|
|
| Compras | ||
asian_grocery_store *auto_parts_storebicycle_storebook_storebutcher_shop *cell_phone_storeclothing_storeconvenience_storedepartment_storediscount_storeelectronics_storefood_store *furniture_storegift_shopgrocery_storehardware_storehome_goods_store
|
home_improvement_storejewelry_storeliquor_storemarketpet_storeshoe_storeshopping_mallsporting_goods_storestoresupermarketwarehouse_store *wholesaler
|
|
| Deportes | ||
arena *athletic_fieldfishing_charter *fishing_pond *fitness_centergolf_coursegymice_skating_rink * |
playground *ski_resortsports_activity_location *sports_clubsports_coaching *sports_complexstadiumswimming_pool
|
|
| Transporte | ||
airportairstrip *bus_stationbus_stopferry_terminalheliportinternational_airport *light_rail_station |
park_and_ride *subway_stationtaxi_standtrain_stationtransit_depottransit_stationtruck_stop
|
|
Tabla B
Los valores de tipo de lugar de la tabla B se pueden mostrar como parte de una respuesta de Place Details (nuevo),
Nearby Search (nuevo),
Text Search (nuevo) o
Autocomplete (nuevo). includedPrimaryTypes también admite estos tipos para las solicitudes de Autocomplete (nuevo).
| Valores de tipos de lugar adicionales | ||
|---|---|---|
administrative_area_level_3administrative_area_level_4administrative_area_level_5administrative_area_level_6administrative_area_level_7archipelagocolloquial_areacontinentestablishmentfinancefoodgeneral_contractorgeocodehealthintersectionlandmarknatural_featureneighborhoodplace_of_worshipplus_code
|
point_of_interestpoliticalpostal_code_prefixpostal_code_suffixpostal_townpremiseroutestreet_addresssublocalitysublocality_level_1sublocality_level_2sublocality_level_3sublocality_level_4sublocality_level_5subpremisetown_square
|
|
Tipos de dirección y tipos de componentes de dirección
El array types en la respuesta indica el tipo de dirección. Entre los ejemplos de tipos de direcciones, se incluyen una dirección, un país o una entidad política. El array types en la clase google.maps.places.AddressComponent indica el tipo de cada parte de la dirección. Los ejemplos incluyen el número de una calle o el país.
Las direcciones pueden tener múltiples tipos. Los tipos se pueden considerar como "etiquetas".
Por ejemplo, muchas ciudades están etiquetadas con los tipos political y locality.
El geocodificador admite y muestra los siguientes tipos en los arrays de tipos de dirección y de componente de dirección:
| Tipo de dirección | Descripción |
|---|---|
street_address |
Una dirección precisa |
route |
Una ruta designada (como "US 101"). |
intersection |
Una intersección principal, generalmente de dos rutas principales. |
political |
Es una entidad política. Generalmente, este tipo indica un polígono de alguna administración pública. |
country |
Indica la entidad política nacional y, por lo general, es el tipo de orden más alto que muestra el geocodificador. |
administrative_area_level_1 |
Indica una entidad pública de primer orden por debajo del nivel de país. En Estados Unidos, estos niveles administrativos son los estados. No todos los países poseen estos niveles administrativos. En la mayoría de los casos, los nombres cortos de administrative_area_level_1 coincidirán considerablemente con las subdivisiones de ISO 3166-2 y otras listas conocidas; sin embargo, no podemos garantizarlo debido a que nuestros resultados de geocodificación se basan en diferentes indicadores y datos de ubicación. |
administrative_area_level_2 |
Indica una entidad pública de segundo orden por debajo del nivel de país. En Estados Unidos, estos niveles administrativos son los condados. No todos los países poseen estos niveles administrativos. |
administrative_area_level_3 |
Indica una entidad civil de tercer rango por debajo del nivel de país. Este tipo indica una división política inferior. No todos los países poseen estos niveles administrativos. |
administrative_area_level_4 |
Indica una entidad civil de cuarto rango por debajo del nivel de país. Este tipo indica una división política inferior. No todos los países poseen estos niveles administrativos. |
administrative_area_level_5 |
Indica una entidad civil de quinto rango por debajo del nivel de país. Este tipo indica una división política inferior. No todos los países poseen estos niveles administrativos. |
administrative_area_level_6 |
Indica una entidad pública de sexto orden por debajo del nivel de país. Este tipo indica una división política inferior. No todos los países poseen estos niveles administrativos. |
administrative_area_level_7 |
Indica una entidad pública de séptimo orden por debajo del nivel de país. Este tipo indica una división política inferior. No todos los países poseen estos niveles administrativos. |
colloquial_area |
Es un nombre alternativo de uso general para la entidad. |
locality |
Indica una entidad política constituida como ciudad o pueblo. |
sublocality |
Indica una entidad civil de primer rango por debajo de una localidad. Algunas ubicaciones pueden recibir uno de los tipos adicionales: sublocality_level_1 a sublocality_level_5. Cada nivel de sublocalidad es una entidad pública. Los números más altos indican un área geográfica más pequeña. |
neighborhood |
Indica un área residencial con nombre. |
premise |
Es una ubicación designada, generalmente un edificio o un conjunto de edificios con un nombre común. |
subpremise |
Es una entidad direccionable por debajo del nivel de la instalación, como un departamento, una unidad o una suite. |
plus_code |
Es una referencia de ubicación codificada, derivada de la latitud y la longitud. Los Plus Codes se pueden usar como reemplazo de las direcciones en los lugares donde estas no existen (donde los edificios no están numerados o las calles no tienen nombre). Visita https://plus.codes para obtener más información. |
postal_code |
Es un código postal, tal como se usa para identificar una dirección de correo postal dentro del país. |
natural_feature |
Un accidente geográfico natural destacado. |
airport |
Un aeropuerto. |
park |
Indica un parque designado. |
point_of_interest |
Es un lugar de interés designado. Por lo general, estos "lugares de interés" son entidades locales destacadas que no encajan con facilidad en otras categorías, como "Edificio Empire State" o "Torre Eiffel". |
Una lista vacía de tipos indica que no hay tipos conocidos para el componente de dirección específico (por ejemplo, Lieu-dit en Francia).
Además de lo anterior, los componentes de dirección pueden incluir los tipos que se indican a continuación.
| Tipo de componente de dirección | Descripción |
|---|---|
floor |
Piso de la dirección de un edificio |
establishment |
Por lo general, es un lugar que aún no se categorizó. |
landmark |
Un lugar cercano que se usa como referencia para facilitar la navegación. |
point_of_interest |
Es un lugar de interés designado. |
parking |
Un estacionamiento o una estructura de estacionamiento |
post_box |
Una casilla de correo postal específica. |
postal_town |
Es una agrupación de áreas geográficas, como locality y sublocality, que se usa para las direcciones de correo postal en algunos países. |
room |
Habitación de la dirección de un edificio |
street_number |
Número exacto de la calle. |
bus_station, train_station y transit_station |
Es la ubicación de una parada de autobús, tren o transporte público. |