最も近い道路

Roads API は最大 100 個の独立した 座標を受け取り、各ポイントに最も近い道路セグメントを返します。渡されるポイントは、連続したパスの一部である必要はありません。

連続した GPS ポイントを使用している場合は、道路にスナップを使用します。

リクエスト

最寄りの道路へのリクエストは 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.

例

次のリクエストは、指定された座標リストに基づいて道路セグメントのセットを返します。

URL

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 はリクエスト URL 内に示された形式で レスポンスを返します。

{
  "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 文字列

場所の固有識別子。Roads API によって返されるすべてのプレイス ID は、道路セグメントに対応しています。

省略可 数値

元のリクエストの対応する値を示す整数。リクエスト内の各値は、レスポンス内のスナップされた値にマッピングされます。 ただし、interpolate=true を設定している場合や、 最寄りの道路を使用している場合は、レスポンスに リクエストよりも多くの座標が含まれる可能性があります。補間された値には `originalIndex` がありませんoriginalIndex。これらの値は 0 から始まるインデックスが付けられるため、originalIndex が 4 のポイントは、パスパラメータに渡された 5 番目の 緯度と経度のスナップされた値になります。最寄りの道路のポイントには、場所またはプレイス ID が異なる単一の座標に対して複数のポイントが含まれる場合があります。

LatitudeLongitudeLiteral

緯度と経度を 10 進数で表した特定の場所を表すオブジェクト。

フィールド 必須 タイプ 説明
required 数値

緯度（10 進数）
required 数値

経度（10 進数）