最近的道路

Roads API 最多可使用 100 個獨立座標，並傳回每個點的最近路段。傳遞的點不必是連續路徑的一部分。

如果使用連續 GPS 點，請使用「貼齊道路」。

要求

傳送給 Nearest Roads 的要求必須使用 HTTPS，且格式如下：

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

必要參數

  • 積分

    要對齊的點。「點」參數接受經緯度組合清單。請以半形逗號分隔經緯度值。以直立線「|」分隔座標。例如： points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796。

範例

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

網址

https://roads.googleapis.com/v1/nearestRoads
  ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
  &key=YOUR_API_KEY

curl

curl -L -X GET '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 會以要求網址中指定的格式傳回回應。

{
  "snappedPoints":
    [
      {
        "location":
          { "latitude": 60.170878428876755, "longitude": 24.94269540970182 },
        "originalIndex": 0,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
      {
        "location":
          { "latitude": 60.17087741412199, "longitude": 24.942695474405202 },
        "originalIndex": 1,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
      {
        "location":
          { "latitude": 60.170875416131736, "longitude": 24.942695601802203 },
        "originalIndex": 2,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
    ],
}

回應會使用下列結構定義。

NearestRoadsResponse

欄位 必填 類型 說明
選用 Array<SnappedPoint>

已對齊的點陣列。有時會包含多個相同點的對應點，但 placeId 或位置不同。

詳情請參閱 SnappedPoint。

SnappedPoint

欄位 必填 類型 說明
required LatitudeLongitudeLiteral 詳情請參閱 LatitudeLongitudeLiteral。
required 字串

地點的專屬 ID。Roads API 傳回的所有地點 ID 都對應至路段。
選用 數字

整數，表示原始要求中的對應值。要求中的每個值都應對應至回應中的對齊值。不過，如果您已將 interpolate 設為 true，或是使用最鄰近的道路，回應可能包含比要求更多的座標。內插值不會有 originalIndex。這些值的索引從 0 開始，因此 originalIndex 為 4 的點，會是傳遞至路徑參數的第 5 個經緯度值。「最近的道路」點可能包含單一座標的多個點，但位置或 placeId 不同。

LatitudeLongitudeLiteral

這個物件會以十進制度數描述特定位置的經緯度。

欄位 必填 類型 說明
required 數字

以十進制度數表示的緯度
required 數字

以十進制度數表示的經度