AI-generated Key Takeaways

outlined_flag

• 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 usingincludedPrimaryTypes for Place Autocomplete.

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

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 request must specify at least one of theplaces.types orplaces.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 theincludedTypes,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 theincludedType parameter.
• As part of a Autocomplete (New) request, use as the values to theincludedPrimaryTypes parameter.
• As part of a Autocomplete (New) response.

Table B lists additional place type values whichmay also be returned as part of a Place Details (New),Nearby Search (New),Text Search (New), andAutocomplete (New) response. The requestmust specify at least one of theplaces.types orplaces.primaryTypefields in the field mask. Values from Table B may NOT be used as part of arequest, except as the values to theincludedPrimaryTypes parameterfor a Autocomplete (New) request.

Address types and address component typeslist types that may appear in either or both address type and address componenttype arrays in the response body. Address component types are subject tochange.

Table A