使用 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 取得的資源,以及這個 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 下載這些檔案,您也可以在其中找到安裝操作說明和程式碼範例。