Method: resolveMapsUrls

將 Google 地圖網址清單解析為 Google 地圖上的特定地理空間實體 (例如地點)。

HTTP 要求

POST https://mapstools.googleapis.com/v1alpha:resolveMapsUrls

這個網址使用 gRPC 轉碼語法。

要求主體

要求主體會包含結構如下的資料：

JSON 表示法 
{
  "urls": [
    string
  ]
}
欄位
urls[]

string

必填。要解析的 Google 地圖網址。每個網址都必須是有效的 Google 地圖網址，例如 https://maps.app.goo.gl/...、https://www.google.com/maps/place/... 或 https://maps.google.com/...。目前僅支援指向單一地點的網址。最多可以指定 20 個網址。

回應主體

v1alpha.resolveMapsUrls 的回應訊息。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "entities": [
    {
      object (Entity)
    }
  ],
  "failedRequests": {
    integer: {
      object (Status)
    },
    ...
  }
}
欄位
entities[]

object (Entity)

僅供輸出。Google 地圖網址中已解析的實體清單。保證會與要求 urls 索引 1:1 對應。索引 i 的空白訊息 (未設定 entity) 表示該網址的解析失敗。如果解析失敗，請檢查 failedRequests 欄位的錯誤狀態。
failedRequests

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

僅供輸出。地圖會傳達 Google 地圖網址的部分失敗情形。索引是 urls 欄位中失敗要求的索引鍵。這個值是錯誤狀態，詳細說明解析失敗的原因。

這個物件中包含 "key": value 組合的清單，範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

授權範圍

需要下列其中一種 OAuth 範圍：

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