最も近い道路

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

連続した GPS ポイントを扱う場合は、Snap to Roads を使用します。

リクエスト

Nearest 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。

例

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

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 や location が異なる複数のスナップされたポイントが含まれる場合があります。

詳細については、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 進法）