Geocoding API 總覽

歐洲經濟區 (EEA) 開發人員

Geocoding API 是一項服務，可接受地點為地址、經緯度座標或地點 ID。將地址轉換為經緯度座標和地點 ID，或將經緯度座標或地點 ID 轉換為地址。

使用 Geocoding API 的原因

如要在 Google 地圖平台 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
反向地理編碼 傳回地址、地址元件和地址類型。請參閱反向地理編碼要求和回應指南中的「反向地理編碼回應」。
地點地理編碼 傳回地址、地址元件和地址類型。請參閱「Place 地理編碼要求和回應指南」中的「反向地理編碼回應」。

如何使用 Geocoding API

1 進行設定。 請先設定 Google Cloud 專案，然後完成後續設定說明。
2 嘗試地理編碼要求 取得 API 金鑰後，您就可以直接透過 curl 或瀏覽器測試 Geocoding API。您必須為地址或元件查詢提供正確的查詢參數。詳情請參閱「地理編碼參數」。
3 嘗試反向地理編碼要求 請提供經緯度座標和 API 金鑰，以便取得該位置最接近且人類可讀的地址的地址元件。詳情請參閱「反向地理編碼要求」一文。
4 瞭解回應的基本概念 Geocoding API 中的所有端點都會以 JSON 或 XML 格式傳回相同的資料。如要瞭解資料、狀態碼和錯誤訊息，請參閱「Geocoding 回應」。
5 將地理編碼資料納入您自己的應用程式！ 您可以使用地理編碼資料，從地圖標記取得地址，或是根據已知地址在地圖上提供標記。

可用的用戶端程式庫

透過下列任一用戶端程式庫，以您選擇的語言呼叫此 API：

Google 地圖服務適用的 Java、Python、Go 和 Node.js 用戶端都是社群支援的用戶端程式庫，並依據 Apache 2.0 授權的條款提供開放原始碼。您可以從 GitHub 下載這些用戶端或相關貢獻項目，並查看安裝操作說明和程式碼範例。

後續步驟