Method: resolveMapsUrls

Phân giải danh sách URL của Google Maps 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/v1alpha:resolveMapsUrls

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 
{
  "urls": [
    string
  ]
}
Trường
urls[]

string

Bắt buộc. URL trên Google Maps cần được phân giải. Mỗi URL phải là một URL hợp lệ của Google Maps, ví dụ: https://maps.app.goo.gl/..., https://www.google.com/maps/place/... hoặc https://maps.google.com/.... Hiện tại, chúng tôi chỉ hỗ trợ những URL trỏ đến một địa điểm duy nhất. Bạn có thể chỉ định tối đa 20 URL.

Nội dung phản hồi

Thông báo phản hồi cho v1alpha.resolveMapsUrls.

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 
{
  "entities": [
    {
      object (Entity)
    }
  ],
  "failedRequests": {
    integer: {
      object (Status)
    },
    ...
  }
}
Trường
entities[]

object (Entity)

Chỉ có đầu ra. Danh sách các thực thể đã phân giải từ URL Google Maps. Đảm bảo ánh xạ 1:1 với các chỉ mục urls của yêu cầu. Một thông báo trống tại chỉ mục i (nơi không có entity nào được đặt) cho biết quá trình phân giải không thành công đối với URL đó. 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. Bản đồ truyền đạt các lỗi một phần cho URL của Google Maps. Khoá là chỉ mục của yêu cầu không thành công trong trường urls. Giá trị này là trạng thái lỗi cho biế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" }.

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/maps-platform.mapstools
  • https://www.googleapis.com/auth/cloud-platform.read-only