Place Types (New)

  • 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 as filters in requests to narrow down search results to places matching those types.

  • Two tables, Table A and Table B, define the range of available place types, with Table A containing primary types usable for filtering and Table B containing additional types primarily for responses.

  • Types in Table A can be used to refine Nearby Search and Text Search requests, while Table B types mainly appear in Place Autocomplete responses and are only filterable using includedPrimaryTypes for Place Autocomplete.
Select platform: Android iOS JavaScript Web Service

European Economic Area (EEA) developers

Introduction

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 types that are used in the following ways:

  • As part of a response from Place Details (New), Nearby Search (New), and Text Search (New). The request must specify at least one of the places.types or places.primaryType fields in the field mask. 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 Autocomplete (New) request, use as the values to the includedPrimaryTypes parameter.
  • As part of a Autocomplete (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 Autocomplete (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 Autocomplete (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

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 AddressComponent field 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.