Roads API 總覽

Roads API 服務接受 HTTPS 要求，其中包含地圖上一或多個點的經緯度座標。並使用這些點找出附近路段，然後傳回地點 ID 和中繼資料，例如最近的路段和速限。

為何要使用 Roads API

Roads API 可提供速限、預計到達時間或其他道路中繼資料。有了這項道路中繼資料，您就能運用下列功能強化行車應用程式：

  • 將經緯度座標與一或多條道路連結。
  • 找出與一組座標最接近的道路
  • 取得路段速限

Roads API 的用途

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

  • 比對路徑：這項服務會根據提供的一組 GPS 座標，傳回最可能的行經道路。您最多可以指定沿著路線收集的 100 個 GPS 點。您也可以視需要要求服務插入其他點，讓路徑順暢地沿著道路幾何圖形延伸。
  • Nearest Roads：這項服務會傳回最靠近 GPS 點的路段。最多可以指定 100 個 GPS 點。指定的點不一定要是連續路徑的一部分。
  • 速限：這項服務會傳回路段的速限。凡是具備資產追蹤授權的客戶，皆可使用速限服務。如果 Google Maps Platform 付費方案客戶已改用即付即用定價模式，這項功能仍會保持啟用狀態。

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 取得的資源，以及傳回的資料。

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

傳回路線中最多 100 個 GPS 點的陣列。包含經緯度座標 (已貼齊道路) 和地點 ID。詳情請參閱「比對路徑」指南中的「回應」一節。
  • JSON
Nearest roads

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

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

如何使用Roads API

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

可用的用戶端程式庫

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

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

後續步驟