Geocoding API 服務可接受地點做為地址、經緯度座標或地點 ID，這項服務會將地址轉換為經緯度座標和地點 ID，或將經緯度座標或地點 ID 轉換為地址。
Geocoding API 的用途
您可以使用 Geocoding API，取得一或多個地址或地點的地理編碼資料，包括：
這個版本的 Geocoding API v4 包含下列端點：
- 為地址進行地理編碼：取得地址的地理座標。也稱為「正向地理編碼」。
- 地理編碼位置 — 經緯度座標組的地址。也稱為「反向地理編碼」。
- 地點地理編碼：從地點 ID 擷取地址。
- 搜尋目的地：依地址、地點 ID 或位置搜尋目的地。
您可以控制結果顯示的位置，並將結果限制在特定區域、縣市或郵遞區號。
立即試用
Geocoding API 的運作方式
Geocoding API 可同時執行地理編碼和反向地理編碼：
- 地理編碼：將地址 (例如「1600 Amphitheatre Parkway, Mountain View, CA」) 轉換成經緯度座標或地點 ID。您可以使用這些座標在地圖上放置標記，或在檢視畫面中將地圖置中或重新定位。
- 反向地理編碼：將經緯度座標或地點 ID 轉換為人類可讀的地址。地址可用於多種情境，包括外送或自取。
下表匯總了 Geocoding API 提供的資源，以及各方法傳回的資料。
| 資料資源 | 傳回的資料 | 傳回格式 |
|---|---|---|
| 地理編碼 | 傳回地址、地址元件和地址類型。請參閱地理編碼回應說明文件。 |
|
| 反向地理編碼 | 傳回地址、地址元件和地址類型。請參閱反向地理編碼回應說明文件。 | |
| 地點地理編碼 | 傳回地址、地址元件和地址類型。請參閱地點地理編碼回應說明文件。 | |
| 目的地搜尋 | 根據不同的輸入條件 (例如地址、地點 ID 或經緯度座標)，傳回各種目的地的詳細資訊。請參閱目的地搜尋說明文件。 |
推出階段管道
Geocoding API 第 4 版有獨立管道，分別提供正式發布版、預先發布版和實驗功能。如要使用預先發布版或實驗功能，請務必在要求中指定正確的管道。舉例來說，如要存取實驗版中 Destinations 端點的功能，請使用下列 HTTP 要求：https://geocode.googleapis.com/v4alpha/geocode/destinations。
| 推出階段 | 頻道名稱 |
|---|---|
| GA | /v4/ |
| 預覽 | /v4beta/ |
| 實驗功能 | /v4alpha/ |
Geocoding API v4 的功能
Geocoding API 第 4 版提供下列新功能。
目的地搜尋方式
v4 推出目的地搜尋方法，可讓您根據不同的輸入條件 (例如地址、地點 ID 或經緯度座標)，擷取各種目的地的詳細資訊。回應包含 AI 輔助的摘要和導航點權杖，其中含有可傳遞至 Navigation SDK 的情境資訊，用於精確規劃路線。
在 Google Cloud 標準平台上實作
Geocoding API v4 是在 Google Cloud 的 Service Infrastructure 上實作。這項實作可提供更安全可靠的平台，並提供 OAuth 等進階安全性選項。這項標準 API 設計可確保 API 之間的一致性，提高 Geocoding API v4 的開發效率。
新增 OAuth 支援
Geocoding API v4 支援使用 OAuth 2.0 進行驗證。Google 支援常見的 OAuth 2.0 情境，例如網路伺服器。
新增欄位遮罩支援
使用欄位遮罩指定回應應傳回的資訊。如果是「Geocode an address」(對地址進行地理編碼)、「Geocode a location」(對位置進行地理編碼) 和「Place geocoding」(地點地理編碼) 方法，系統預設會傳回回應物件中的所有欄位。使用搜尋目的地方法時，您必須在 API 要求中指定欄位遮罩。
API 安全性
Geocoding API v4 是伺服器對伺服器 API。直接從瀏覽器發出用戶端呼叫，會使 API 金鑰面臨遭竊和濫用的重大風險，因為 HTTP 參照網址限制不足以保護 Web 服務端點。
強烈建議您從自己的後端伺服器呼叫 Geocoding API v4。如要進一步瞭解安全實作模式和用戶端需求的替代方案，請參閱「安全性考量」。