AI-generated Key Takeaways

outlined_flag

• Place types categorize places based on their characteristics, like "restaurant" or "park", and a place can have multiple types.

• You can use place types in your requests to filter results, ensuring you only receive places matching desired types.

• Place type information is included in responses to Place Details, Nearby Search, Text Search, and Place Autocomplete requests.

• There are two tables of place types: Table A for filtering and response types, and Table B for additional types returned in responses but not used for filtering.

• Google Maps Places API uses thePlace.getPlaceTypes() method to access the new place types in aPlace object.

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 theresponse from aPlace Details (New),Nearby Search (New), Text Search (New), and Autocomplete (New) request:

• A place can have asingle primary type from typeTable A or typeTable B associated with it. For example, theprimary type might bemexican_restaurant orsteak_house.Theprimary type may be missing if the place's primary type is not a supported type. When aprimary type is present, it is always one of thetypes in thetypes field.
• A place can havemultiple type values from typeTable A or typeTable B associated with it. For example a restaurant might have the followingtypes:seafood_restaurant,restaurant,food,point_of_interest,establishment.
• The address and address components of a place can be tagged with certain types from theAddress types and address component types table. For example, an address might be tagged as anstreet_address and a component of the address might be tagged as astreet_number.

You can also specify place types as part of arequest. When specified in therequest, the type acts as a filter to restrict the response to only includeplaces that match the specified types.

Note: You must use thePlace.getPlaceTypes()method to access the new types in aPlaceobject. ThePlace.getTypes()method always returns the legacy types listed onPlace Types.If you don't enable Places SDK for Android (New), thenPlace.getPlaceTypes() only supports the legacy place types shown inPlace Types.

About the type tables

Table A lists the types that are used in thefollowing ways:

• As part of a response from Place Details (New), Nearby Search (New), and Text Search (New), the values in Table A are used to populate the types property of thePlace instance. The request must specifyPlace.Field.TYPES orPlace.Field.PRIMARY_TYPE in the field list.
• As part of a Nearby Search (New) request, used as the value of the included types, excluded types, included primary types, and excluded primary types parameters.
• As part of a Text Search (New) request, used as the value of the included type parameter.
• As part of a Place Autocomplete (New) request, use as the values to the primary types parameter.
• As part of a Place Autocomplete (New) response used to populate the types property of theAutocompletePrediction instance.

Table B lists additional place type valueswhich may also be returned as part of aPlace Details (New),Nearby Search (New),Text Search (New), andPlace Autocomplete (New) response. The request mustspecifyPlace.Field.TYPES orPlace.Field.PRIMARY_TYPEin the field list. Values from Table B NOT be used as part of a request, exceptas the values to the primary typesparameter for a Place Autocomplete (New) request.

Address types and address component types list types that may appearin either or both address type and address component type arrays in the responsebody. 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 supportedbyincludedPrimaryTypes 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

ThegetPlaceTypes enum in the response indicates theaddress type. Examples of address types include a street address, a country, or a political entity. Thetypes array in theAddressComponent 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 thepolitical andlocality 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 tosublocality_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). Seehttps://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 aslocality andsublocality, used for mailing addresses in some countries.
room	The room of a building address.
street_number	The precise street number.
bus_station,train_station andtransit_station	The location of a bus, train or public transit stop.