Los tipos de lugares 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 Place Autocomplete (nuevo):
- Un lugar puede tener un tipo primario único del tipo Tabla A o del tipo Tabla B asociado con él.
Por ejemplo, el tipo principal podría ser
mexican_restaurant
osteak_house
. - Un lugar puede tener varios valores de tipo de la Tabla A o de la Tabla B asociados con él.
Por ejemplo, un restaurante podría tener los siguientes tipos:
seafood_restaurant
,restaurant
,food
,point_of_interest
yestablishment
. - 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 podría etiquetarse como
street_address
y un componente de la dirección podría etiquetarse comostreet_number
.
También puedes especificar los 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 y que solo incluya 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
,includedPrimaryTypes
yexcludedPrimaryTypes
. 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 widget Place Autocomplete (nuevo).
Tipos de dirección y tipos de componentes de dirección: Es una lista de tipos que pueden aparecer en uno o ambos arrays de tipos de dirección y de componentes de dirección en el cuerpo de la respuesta. Los tipos de componentes de dirección están sujetos a cambios.
Tabla A
Industria automotriz | ||
---|---|---|
car_dealer car_rental car_repair car_wash |
electric_vehicle_charging_station gas_station parking rest_stop |
|
Empresa | ||
corporate_office *farm ranch * |
||
Cultura | ||
art_gallery art_studio *auditorium *cultural_landmark *historical_place * |
monument *museum performing_arts_theater sculpture * |
|
Educación | ||
library preschool primary_school
|
school secondary_school university
|
|
Ocio y entretenimiento | ||
adventure_sports_center *amphitheatre *amusement_center amusement_park aquarium banquet_hall barbecue_area *botanical_garden *bowling_alley casino childrens_camp *comedy_club *community_center concert_hall *convention_center cultural_center cycling_park *dance_hall *dog_park event_venue |
ferris_wheel *garden *hiking_area *historical_landmark internet_cafe *karaoke *marina movie_rental movie_theater national_park night_club observation_deck *off_roading_area *opera_house *park philharmonic_hall *picnic_ground *planetarium *plaza *roller_coaster * |
skateboard_park *state_park *tourist_attraction video_arcade *visitor_center water_park *wedding_venue wildlife_park *wildlife_refuge *zoo
|
Instalaciones | ||
public_bath *public_bathroom *stable *
|
||
Finanzas | ||
accounting atm bank
|
||
Comidas y bebidas | ||
acai_shop *afghani_restaurant *african_restaurant *american_restaurant asian_restaurant *bagel_shop *bakery bar bar_and_grill *barbecue_restaurant brazilian_restaurant breakfast_restaurant brunch_restaurant buffet_restaurant *cafe cafeteria *candy_store *cat_cafe *chinese_restaurant chocolate_factory *chocolate_shop *coffee_shop confectionery * |
deli *dessert_restaurant *dessert_shop *diner *dog_cafe *donut_shop *fast_food_restaurant fine_dining_restaurant *food_court *french_restaurant greek_restaurant hamburger_restaurant ice_cream_shop indian_restaurant indonesian_restaurant italian_restaurant japanese_restaurant juice_shop *korean_restaurant *lebanese_restaurant meal_delivery meal_takeaway mediterranean_restaurant |
mexican_restaurant middle_eastern_restaurant pizza_restaurant pub *ramen_restaurant restaurant sandwich_shop seafood_restaurant spanish_restaurant steak_house sushi_restaurant tea_house *thai_restaurant turkish_restaurant vegan_restaurant vegetarian_restaurant vietnamese_restaurant wine_bar *
|
Áreas geográficas | ||
administrative_area_level_1 administrative_area_level_2 country
|
locality postal_code school_district
|
|
Gobierno | ||
city_hall courthouse embassy fire_station government_office *
|
local_government_office neighborhood_police_station (solo en Japón)police post_office
|
|
Salud y bienestar | ||
chiropractor *dental_clinic dentist doctor drugstore hospital massage *medical_lab *
|
pharmacy physiotherapist sauna *skin_care_clinic *spa tanning_studio *wellness_center *yoga_studio *
|
|
Vivienda | ||
apartment_building *apartment_complex *condominium_complex *housing_complex *
|
||
Alojamiento | ||
bed_and_breakfast budget_japanese_inn *campground camping_cabin cottage extended_stay_hotel farmstay guest_house
hostel *hotel * |
inn *japanese_inn *lodging mobile_home_park *motel private_guest_room resort_hotel rv_park
|
|
Elementos naturales | ||
beach *
|
||
Lugares de culto | ||
church hindu_temple mosque synagogue
|
||
Servicios | ||
astrologer *barber_shop beautician *beauty_salon body_art_service *catering_service *cemetery child_care_agency consultant courier_service electrician florist food_delivery *foot_care *funeral_home hair_care hair_salon insurance_agency laundry * |
lawyer locksmith makeup_artist *moving_company nail_salon *painter plumber psychic *real_estate_agency roofing_contractor storage summer_camp_organizer *tailor telecommunications_service_provider tour_agency *tourist_information_center *travel_agency veterinary_care
|
|
Compras | ||
asian_grocery_store *auto_parts_store bicycle_store book_store butcher_shop *cell_phone_store clothing_store convenience_store department_store discount_store electronics_store food_store *furniture_store gift_shop grocery_store hardware_store home_goods_store
|
home_improvement_store jewelry_store liquor_store market pet_store shoe_store shopping_mall sporting_goods_store store supermarket warehouse_store *wholesaler
|
|
Deportes | ||
arena *athletic_field fishing_charter *fishing_pond *fitness_center golf_course gym ice_skating_rink * |
playground *ski_resort sports_activity_location *sports_club sports_coaching *sports_complex stadium swimming_pool
|
|
Transporte | ||
airport airstrip *bus_station bus_stop ferry_terminal heliport international_airport *light_rail_station |
park_and_ride *subway_station taxi_stand train_station transit_depot transit_station truck_stop
|
Tabla B
Valores de tipos de lugar adicionales | ||
---|---|---|
administrative_area_level_3 administrative_area_level_4 administrative_area_level_5 administrative_area_level_6 administrative_area_level_7 archipelago colloquial_area continent establishment finance food general_contractor geocode health intersection landmark natural_feature neighborhood place_of_worship plus_code
|
point_of_interest political postal_code_prefix postal_code_suffix postal_town premise route street_address sublocality sublocality_level_1 sublocality_level_2 sublocality_level_3 sublocality_level_4 sublocality_level_5 subpremise town_square
|
Tipos de dirección y tipos de componentes de dirección
El array types
en la respuesta indica el tipo de dirección. Algunos ejemplos de tipos de direcciones 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 "etiquetas".
Por ejemplo, muchas ciudades están etiquetadas con los tipos political
y locality
.
Los siguientes tipos se admiten y se muestran en los arrays de tipo de dirección y de componente de dirección:
Tipo de dirección | Descripción |
---|---|
street_address |
Una dirección precisa. |
route |
Es 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 pública de quinto 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_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, por lo general, un edificio o un conjunto de edificios con un nombre común. |
subpremise |
Es una entidad direccionable por debajo del nivel de las instalaciones, 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). Consulta https://plus.codes para obtener más información. |
postal_code |
Indica un código postal, tal como se usa para identificar una dirección de correo postal dentro del país. |
natural_feature |
Un componente natural destacado. |
airport |
Un aeropuerto. |
park |
Indica un parque designado. |
point_of_interest |
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 dicho antes, los componentes de dirección pueden incluir los siguientes tipos.
Tipo de componente de dirección | Descripción |
---|---|
floor |
Es el 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 |
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 un grupo de áreas geográficas, como locality y sublocality , que se usan para las direcciones de correo postal en algunos países. |
room |
Es la habitación de una dirección de un edificio. |
street_number |
El número exacto de la calle. |
bus_station , train_station y transit_station |
La ubicación de una parada de autobús, tren o transporte público. |