Method: resolveNames

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

HTTP 要求

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

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

要求主體

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

JSON 表示法
{
  "queries": [
    {
      object (LocationQuery)
    }
  ],
  "locationBias": {
    object (LocationBias)
  },
  "regionCode": string
}
欄位
queries[]

object (LocationQuery)

必填。要解析的位置查詢清單。最多可指定 20 項查詢。

locationBias

object (LocationBias)

(選用步驟) 選用區域,用於偏向解析結果。如果指定,解析結果會偏向靠近這個區域的實體。加入 locationBias 或 regionCode 通常能縮小搜尋範圍,提供更準確的結果。

如果同時指定 locationBias 和 regionCode,locationBias 的優先順序高於 regionCode。

regionCode

string

(選用步驟) 可選用的區域代碼,用於偏重解析結果。如果指定,解析結果會偏向位於指定區域內或附近的實體。請使用 CLDR 區域代碼。例如「US」或「CA」。加入 locationBias 或 regionCode 通常能縮小搜尋範圍,提供更準確的結果。

如果同時指定 locationBias 和 regionCode,locationBias 的優先順序高於 regionCode。

回應主體

如果成功,回應主體會包含 ResolveNamesResponse 的執行個體。

授權範圍

需要下列 OAuth 範圍:

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