Geocoding API 4.0 總覽

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

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

Geocoding API 的用途

您可以使用 Geocoding API 取得一或多個地址或地點的地理編碼資料，包括：

這個版本的 Geocoding API 第 4 版包含下列端點：

您可以控制結果的顯示位置，並將結果限制在特定區域、郡或郵遞區號。

Geocoding API 的運作方式

Geocoding API 可執行地理編碼和反向地理編碼：

  • 地理編碼：將地址 (例如「1600 Amphitheatre Parkway, Mountain View, CA」) 轉換為經緯度座標或地點 ID。您可以使用這些座標在地圖上放置標記，或在檢視畫面框架內置中或重新定位地圖。
  • 反向地理編碼： 將經緯度座標或地點 ID 轉換為人類可讀的地址。地址可用於各種情況，包括送貨或取貨。

下表摘要列出 Geocoding API 提供的資源，以及每個端點傳回的資料。

資料資源 傳回的資料 傳回格式
地理編碼 傳回地址、地址元件和地址類型。請參閱地理編碼回應說明文件。
  • JSON
反向地理編碼 傳回地址、地址元件和地址類型。請參閱「反向地理編碼回應」說明文件。
地點地理編碼 傳回地址、地址元件和地址類型。請參閱地點地理編碼回應說明文件。
目的地搜尋 根據不同的輸入條件 (例如地址、地點 ID 或經緯度座標)，傳回各種目的地的詳細資訊。請參閱目的地搜尋說明文件。

Geocoding API 第 4 版的功能

Geocoding API 第 4 版提供這些新功能。

目的地搜尋端點

第 4 版推出目的地搜尋端點，可讓您根據不同的輸入條件 (例如地址、地點 ID 或經緯度座標)，擷取各種目的地的詳細資訊。回覆內容包括 AI 輔助摘要和導航點權杖，其中包含可傳遞至 Navigation SDK 的背景資訊，用於精確路線規劃。

在 Google Cloud 標準平台實作

Geocoding API 第 4 版是在 Google Cloud 的服務基礎架構上實作，這項實作作業可帶來更安全可靠的平台，並提供更完善的安全防護選項，例如 OAuth。這項標準 API 設計可讓各 API 保持一致，進而提升 Geocoding API v4 的開發效率。

新增 OAuth 支援

Geocoding API v4 支援使用 OAuth 2.0 進行驗證。Google 支援常見的 OAuth 2.0 使用情境，例如網路伺服器。

新增欄位遮罩支援

使用欄位遮罩指定回應應傳回的資訊。對於「地理編碼地址」、「地理編碼位置」和「地點地理編碼」端點，系統預設會傳回回應物件中的所有欄位。對於「搜尋目的地」端點，您必須在 API 要求中指定欄位遮罩。

預先發布期間免付費

Geocoding API 第 4 版目前處於預先發布階段，預先發布期間使用 API 不會產生任何費用。API 呼叫會顯示在 Cloud Console 的「帳單」頁面，但費用為 $0 美元。

意見回饋

這是預先發布版功能。歡迎傳送電子郵件至 geocoding-feedback-channel@google.com 提供意見。