使用 Roads API 的好處
Roads API 提供速限 或其他道路中繼資料。沿著這條路 中繼資料，您可以使用下列功能強化行車應用程式：
- 將經緯度座標與道路或道路連結。
- 尋找距離一組座標的最近道路
- 查看路段的速限
Roads API 可執行的操作
有了 Roads API，您可以將 GPS 座標對應到 ，並判斷道路上的速限 區隔
- 貼齊道路這項服務會傳回 根據所提供的 GPS 座標集來行駛的道路。最多可以指定 100 個 沿路線收集到的 GPS 點。您也可以選擇要求服務 內插其他的點，使路徑與 道路的幾何形狀。
- 最近的道路這項服務會傳回最近的道路 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 和其傳回的資料。
| 資料資源 | 傳回的資料 | 退貨格式 |
|---|---|---|
| 對齊道路 |
傳迴路線中最多包含 100 個 GPS 點的陣列。收錄 沿著道路連接的經緯度座標 。詳情請參閱： 回覆 貼齊道路中的 指南。 |
|
| 最近的道路 |
最多可包含 100 個獨立經緯度座標的陣列 以及最近一個指定點的最近道路的地點 ID。 積分不一定要是連續的。詳情請參閱： 回覆 最近的道路 指南。 |
|
| 速限 |
加入最多 100 個道路中繼資料元素的陣列。牽涉到速度 限制和地點 ID，含單位為 KPH 或 MPH。查看詳情 在回覆中 速限 指南。 |
如何使用 Roads API
| 1 | 試試貼齊道路功能示範 | 按一下示範即可建立軌跡，看看它如何對齊道路端點 以提供流暢的資料詳情請見 示範 。不過，您不需要提供 API 金鑰。 |
| 2 | 做好準備 | 首先，請設定您的 Google Cloud 專案並完成設定程序 並學習 如何使用 API 金鑰。 |
| 3 | 嘗試貼齊道路要求 | 採用其中之一 試著找出適合您用途的道路範例 。 |
| 4 | 瞭解道路的速限 | 請使用你針對道路對齊要求提供的路徑資料， 發出速限查詢詳情請參閱 使用路徑的要求範例。 |
| 5 | 瞭解如何處理長路徑 | 遵循以下各節： 處理長路徑 進階概念指南。 |
| 6 | 將道路資料加入自己的應用程式！ | 詳情請參閱 詳細程式碼範例 在自己的應用程式中建構道路資料功能。 |
可用的用戶端程式庫
如要呼叫這個 API，請使用 從以下用戶端程式庫中擇一：
Google 地圖適用的 Java 用戶端、Python 用戶端、Go 用戶端和 Node.js 用戶端 服務是社群支援的用戶端程式庫，並採用 Apache 2.0 授權。 您可以從 GitHub 下載這些範例，也可以在其中找到安裝操作說明和程式碼範例。