最も近い道路

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 がありません。これらの値は 0 からインデックスが付けられるため、originalIndex が 4 のポイントは、パス パラメータに渡された 5 番目の緯度/経度のスナップ値になります。Nearest Roads ポイントには、異なる位置情報または placeId を持つ単一の座標の複数のポイントが含まれることがあります。

LatitudeLongitudeLiteral

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

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

緯度（10 進数）
required 数値

経度（10 進数）