Roads API 總覽

Roads API 服務可接受針對地圖上一或多個點,使用經緯度座標的 HTTPS 要求。並使用這些資料點尋找附近的路段,並傳回地點 ID 以及中繼資料,例如最近的路段和速限。

使用 Roads API 的好處

您可以透過 Roads API 取得速限、預估抵達時間或其他道路中繼資料,您可以運用道路中繼資料,以下列功能強化行車應用程式:

  • 連接經緯度座標與道路或道路。
  • 尋找以一組座標表示最近的道路
  • 取得路段的速限

Roads API 的用途

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

  • 沿道路規劃路線:這項服務會根據提供的 GPS 座標集傳回最有可能行駛的道路。您可以指定路徑上收集的 GPS 點 (最多 100 個)。或者,您也可以要求服務插入其他點,讓路徑順利跟隨道路的幾何形狀。
  • 最近的道路這項服務會傳回 GPS 點內最近 的路段。您最多可以指定 100 個 GPS 點。您指定的點不需要是連續路徑的一部分。
  • 速限:這項服務會傳回特定路段的速限資訊。所有具備資產追蹤授權的客戶都能使用 Speed Limit 服務。針對已轉換為即付即用定價的 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 提供的資源及其傳回的資料。

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

傳迴路線中最多 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 用戶端都是社群支援的用戶端程式庫,並依據阿帕契 2.0 授權的條款提供開放原始碼。從 GitHub 下載這些資料,您也可以在這裡找到安裝說明和程式碼範例。

後續步驟