Method: geocode.address.geocodeAddressQuery

這個方法會執行地址地理編碼，將地址對應至 LatLng。此外，也會提供地址的結構化資訊。

HTTP 要求

GET https://geocode.googleapis.com/v4/geocode/address/{addressQuery}

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

路徑參數

參數
要進行地理編碼的地址。以下是互斥欄位清單。回應中最多會設定下列其中一個欄位：
addressQuery

string

要進行地理編碼的非結構化地址。
互斥欄位結束。

查詢參數

參數
locationBias

object (GeocodeAddressRequest.LocationBias)

(選用步驟) 要搜尋的區域。這個位置會做為偏好設定，也就是說，系統會優先顯示指定位置附近的結果。
languageCode

string

(選用步驟) 傳回結果時應使用的語言。
regionCode

string

(選用步驟) 區域代碼。區碼，指定為 ccTLD (「頂層網域」) 的兩位字元值。這個參數會根據適用法律影響結果。這項參數也會影響 (但不會完全限制) 服務提供的結果。
要進行地理編碼的地址。以下是互斥欄位清單。回應中最多會設定下列其中一個欄位：
address

object (PostalAddress)

要進行地理編碼的結構化地址，格式為郵寄地址。
互斥欄位結束。

要求主體

要求主體必須為空白。

回應主體

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

授權範圍

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

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.address