Method: resolveNames

Phân giải danh sách tên địa điểm (hoặc địa chỉ) thành các thực thể không gian địa lý cụ thể (ví dụ: địa điểm) trên Google Maps.

Yêu cầu HTTP

POST https://mapstools.googleapis.com/v1:resolveNames

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

Nội dung yêu cầu

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

Biểu diễn dưới dạng JSON 
{
  "queries": [
    {
      object (LocationQuery)
    }
  ],
  "locationBias": {
    object (LocationBias)
  },
  "regionCode": string
}
Trường
queries[]

object (LocationQuery)

Bắt buộc. Danh sách các truy vấn về vị trí cần được phân giải. Bạn có thể chỉ định tối đa 20 cụm từ tìm kiếm.
locationBias

object (LocationBias)

Không bắt buộc. Một khu vực không bắt buộc để thiên vị kết quả phân giải. Nếu được chỉ định, kết quả phân giải sẽ thiên về những thực thể gần khu vực này hơn. Việc thêm locationBias hoặc regionCode thường mang lại kết quả tốt hơn bằng cách thu hẹp không gian tìm kiếm.

Nếu bạn chỉ định cả locationBias và regionCode, thì locationBias sẽ được ưu tiên hơn regionCode.
regionCode

string

Không bắt buộc. Mã khu vực không bắt buộc để thiên vị kết quả phân giải. Nếu được chỉ định, kết quả phân giải sẽ thiên về những thực thể ở trong hoặc gần khu vực được chỉ định. Đây phải là mã vùng CLDR. Ví dụ: "US" hoặc "CA". Việc thêm locationBias hoặc regionCode thường mang lại kết quả tốt hơn bằng cách thu hẹp không gian tìm kiếm.

Nếu bạn chỉ định cả locationBias và regionCode, thì locationBias sẽ được ưu tiên hơn regionCode.

Nội dung phản hồi

Thông báo phản hồi cho v1.resolveNames.

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:

Biểu diễn dưới dạng JSON 
{
  "results": [
    {
      object (Result)
    }
  ],
  "failedRequests": {
    integer: {
      object (Status)
    },
    ...
  },
  "saveToMapsUrl": string
}
Trường
results[]

object (Result)

Chỉ có đầu ra. Danh sách các thực thể được phân giải từ các truy vấn vị trí. Đảm bảo ánh xạ 1:1 với các chỉ mục queries của yêu cầu. Một chuỗi trống tại chỉ mục i cho biết quá trình phân giải không thành công cho truy vấn đó. Nếu quá trình phân giải không thành công, vui lòng kiểm tra trường failedRequests để biết trạng thái lỗi.
failedRequests

map (key: integer, value: object (Status))

Chỉ có đầu ra. Một bản đồ cho biết một số lỗi. Khoá là chỉ mục của yêu cầu không thành công trong trường queries. Giá trị này là trạng thái lỗi nêu chi tiết lý do khiến quá trình phân giải không thành công.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
saveToMapsUrl

string

Chỉ có đầu ra. Đường liên kết để lưu tất cả các thực thể đã được phân giải thành công trong Google Maps.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/maps-platform.mapstools

LocationQuery

Cụm từ tìm kiếm vị trí thể hiện một thực thể vị trí cụ thể có thể được phân giải bằng Google Maps. Hiện tại, chỉ có tên địa điểm và địa chỉ được hỗ trợ dưới dạng truy vấn vị trí.

Biểu diễn dưới dạng JSON 
{
  "text": string
}
Trường
text

string

Bắt buộc. Cụm từ tìm kiếm dạng văn bản để phân giải thành một thực thể không gian địa lý cụ thể trên Google Maps, chẳng hạn như một địa điểm hoặc địa chỉ. Câu hỏi càng cụ thể thì giải pháp càng chính xác. Ví dụ: "San Francisco", "Googleplex, Mountain View, California", "1600 Amphitheatre Parkway, Mountain View, California" hoặc "Tháp Eiffel, Paris". Cụm từ tìm kiếm phải là một địa chỉ hoặc tên địa điểm cụ thể. Chúng tôi không hỗ trợ các vị trí chung chung như tên chuỗi cửa hàng (ví dụ: Starbucks) hoặc cụm từ tìm kiếm như "nhà hàng".

LocationBias

Vùng để tạo xu hướng cho kết quả phân giải.

Biểu diễn dưới dạng JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "viewport": {
    object (Viewport)
  }
  // End of mutually exclusive fields.
}
Trường
Loại thiên kiến về vị trí. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
viewport

object (Viewport)

Khung nhìn được xác định bằng một hộp bao quanh.
Kết thúc các trường loại trừ lẫn nhau.

Kết quả

Một thực thể duy nhất được phân giải từ một truy vấn vị trí nhất định, cùng với mức độ tin cậy của giải pháp.

Biểu diễn dưới dạng JSON 
{
  "entity": {
    object (Entity)
  },
  "confidence": enum (Confidence)
}
Trường
entity

object (Entity)

Chỉ có đầu ra. Thực thể được phân giải từ truy vấn vị trí.
confidence

enum (Confidence)

Chỉ có đầu ra. Mức độ tin cậy của độ phân giải.

Độ tin cậy

Mức độ tin cậy của độ phân giải.

Enum
CONFIDENCE_UNSPECIFIED Giá trị mặc định. Giá trị này không được dùng.
MEDIUM Độ tin cậy trung bình cho biết giải pháp có khả năng chính xác nhưng có thể có những giải pháp khác.
HIGH Độ tin cậy cao cho biết độ phân giải chính xác và thể hiện một thực thể không gian địa lý cụ thể (ví dụ: một địa điểm cụ thể).