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 |
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 |
Ngôn ngữ ưu tiên cho vị trí trùng khớp (ở định dạng BCP-47). |
numResults |
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 |
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 ' |
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 ( |
Các trường | |
---|---|
matchedLocations[] |
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 |
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ụ: |
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 ( |
Các trường | |
---|---|
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 |
isExactMatch |
Đây có phải là kết quả trùng khớp hoàn toàn không? |