Method: accounts.locations.findMatches

Menemukan semua kemungkinan lokasi yang cocok dengan lokasi yang ditentukan. Operasi ini hanya valid jika lokasi belum diverifikasi.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Nama resource lokasi yang kecocokannya akan dicari.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "languageCode": string,
  "numResults": integer,
  "maxCacheDuration": string
}
Kolom
languageCode

string

Bahasa pilihan untuk lokasi yang cocok (dalam format BCP-47).
numResults

integer

Jumlah kecocokan yang akan ditampilkan. Nilai defaultnya adalah 3, dengan maksimum 10. Perlu diketahui bahwa latensi dapat meningkat jika permintaan yang diajukan lebih banyak. Tidak ada penomoran halaman.
maxCacheDuration

string (Duration format)

Tidak digunakan lagi. Kolom ini diabaikan untuk semua permintaan.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Pesan respons untuk Location.FindMatchingLocations.

Representasi JSON 
{
  "matchedLocations": [
    {
      object (MatchedLocation)
    }
  ],
  "matchTime": string
}
Kolom
matchedLocations[]

object (MatchedLocation)

Kumpulan lokasi yang berpotensi cocok dengan lokasi yang ditentukan, dicantumkan dalam urutan dari yang paling cocok hingga yang paling tidak cocok. Jika ada kecocokan persis, maka akan berada di posisi pertama.
matchTime

string (Timestamp format)

Saat algoritma pencocokan terakhir dieksekusi untuk lokasi ini.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

MatchedLocation

Menunjukkan kemungkinan kecocokan dengan lokasi.

Representasi JSON 
{
  "location": {
    object (Location)
  },
  "isExactMatch": boolean
}
Kolom
location

object (Location)

Lokasi yang jarang penduduknya yang berpotensi cocok. Kolom yang tidak terisi mencakup, tetapi tidak dapat terbatas pada: nama (lokasi yang cocok tidak dapat diambil melalui locations.get atau locations.batchGet); storeCode; serviceArea detail area cakupan; labels; adWordsLocationExtensions; photos
isExactMatch

boolean

Apakah hasil ini sama persis?