Method: accounts.locations.findMatches

Tìm thấy tất cả vị trí có thể trùng khớp với vị trí đã chỉ định. Thao tác này chỉ hợp lệ nếu vị trí chưa được xác minh.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Các tham số
name

string

Tên tài nguyên của vị trí cần tìm kết quả phù hợp.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "languageCode": string,
  "numResults": integer,
  "maxCacheDuration": string
}
Các trường
languageCode

string

Ngôn ngữ ưu tiên cho vị trí trùng khớp (ở định dạng BCP-47).
numResults

integer

Số lượng kết quả trùng khớp cần trả về. Giá trị mặc định là 3, tối đa là 10. Xin lưu ý rằng độ trễ có thể tăng lên nếu bạn yêu cầu thêm thời gian. Không có quá trình phân trang.
maxCacheDuration

string (Duration format)

Không dùng nữa. Trường này bị bỏ qua đối với mọi yêu cầu.

Thời lượng tính bằng giây có tối đa 9 chữ số phân số, kết thúc bằng 's'. Ví dụ: "3.5s".

Nội dung phản hồi

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Thông báo phản hồi cho Places.FindMatchingLocations.

Biểu diễn dưới dạng JSON 
{
  "matchedLocations": [
    {
      object (MatchedLocation)
    }
  ],
  "matchTime": string
}
Các trường
matchedLocations[]

object (MatchedLocation)

Tập hợp các vị trí có khả năng phù hợp với vị trí cụ thể, được liệt kê theo thứ tự từ phù hợp nhất đến ít nhất. Nếu có kết quả trùng khớp hoàn toàn, nội dung đó sẽ xuất hiện ở vị trí đầu tiên.
matchTime

string (Timestamp format)

Khi thuật toán so khớp được thực thi lần gần đây nhất cho vị trí này.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.

MatchedLocation

Đại diện cho một vị trí có thể trùng khớp.

Biểu diễn dưới dạng JSON 
{
  "location": {
    object (Location)
  },
  "isExactMatch": boolean
}
Các trường
location

object (Location)

Vị trí có dân cư thưa thớt mà có thể phù hợp. Các trường không được điền bao gồm nhưng không giới hạn ở: tên (không thể truy xuất vị trí trùng khớp qua locations.get hoặc locations.batchGet); storeCode; serviceArea thông tin về khu vực phủ sóng; labels; adWordsLocationExtensions; photos
isExactMatch

boolean

Đây có phải là kết quả trùng khớp hoàn toàn không?