Geocoding API 服務接受地點做為地址、經緯度座標或地點 ID。系統會將地址轉換成經緯度座標和地點 ID,或是將經緯度座標或地點 ID 轉換為地址。
使用 Geocoding API 的好處
您可以透過適用於網站或行動應用程式的 Geocoding API,在任一 Google 地圖平台 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 提供的資源,以及每個端點傳回的資料。
資料資源 | 傳回的資料 | 傳回格式 |
---|---|---|
地理編碼 | 傳回地址、地址元件和地址類型。請參閱「地理編碼要求和回應」指南中的結果。 |
|
反向地理編碼 | 傳回地址、地址元件和地址類型。請參閱「反向地理編碼要求和回應」指南中的「反向地理編碼回應」一節。 | |
地點地理編碼 | 傳回地址、地址元件和地址類型。請參閱「地點地理編碼要求和回應」指南中的「反向地理編碼回應」一節。 |
如何使用 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 下載,您也可以在此找到安裝指示和程式碼範例。
後續步驟
- 開始使用 Geocoding API:請參閱「設定 Google Cloud 專案」一文。
- 開始使用要求和回應範例:請參閱「地理編碼要求和回應」一文
- 遵循最佳做法:請參閱「地理編碼地址最佳做法」一文。