Place types are categories that identify the characteristics of a place. A place can have one or more place types assigned to it.
A place's types are included in the response from a Place Details (New), Nearby Search (New), Text Search (New), and Place Autocomplete (New) request:
- A place can have a single primary type from type
Table A or type Table B associated with it.
For example, the primary type might be
mexican_restaurant
orsteak_house
. - A place can have multiple type values from type
Table A or type Table B associated with it.
For example a restaurant might have the following types:
seafood_restaurant
,restaurant
,food
,point_of_interest
,establishment
. - The address and address components of a place can be tagged with certain types from the
Address types and address component types table. For example, an
address might be tagged as an
street_address
and a component of the address might be tagged as astreet_number
.
You can also specify place types as part of a request. When specified in the request, the type acts as a filter to restrict the response to only include places that match the specified types.
About the type tables
Table A lists the supported values for place types:
- As part of a response from Place Details (New), Nearby Search (New), and Text Search (New). The values in Table A are then used to populate those fields.
- As part of a Nearby Search (New) request, used as
the value of the
includedTypes
,excludedTypes
,includedPrimaryTypes
, andexcludedPrimaryTypes
parameter. The values in Table B are then used to populate those fields. - As part of a Text Search (New) request, used as
the value of the
includedType
parameter. - As part of a Place Autocomplete Widget (New) request,
use as the values to the
includedPrimaryTypes
parameter. - As part of a Place Autocomplete Widget (New) response.
Table B lists additional place type values which
may also be returned as part of a Place Details (New),
Nearby Search (New),
Text Search (New), and
Place Autocomplete Widget (New) response. The request must specify at least
one of the places.types
or places.primaryType
fields in the field mask.
Values from Table B may NOT be used as part of a request, except as the values to the includedPrimaryTypes
parameter
for a Place Autocomplete Widget (New) request.
Address types and address component types list types that may appear in either or both address type and address component type arrays in the response body. Address component types are subject to change.
Table A
Automotive | ||
---|---|---|
car_dealer car_rental car_repair car_wash |
electric_vehicle_charging_station gas_station parking rest_stop |
|
Business | ||
corporate_office *farm ranch * |
||
Culture | ||
art_gallery art_studio *auditorium *cultural_landmark *historical_place * |
monument *museum performing_arts_theater sculpture * |
|
Education | ||
library preschool primary_school
|
school secondary_school university
|
|
Entertainment and Recreation | ||
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
|
Facilities | ||
public_bath *public_bathroom *stable *
|
||
Finance | ||
accounting atm bank
|
||
Food and Drink | ||
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 *
|
Geographical Areas | ||
administrative_area_level_1 administrative_area_level_2 country
|
locality postal_code school_district
|
|
Government | ||
city_hall courthouse embassy fire_station government_office *
|
local_government_office neighborhood_police_station (Japan only)police post_office
|
|
Health and Wellness | ||
chiropractor *dental_clinic dentist doctor drugstore hospital massage *medical_lab *
|
pharmacy physiotherapist sauna *skin_care_clinic *spa tanning_studio *wellness_center *yoga_studio *
|
|
Housing | ||
apartment_building *apartment_complex *condominium_complex *housing_complex *
|
||
Lodging | ||
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
|
|
Natural Features | ||
beach *
|
||
Places of Worship | ||
church hindu_temple mosque synagogue
|
||
Services | ||
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
|
|
Shopping | ||
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
|
|
Sports | ||
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
|
|
Transportation | ||
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
|
Table B
Additional Place type values | ||
---|---|---|
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
|
Address types and address component types
The types
array in the response indicates the
address type. Examples of address types include a street address, a
country, or a political entity. The types
array in
the google.maps.places.AddressComponent
class indicates the type of each part of the
address. Examples include street number or country.
Addresses may have multiple types. The types may be considered 'tags'.
For example, many cities are tagged with the political
and
locality
types.
The following types are supported and returned in both the address type and address component type arrays:
Address Type | Description |
---|---|
street_address |
A precise street address. |
route |
A named route (such as "US 101"). |
intersection |
A major intersection, usually of two major roads. |
political |
A political entity. Usually, this type indicates a polygon of some civil administration. |
country |
The national political entity, and is typically the highest order type returned by the Geocoder. |
administrative_area_level_1 |
A first-order civil entity below the country level. Within the United States, these administrative levels are states. Not all nations exhibit these administrative levels. In most cases, administrative_area_level_1 short names will closely match ISO 3166-2 subdivisions and other widely circulated lists; however this is not guaranteed as our geocoding results are based on a variety of signals and location data. |
administrative_area_level_2 |
A second-order civil entity below the country level. Within the United States, these administrative levels are counties. Not all nations exhibit these administrative levels. |
administrative_area_level_3 |
A third-order civil entity below the country level. This type indicates a minor civil division. Not all nations exhibit these administrative levels. |
administrative_area_level_4 |
A fourth-order civil entity below the country level. This type indicates a minor civil division. Not all nations exhibit these administrative levels. |
administrative_area_level_5 |
A fifth-order civil entity below the country level. This type indicates a minor civil division. Not all nations exhibit these administrative levels. |
administrative_area_level_6 |
A sixth-order civil entity below the country level. This type indicates a minor civil division. Not all nations exhibit these administrative levels. |
administrative_area_level_7 |
A seventh-order civil entity below the country level. This type indicates a minor civil division. Not all nations exhibit these administrative levels. |
colloquial_area |
A commonly-used alternative name for the entity. |
locality |
An incorporated city or town political entity. |
sublocality |
A first-order civil entity below a locality. For some locations may receive one of the additional types: sublocality_level_1 to sublocality_level_5 . Each sublocality level is a civil entity. Larger numbers indicate a smaller geographic area. |
neighborhood |
A named neighborhood. |
premise |
A named location, usually a building or collection of buildings with a common name. |
subpremise |
An addressable entity below the premise level, such as an apartment, unit, or suite. |
plus_code |
An encoded location reference, derived from latitude and longitude. Plus codes can be used as a replacement for street addresses in places where they do not exist (where buildings are not numbered or streets are not named). See https://plus.codes for details. |
postal_code |
A postal code as used to address postal mail within the country. |
natural_feature |
A prominent natural feature. |
airport |
An airport. |
park |
A named park. |
point_of_interest |
A named point of interest. Typically, these "POI"s are prominent local entities that don't easily fit in another category, such as "Empire State Building" or "Eiffel Tower". |
An empty list of types indicates there are no known types for the particular address component (for example, Lieu-dit in France).
In addition to the above, address components may include the types listed below.
Address Component Type | Description |
---|---|
floor |
The floor of a building address. |
establishment |
Typically a place that has not yet been categorized. |
landmark |
A nearby place that is used as a reference, to aid navigation. |
point_of_interest |
A named point of interest. |
parking |
A parking lot or parking structure. |
post_box |
A specific postal box. |
postal_town |
A grouping of geographic areas, such as locality and sublocality , used for mailing addresses in some countries. |
room |
The room of a building address. |
street_number |
The precise street number. |
bus_station , train_station and transit_station |
The location of a bus, train or public transit stop. |