Method: places.searchNearby

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 (LocationRestriction)
  },
  "rankPreference": enum (RankPreference),
  "routingParameters": {
    object (RoutingParameters)
  }
}
Fields
languageCode

string

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

string

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[]

string

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[]

string

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[]

string

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[]

string

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

integer

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

object (LocationRestriction)

Required. The region to search.

rankPreference

enum (RankPreference)

How results will be ranked in the response.

routingParameters

object (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 (Place)
    }
  ],
  "routingSummaries": [
    {
      object (RoutingSummary)
    }
  ]
}
Fields
places[]

object (Place)

A list of places that meets user's requirements like places types, number of places and specific location restriction.

routingSummaries[]

object (RoutingSummary)

A list of routing summaries where each entry associates to the corresponding place in the same index in the places field. If the routing summary is not available for one of the places, it will contain an empty entry. This list should have as many entries as the list of places if requested.

LocationRestriction

The region to search.

JSON representation
{

  // Union field type can be only one of the following:
  "circle": {
    object (Circle)
  }
  // End of list of possible types for union field type.
}
Fields

Union field type.

type can be only one of the following:

circle

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