Geocoding API 是一項服務，可接受地點做為地址、經緯度座標或地點 ID。這項服務可將地址轉換為經緯度座標和地點 ID，或將經緯度座標或地點 ID 轉換為地址。
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 專案。
- 開始使用範例要求和回應：請參閱「地理編碼要求和回應」
- 遵循最佳做法：請參閱「地理編碼地址最佳做法」。