Place Types

AI-generated Key Takeaways

• Place types are categories that describe the characteristics of a place, and a single place can have multiple types associated with it.

• Place types are included in the responses to Place Details, Nearby Search, Text Search, and Place Autocomplete requests.

• You can use place types in requests to filter results based on desired characteristics.

• Table A lists place types supported in requests and responses for filtering and categorization.

• Table B lists additional place types that can be returned in responses, but cannot be used for filtering in requests (except for Place Autocomplete Widget requests).

Select platform: Android iOS JavaScript Web Service

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 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 or steak_house.The primary type may be missing if the place's primary type is not a supported type. When a primary type is present, it is always one of the types in the types field.
• 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 a street_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, and excludedPrimaryTypes 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

Note: Types with an asterisk (*) were added as part of the November 7, 2024 release.

Automotive Business Culture Education Entertainment and Recreation Facilities * Finance Food and Drink Geographical Areas Government

Health and Wellness Housing * Lodging Natural Features * Places of Worship Services Shopping Sports Transportation

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

The Place type values in Table B may be returned as part of a Place Details (New), Nearby Search (New), Text Search (New), or Autocomplete (New) response. These types are also supported by includedPrimaryTypes for Autocomplete (New) requests.

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.

Note: This list is not exhaustive, and is subject to change.

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.