您已全部設定完成!

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

啟用 Google Maps Roads API

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

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

最近道路



Google Maps Roads API 最多接受 100 個獨立座標,並傳回每個點最接近的道路區段。 所傳遞的點不必是連續路徑的一部分。

如果您處理的是循序 GPS 點,請使用 Snap to Roads

要求

針對「最近道路」的要求必須使用下列格式,透過 HTTPS 傳送:

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

參數用法

必要參數

  • points — 緯度/經度組合的清單。 緯度與經度值應該以逗號分隔。 座標應該以縱線字元 "|" 分隔。 例如:points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796
  • key — 您應用程式的 API 金鑰。 您的應用程式必須透過將 API 金鑰包括在每個要求中,以在每次將要求傳送至 Google Maps Roads API 時識別自己。

瞭解如何取得金鑰

回應

對於每個有效的要求,Google Maps Roads API 將會以要求 URL 內指定的格式傳回回應。 下列元素可能會出現在 Snap to Roads 回應中。

  • snappedPoints:已貼齊點的陣列。 每個點都是由下列欄位所組成:

    • location — 包含 latitudelongitude 值。
    • originalIndex:指出原始要求中對應值的整數。 要求中的每個點最多對應到回應中兩個區段:

      • 如果沒有鄰近道路,則不會傳回任何區段。
      • 如果最近道路是單行道,則傳回一個區段。
      • 如果最近道路是雙向道,則傳回兩個區段。
        • placeId:地點的唯一識別碼。 由 Google Maps Roads API 傳回的所有地點 ID 都會與道路區段對應。

    [地點 ID] 可與其他 Google API 搭配使用,包括 Google Places APIGoogle Maps JavaScript API

例如,如果您需要為 Google Maps Roads API 傳回的貼齊點取得道路名稱,您可以將 placeId 傳遞至 Google Places APIGoogle Maps Geocoding API

Google Maps Roads API 中,您可以在速度限制要求中傳遞 placeId,以判斷該道路區段的沿途速度限制。

範例要求

下列要求會根據指定的座標清單,傳回一組道路區段。

要求

https://roads.googleapis.com/v1/nearestRoads?points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796&key=YOUR_API_KEY

回應

{
  "snappedPoints": [
    {
      "location": {
        "latitude": 60.170877918672588,
        "longitude": 24.942699821922421
      },
      "originalIndex": 0,
      "placeId": "ChIJNX9BrM0LkkYRIM-cQg265e8"
    },
    {
      "location": {
        "latitude": 60.170876898776406,
        "longitude": 24.942699912064771
      },
      "originalIndex": 1,
      "placeId": "ChIJNX9BrM0LkkYRIM-cQg265e8"
    },
    {
      "location": {
        "latitude": 60.170874902634374,
        "longitude": 24.942700088491474
      },
      "originalIndex": 2,
      "placeId": "ChIJNX9BrM0LkkYRIM-cQg265e8"
    }
  ]
}

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

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