Search for places near locations.
HTTP request
POST https://places.googleapis.com/v1/places:searchNearby
The URL uses gRPC Transcoding syntax.
Request body
The request body contains data with the following structure:
JSON representation |
---|
{ "languageCode": string, "regionCode": string, "includedTypes": [ string ], "excludedTypes": [ string ], "includedPrimaryTypes": [ string ], "excludedPrimaryTypes": [ string ], "maxResultCount": integer, "locationRestriction": { object ( |
Fields | |
---|---|
languageCode |
Place details will be displayed with the preferred language if available. If the language code is unspecified or unrecognized, place details of any language may be returned, with a preference for English if such details exist. Current list of supported languages: https://developers.google.com/maps/faq#languagesupport. |
regionCode |
The Unicode country/region code (CLDR) of the location where the request is coming from. This parameter is used to display the place details, like region-specific place name, if available. The parameter can affect results based on applicable law. For more information, see https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. Note that 3-digit region codes are not currently supported. |
includedTypes[] |
Included Place type (eg, "restaurant" or "gas_station") from https://developers.google.com/maps/documentation/places/web-service/place-types. Up to 50 types from Table A may be specified. If there are any conflicting types, i.e. a type appears in both includedTypes and excludedTypes, an INVALID_ARGUMENT error is returned. If a Place type is specified with multiple type restrictions, only places that satisfy all of the restrictions are returned. For example, if we have {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]}, the returned places provide "restaurant" related services but do not operate primarily as "restaurants". |
excludedTypes[] |
Excluded Place type (eg, "restaurant" or "gas_station") from https://developers.google.com/maps/documentation/places/web-service/place-types. Up to 50 types from Table A may be specified. If the client provides both includedTypes (e.g. restaurant) and excludedTypes (e.g. cafe), then the response should include places that are restaurant but not cafe. The response includes places that match at least one of the includedTypes and none of the excludedTypes. If there are any conflicting types, i.e. a type appears in both includedTypes and excludedTypes, an INVALID_ARGUMENT error is returned. If a Place type is specified with multiple type restrictions, only places that satisfy all of the restrictions are returned. For example, if we have {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]}, the returned places provide "restaurant" related services but do not operate primarily as "restaurants". |
includedPrimaryTypes[] |
Included primary Place type (e.g. "restaurant" or "gas_station") from https://developers.google.com/maps/documentation/places/web-service/place-types. A place can only have a single primary type from the supported types table associated with it. Up to 50 types from Table A may be specified. If there are any conflicting primary types, i.e. a type appears in both includedPrimaryTypes and excludedPrimaryTypes, an INVALID_ARGUMENT error is returned. If a Place type is specified with multiple type restrictions, only places that satisfy all of the restrictions are returned. For example, if we have {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]}, the returned places provide "restaurant" related services but do not operate primarily as "restaurants". |
excludedPrimaryTypes[] |
Excluded primary Place type (e.g. "restaurant" or "gas_station") from https://developers.google.com/maps/documentation/places/web-service/place-types. Up to 50 types from Table A may be specified. If there are any conflicting primary types, i.e. a type appears in both includedPrimaryTypes and excludedPrimaryTypes, an INVALID_ARGUMENT error is returned. If a Place type is specified with multiple type restrictions, only places that satisfy all of the restrictions are returned. For example, if we have {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]}, the returned places provide "restaurant" related services but do not operate primarily as "restaurants". |
maxResultCount |
Maximum number of results to return. It must be between 1 and 20 (default), inclusively. If the number is unset, it falls back to the upper limit. If the number is set to negative or exceeds the upper limit, an INVALID_ARGUMENT error is returned. |
locationRestriction |
Required. The region to search. |
rankPreference |
How results will be ranked in the response. |
routingParameters |
Optional. Parameters that affect the routing to the search results. |
Response body
Response proto for Search Nearby.
If successful, the response body contains data with the following structure:
JSON representation |
---|
{ "places": [ { object ( |
Fields | |
---|---|
places[] |
A list of places that meets user's requirements like places types, number of places and specific location restriction. |
routingSummaries[] |
A list of routing summaries where each entry associates to the corresponding place in the same index in the |
LocationRestriction
The region to search.
JSON representation |
---|
{ // Union field |
Fields | |
---|---|
Union field
|
|
circle |
A circle defined by center point and radius. |
RankPreference
How results will be ranked in the response.
Enums | |
---|---|
RANK_PREFERENCE_UNSPECIFIED |
RankPreference value not set. Will use rank by POPULARITY by default. |
DISTANCE |
Ranks results by distance. |
POPULARITY |
Ranks results by popularity. |