Geocoding API 總覽

Geocoding API 服務接受地點為地址、經緯度座標或 Place ID 的服務。會將地址轉換成經緯度座標和地點 ID,或將經緯度座標或地點 ID 轉換成地址。

使用 Geocoding API 的好處

如要在 Google Maps Platform API 提供的地圖中使用地理編碼資料,請使用 Geocoding API 網站或行動應用程式。透過 Geocoding API,您可以使用地址在地圖上加入標記,或是將地圖上的標記轉換成地址。這項服務旨在進行預先定義的靜態地址,以便在地圖上放置應用程式內容。

Geocoding API 的用途

您可以使用 Geocoding API 取得一或多個地址或地點的地理編碼資料,包括:

  • 地址的地理座標。
  • 經緯度座標組合的地址。
  • 地點 ID 的地址。

您可以控制結果的顯示位置,並將結果限制在特定區域、國家/地區或郵遞區號。

Geocoding API 的運作方式

Geocoding API 會同時進行地理編碼和反向地理編碼:

  • 地理編碼:將「1600 Amphitheatre Parkway, Mountain View, CA」之類的地址轉換為經緯度座標或地點 ID。您可以使用這些座標在地圖上放置標記,或是將地圖置中或重新置於檢視畫面頁框中。
  • 反向地理編碼:將經緯度座標或地點 ID 轉換為使用者可理解的地址。地址可用於多種情境,包括外送或自取。

以下示範透過 Maps JavaScript API 使用地理編碼服務,示範 Geocoding API 的運作方式。在另一個分頁中開啟地圖,即可查看更多選項和詳細資料。

資源

下表概述 Geocoding API 提供的資源,以及每個端點傳回的資料。

資料資源 傳回的資料 傳回格式
地理編碼 傳回地址、地址元件和地址類型。請參閱「地理編碼要求和回應」指南中的「結果」。
  • JSON
  • XML
反向地理編碼 傳回地址、地址元件和地址類型。請參閱反向地理編碼要求和回應指南中的反向地理編碼回應
地點地理編碼 傳回地址、地址元件和地址類型。請參閱地點地理編碼要求和回應指南中的反向地理編碼回應

如何使用 Geocoding API

1 開始設定 請先完成設定 Google Cloud 專案的設定,並完成後續設定操作說明。
2 試用地理編碼要求 取得 API 金鑰後,您可以直接從 cURL 或瀏覽器測試 Geocoding API。您必須提供正確的地址或元件查詢查詢參數。詳情請參閱地理編碼參數
3 試試反向地理編碼要求 使用 API 金鑰提供經緯度座標,藉此取得該位置最接近的人類可讀地址地址元件。詳情請參閱反向地理編碼要求
4 瞭解回應基本功能 Geocoding API 中的所有端點都會以 JSON 或 XML 傳回相同的資料。如需資料、狀態碼和錯誤訊息的說明,請參閱「地理編碼回應」一節。
5 將地理編碼資料整合至你的應用程式! 您可以使用地理編碼資料,從地圖標記取得地址,或根據已知地址在地圖上提供標記。

可用的用戶端程式庫

透過下列任一用戶端程式庫,以您選擇的語言呼叫這個 API:

Google 地圖服務適用的 Java 用戶端、Python 用戶端、Go 用戶端和 Node.js 用戶端都是社群支援的用戶端程式庫,並依據阿帕契 2.0 授權的條款提供開放原始碼。 您可以從 GitHub 下載,也可以在這裡找到安裝操作說明和程式碼範例。

後續步驟