Geocoding API 服務可接受地點做為地址、經緯度座標或地點 ID，這項服務會將地址轉換為經緯度座標和地點 ID，或將經緯度座標或地點 ID 轉換為地址。
Geocoding API v4 提供超地方目的地和抵達智慧功能，以及核心座標到地址解析。無論是要打造最後一哩路配送、共乘或即時路況導航體驗，還是將街道地址正規化為座標，第 4 版都提供專屬端點，可依您的用途量身打造。
不確定哪個端點適合您的應用程式嗎？請參閱「選擇地理編碼方法」。
Geocoding API 的用途
Geocoding API v4 包含下列功能和端點：
- 搜尋目的地：根據地址、地點 ID 或座標，擷取目的地的超地方抵達詳情，包括建築物入口、可規劃路線的導航點權杖、建築物和地面輪廓、子目的地和附近地標。
- 將地址進行地理編碼：將街道地址轉換為地理座標和地點 ID (正向地理編碼)。
- 將地點進行地理編碼：將經緯度座標轉換為人類可讀的街道地址或行政區 (反向地理編碼)。
- 對地點進行地理編碼：擷取已知 Google 地圖地點 ID 的格式化地址詳細資料和座標。
您可以控制結果顯示的位置，並將結果限制在特定區域、縣市或郵遞區號。
立即試用
Geocoding API 的運作方式
Geocoding API v4 支援目的地搜尋和基本地理編碼：
- 目的地搜尋 (
SearchDestinations)：將地址、地點 ID 或座標組合解析為豐富的Destination物件。如果實際抵達地點很重要，請使用這個方法，例如找出偏好的建築物入口、使用導航點權杖將司機導向指定的上車或下車地點、在地圖上顯示建築物占地面積，或在多棟建築物組成的建築群中導航。 - 基本地理編碼：在地址、座標和地點 ID 之間轉換：
- 地理編碼：將街道地址 (例如「1600 Amphitheatre Parkway, Mountain View, CA」) 轉換成經緯度座標或地點 ID，以便放置地圖標記或將地圖檢視畫面置中。
- 反向地理編碼：將經緯度座標或地點 ID 轉換成人類可讀的街道地址，用於使用者放置的地圖圖釘、位置挑選器或 UI 顯示。
- 地點地理編碼：擷取已知 Google 地圖地點 ID 的地址詳細資料和座標。
下表摘要列出 Geocoding API v4 提供的資源，以及各方法傳回的資料：
| 資料資源 | 傳回的資料 | 傳回格式 |
|---|---|---|
| 搜尋目的地 ( POST /v4/geocode/destinations)
|
傳回超地方抵達智慧資訊：建築物和地面多邊形 (displayPolygon)、實體 entrances、可規劃路線的 navigationPoints (含權杖)、階層式 containingPlaces 和 subDestinations、關聯式 landmarks，以及主要地點詳細資料。請參閱「搜尋目的地」。
|
|
| 為地址進行地理編碼 ( GET /v4/geocode/address)
|
傳回地址、地址元件和地址類型。請參閱「地理編碼回應」。 | |
| 將位置進行地理編碼 ( GET /v4/geocode/location)
|
傳回地址、地址元件和地址類型。請參閱「反向地理編碼回應」。 | |
| 對地點進行地理編碼 ( GET /v4/geocode/places)
|
傳回地址、地址元件和地址類型。請參閱「地點地理編碼回應」。 |
推出階段管道
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。如要進一步瞭解安全實作模式和用戶端需求的替代方案，請參閱「安全性考量」。