使用 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。詳情請參閱「貼齊道路」指南中的回應。 |
|
最近的道路 |
最多包含 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 下載這些資料,您也可以在這裡找到安裝說明和程式碼範例。