The Business Profile Performance API is now launched! Migration work is required.
Review the deprecation schedule and instructions to migrate over to new v1 APIs from older deprecated v4 API.
Help us improve the food menu experience by filling in this survey to better understand what place, menu, and dish attributes you can provide about the merchants you support

Method: accounts.locations.findMatches

Stay organized with collections Save and categorize content based on your preferences.

Finds all of the possible locations that are a match to the specified location. This operation is only valid if the location is unverified.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



The resource name of the location to find matches for.

Request body

The request body contains data with the following structure:

JSON representation
  "languageCode": string,
  "numResults": integer,
  "maxCacheDuration": string


The preferred language for the matching location (in BCP-47 format).



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.


string (Duration format)

Deprecated. This field is ignored for all requests.

A duration in seconds with up to nine fractional digits, terminated by 's'. Example: "3.5s".

Response body

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

Response message for Locations.FindMatchingLocations.

JSON representation
  "matchedLocations": [
      object (MatchedLocation)
  "matchTime": string

object (MatchedLocation)

A collection of locations that are potential matches to the specified location, listed in order from best to least match. If there is an exact match, it will be in the first position.


string (Timestamp format)

When the matching algorithm was last executed for this location.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the OAuth 2.0 Overview.


Represents a possible match to a location.

JSON representation
  "location": {
    object (Location)
  "isExactMatch": boolean

object (Location)

The sparsely populated location that is a potential match. Unpopulated fields include, but may not be limited to: name (the matched location cannot be retrieved via locations.get nor locations.batchGet); storeCode; serviceArea coverage area details; labels; adWordsLocationExtensions; photos



Is this an exact match?