您已全部設定完成!

若要開始開發,請參閱我們的開發人員文件

啟用 Google Maps Roads API

為協助您開始,我們將先引導您使用「Google 開發人員控制台」來執行一些動作:

  1. 建立或選擇專案
  2. 啟用 Google Maps Roads API
  3. 建立適當的金鑰
繼續

速度限制



注意:速度限制服務僅供具有「資產追蹤」授權的 Google Maps APIs Premium Plan

客戶使用。

Google Maps Roads API 能傳回針對特定道路區段公告的速度限制。 針對具有不同速度限制的道路區段,將會傳回該區段預設的速度限制。

我們無法保證由 Google Maps Roads API 傳回之速度限制資料的準確度。 所提供的速度限制資料並非即時的資料,並有可能是經過估計、不準確、不完整和/或過時的資料。 針對不正確的資料,可以透過 [Google 地圖製作工具] 服務回報。

要求

針對速度限制的要求必須使用下列格式,透過 HTTPS 傳送:

https://roads.googleapis.com/v1/speedLimits?parameters&key=YOUR_API_KEY

參數用法

必要參數

  • 可以是一個 path,或一或多個 placeId

    • path:路徑必須被貼齊。 path 參數接受緯度/經度組合的清單。 緯度與經度值應該以逗點分隔。 座標應該以直立線字元 "|" 分隔。 例如: path=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796
    • placeId — 道路區段的地點 ID。 地點 ID 作為對 snapToRoadsnearestRoads 要求的回應而傳回。 您可以針對每個要求傳遞最多 100 個 placeId
  • key — 您應用程式的 API 金鑰。 您的應用程式必須透過將 API 金鑰包括在每個要求中,以在每次將要求傳送至 Google Maps Roads API 時識別自己。 瞭解如何取得金鑰

選擇性參數

  • units:傳回的速度限制要每小時幾公里還是每小時幾英里顯示。 這可以設定為 KPHMPH。 預設為 KPH

您可以使用單一的 path ,或是一連串的 placeId 來要求速度限制資料;然而,針對要求中每個唯一的 placeId,您將只會收到一個回應。

如果在較短的距離之間有數個點,則可能會出現重複的 placeId

回應

下列元素可能會出現在 speedLimits 回應中:

  • speedLimits:道路中繼資料的陣列。 每個元素都是由下列欄位所組成:

    • placeId:地點的唯一識別碼。 由 Google Maps Roads API 傳回的所有 placeId 都會與道路區段對應。

    • speedLimit:該道路區段的速度限制。

    • units:傳回 KPHMPH
    • snappedPoints:已貼齊點的陣列。 此陣列只會在要求包含 path 參數的情況下出現。 每個點都是由下列欄位所組成:

    • location — 包含 latitudelongitude 值。

    • originalIndex:指出原始要求中對應值的整數。 要求中的每個值都應該對應到回應中的一個貼齊值。 這些值都是從 0 編製索引,因此 originalIndex4 的點將會是第五個傳遞至 path 參數之緯度/經度的貼齊值。

    • placeId:地點的唯一識別碼。 由 Google Maps Roads API 傳回的所有 placeId 都會與道路區段對應。 您可以在速度限制要求中傳遞 placeId,以判斷該道路區段的沿途速度限制。

範例要求

下列要求將會判斷位於澳洲坎培拉的一條短程道路上的速度限制。

要求

https://roads.googleapis.com/v1/speedLimits?placeId=ChIJ1Wi6I2pNFmsRQL9GbW7qABM
        &placeId=ChIJ58xCoGlNFmsRUEZUbW7qABM
        &placeId=ChIJ9RhaiGlNFmsR0IxAbW7qABM
        &placeId=ChIJabjuhGlNFmsREIxAbW7qABM
        &placeId=ChIJcSAlFWpNFmsRMHlUbW7qABM
        &placeId=ChIJI2FUTGhNFmsRcHpAbW7qABM
        &placeId=ChIJiy6YT2hNFmsRkHZAbW7qABM
        &placeId=ChIJoR7CemhNFmsRQB9QbW7qABM
        &placeId=ChIJP2m_FWpNFmsRIHlUbW7qABM
        &placeId=ChIJtV7La2pNFmsRAGpHbW7qABM
        &placeId=ChIJW5JAZmpNFmsRegG0-Jc80sM
        &placeId=ChIJW9R7smlNFmsRMH1AbW7qABM
        &placeId=ChIJy8c0r2lNFmsRQEZUbW7qABM
        &key=YOUR_API_KEY

回應

{
  "speedLimits": [
    {
      "placeId": "ChIJ1Wi6I2pNFmsRQL9GbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJ58xCoGlNFmsRUEZUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJ9RhaiGlNFmsR0IxAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJabjuhGlNFmsREIxAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJcSAlFWpNFmsRMHlUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJI2FUTGhNFmsRcHpAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJiy6YT2hNFmsRkHZAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJoR7CemhNFmsRQB9QbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJP2m_FWpNFmsRIHlUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJtV7La2pNFmsRAGpHbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJW5JAZmpNFmsRegG0-Jc80sM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJW9R7smlNFmsRMH1AbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJy8c0r2lNFmsRQEZUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    }
  ]
}

傳送您對下列選項的寶貴意見...

這個網頁
Google Maps Roads API
Google Maps Roads API
需要協助嗎?請前往我們的支援網頁