The Q&A API is now launched! Migration work is required. Please see our deprecation schedule for more information related to deprecated endpoints.
v1.1 of the Notifications API is now launched! Please see our change log for more information. You may also sign up for our mailing list to receive updates.


Search all of the possible locations that are a match to the specified request.

HTTP request


The URL uses gRPC Transcoding syntax.

Request body

The request body contains data with the following structure:

JSON representation
  "pageSize": integer,

  // Union field search_query can be only one of the following:
  "location": {
    object (Location)
  "query": string
  // End of list of possible types for union field search_query.


The number of matches to return. The default value is 3, with a maximum of 10. Note that latency may increase if more are requested. There is no pagination.

Union field search_query. Search query. This can be provided either as a location object or as a string query. search_query can be only one of the following:

object (Location)

Location to search for. If provided, will find locations which match the provided location details.



Text query to search for. The search results from a query string will be less accurate than if providing an exact location, but can provide more inexact matches.

Response body

If successful, the response body contains data with the following structure:

Response message for GoogleLocations.SearchGoogleLocations.

JSON representation
  "googleLocations": [
      object (GoogleLocation)

object (GoogleLocation)

A collection of GoogleLocations that are potential matches to the specified request, listed in order from most to least accuracy.

Authorization Scopes

Requires the following OAuth scope:


For more information, see the OAuth 2.0 Overview.