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ị trí cần được giải quyết. 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 để ưu tiên kết quả phân giải. Nếu được chỉ định, kết quả phân giải sẽ thiên về các 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ả chính xác hơn bằng cách thu hẹp phạm vi 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ã vùng không bắt buộc để ưu tiên kết quả phân giải. Nếu được chỉ định, kết quả phân giải sẽ thiên về các thực thể nằm 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ả chính xác hơn bằng cách thu hẹp phạm vi 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ừ 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. Chuỗi trống tại chỉ mục i cho biết không phân giải được 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 đồ thông báo lỗi một phần. Khoá là chỉ mục của yêu cầu không thành công trong trường queries. Giá trị 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. Một đườ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í đại diện cho 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ợ làm cụm từ tìm kiếm 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, CA", "1600 Amphitheatre Parkway, Mountain View, CA" 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í khái quát 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

Khu vực để ưu tiên 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 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 hộp giới hạn.
Kết thúc các trường loại trừ lẫn nhau.

Kết quả

Một thực thể đã 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 việc phân giải.

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 cho độ phân giải.

Độ tin cậy

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

Enum
CONFIDENCE_UNSPECIFIED Giá trị mặc định. Giá trị này không được sử dụng.
MEDIUM Mức độ tin cậy trung bình cho biết độ phân giải có thể chính xác nhưng có thể có các ứng cử viên khác.
HIGH Độ tin cậy cao cho biết kết quả phân giải là chính xác và đại diện cho một thực thể không gian địa lý cụ thể (ví dụ: một địa điểm cụ thể).