Method: accounts.locations.findMatches

Belirtilen konumla eşleşen tüm olası konumları bulur. Bu işlem yalnızca konum doğrulanmamışsa geçerlidir.

HTTP isteği

POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:findMatches

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
name

string

Eşleşmeleri bulunacak konumun kaynak adı.

İstek içeriği

İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:

JSON gösterimi 
{
  "languageCode": string,
  "numResults": integer,
  "maxCacheDuration": string
}
Alanlar
languageCode

string

Eşleşen konum için tercih edilen dil (BCP-47 biçiminde).
numResults

integer

Döndürülecek eşleşme sayısı. Varsayılan değer 3, en fazla 10 olabilir. Daha fazla talep istenirse gecikmenin artabileceğini unutmayın. Sayfalara ayırma yapılmaz.
maxCacheDuration

string (Duration format)

Kullanımdan kaldırıldı. Bu alan, tüm istekler için yoksayılır.

En fazla dokuz kesir basamağı içeren ve "s" ile sonlandırılan saniye cinsinden bir süre. Örnek: "3.5s".

Yanıt gövdesi

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

Konumlar.FindMatchingLocations için yanıt mesajı.

JSON gösterimi 
{
  "matchedLocations": [
    {
      object (MatchedLocation)
    }
  ],
  "matchTime": string
}
Alanlar
matchedLocations[]

object (MatchedLocation)

Belirtilen konumla eşleşme olasılığı yüksek olan konumlar, en iyiden en az eşleşene doğru sıralanmış şekilde listelenir. Tam eşleşme varsa bu ilk konumda olacaktır.
matchTime

string (Timestamp format)

Eşleşen algoritmanın bu konum için en son ne zaman çalıştırıldığı.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.

MatchedLocation

Bir konumla olası bir eşleşmeyi temsil eder.

JSON gösterimi 
{
  "location": {
    object (Location)
  },
  "isExactMatch": boolean
}
Alanlar
location

object (Location)

Olası bir eşleşme olan seyrek nüfuslu konum. Doldurulmayan alanlar şunları içerir, ancak bunlarla sınırlı değildir: name (eşleşen konum, locations.get veya locations.batchGet aracılığıyla alınamaz); storeCode; serviceArea kapsam alanı ayrıntıları; labels; adWordsLocationExtensions; photos
isExactMatch

boolean

Bu tam eşleme mi?