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 |
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 |
Eşleşen konum için tercih edilen dil (BCP-47 biçiminde). |
numResults |
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 |
Kullanımdan kaldırıldı. Bu alan, tüm istekler için yoksayılır. En fazla dokuz kesir basamağı içeren ve " |
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 ( |
Alanlar | |
---|---|
matchedLocations[] |
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 |
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: |
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 ( |
Alanlar | |
---|---|
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, |
isExactMatch |
Bu tam eşleme mi? |