Roads API 總覽

Roads API 是一項服務，可接受地圖上一個或多個點的經緯度座標 HTTPS 要求。系統會使用這些點來找出附近的路段，並傳回地點 ID 和中繼資料 (例如最近的路段和速限)。

使用 Roads API 的原因

您可以使用 Roads API 取得速限、預估抵達時間或其他道路中繼資料。有了這項道路中繼資料，您就能透過以下追蹤功能強化行車應用程式：

  • 將經緯度座標連結至道路。
  • 根據一組座標找出最近的道路
  • 取得路段的速限

Roads API 的用途

使用 Roads API 時，您可以將 GPS 座標對應至道路的幾何圖形，並判斷路段的速限。

  • 貼齊道路：這項服務會根據提供的 GPS 座標組合，傳回最有可能行經的道路。您最多可以指定沿路收集的 GPS 點數為 100 個。您也可以選擇要求服務對其他點進行內插，以便路徑順暢地沿著道路的幾何圖形移動。
  • Nearest Roads：這項服務會傳回 GPS 點最近的路段。您最多可以指定 100 個 GPS 點。您指定的點不必是連續路徑的一部分。
  • 速限：這項服務會傳回路段的規定速限。所有擁有資產追蹤授權的客戶都可以使用速限服務。對於改用即付即用定價模式的 Google 地圖平台付費方案客戶，這項功能仍會保持啟用狀態。

Roads API 的運作方式

Roads API 使用三個端點，可接受經緯度座標或地點 ID，提供道路路徑、路段或限速資料。以下範例說明如何根據一組經緯座標要求最近的道路：

https://roads.googleapis.com/v1/nearestRoads
  ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
  &key=YOUR_API_KEY

資源

下表概略說明透過 Roads API 提供的資源，以及該 API 傳回的資料。

資料資源 傳回的資料 傳回格式
比對路徑

傳回路線中最多 100 個 GPS 點的陣列。包含經過道路修正的經度/緯度座標，以及地點 ID。詳情請參閱「貼近道路」指南中的「回應」。
  • JSON
最近的道路

陣列最多可包含 100 個獨立經緯度座標，以及每個指定點最近道路的地點 ID。點不必連續。詳情請參閱「最近的道路」指南中的「回應」。
速限

陣列，最多可包含 100 個道路中繼資料元素。這些資料包含速限和地點 ID，單位為公里/小時或英里/小時。詳情請參閱速限指南中的「回應」。

如何使用 Roads API

1 試用貼齊道路示範模式 按一下示範內容建立路線，瞭解如何使用「對齊道路」端點提供流暢的資料。請參閱「貼齊道路」指南中的示範 。您不需要 API 金鑰。
2 做好準備 請先設定 Google Cloud 專案，並完成後續的設定操作說明，然後瞭解如何使用 API 金鑰。
3 嘗試使用對齊道路要求 使用其中一個貼齊道路的範例 ，並嘗試與您的用途相關的範例。
4 取得路徑的速限 使用與對齊道路要求相同的路徑資料，發出速限查詢。請參閱使用路徑的示例要求。
5 瞭解如何處理長路徑 請按照「進階概念」指南中的「處理長路徑」一節操作。
6 將道路資料整合至您自己的應用程式！ 請參閱道路擷取示範的詳細程式碼範例，開始在您自己的應用程式中建構道路資料功能。

可用的用戶端程式庫

透過下列任一用戶端程式庫，以您選擇的語言呼叫此 API：

Google 地圖服務適用的 Java、Python、Go 和 Node.js 用戶端都是社群支援的用戶端程式庫，並依據 Apache 2.0 授權的條款提供開放原始碼。您可以從 GitHub 下載這些用戶端或相關貢獻項目，並查看安裝操作說明和程式碼範例。

後續步驟