Roads API 總覽

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

使用 Roads API 的好處

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

使用 Roads API，您就能將 GPS 座標對應到道路的幾何圖形，並判斷道路路段上的速限。

對齊道路這項服務會根據提供的 GPS 座標，傳回最有可能行駛的道路。您最多可指定沿著路線收集的 100 個 GPS 點。或者，您也可以要求服務來插入其他點，讓路線順利行駛。
最近的道路：這項服務會傳回 GPS 點的最近路段。您最多可以指定 100 個 GPS 點。您指定的路徑不一定要屬於連續路徑。
速限：這項服務會傳迴路段的速限。速度限制服務適用於擁有資產追蹤授權的所有客戶。如果客戶改用以即付即用定價的 Google 地圖平台付費方案，該功能會維持有效狀態。

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，單位單位為 KPH 或 MPH。詳情請參閱「速度限制」指南中的「回應」一節。

1	「嘗試拍攝道路」示範	按一下示範模式即可建立測試群組，以及對齊道路端點的做法如何提供流暢的資料。請參閱「對齊道路」指南中的示範。您不需要 API 金鑰。
2	做好準備	請先從設定 Google Cloud 專案開始，並按照後續設定說明操作，並瞭解如何使用 API 金鑰。
3	嘗試對齊道路要求	只要輕輕用道路前往道路範例，並試著根據用途進行調整。
4	取得道路路徑的速限	使用您提供的路徑與道路查詢路徑相同的路徑資料，發出速度限制查詢。請參閱使用路徑的要求範例。
5	瞭解如何處理長路徑	請參考進階概念指南處理長路徑的章節。
6	將道路資料整合至自家應用程式！	請查看道路貼切示範中的詳細程式碼範例，開始在自己的應用程式中建構道路資料功能。

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

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