このページは Cloud Translation API によって翻訳されました。

制限速度

Roads API は、特定の道路区間に投稿された制限速度を返します。制限速度が変動する道路セグメントの場合は、デフォルトの制限速度が返されます。

Roads API から返される制限速度データの精度は保証されません。提供される制限速度データはリアルタイムのものではなく、推定値、不正確、不完全、または古い可能性があります。速度制限データを利用できるリージョンについては、カバレッジの詳細をご覧ください。

リクエスト

制限速度のリクエストは HTTPS 経由で送信する必要があります。リクエストの形式は次のとおりです。

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

パラメータの使用方法

必須パラメータ

path パラメータまたは placeId パラメータのいずれか。
- path - パスを表す最大 100 個の緯度と経度のペアのリスト。緯度と経度の値はカンマで区切る必要があります。緯度と経度のペアはパイプ文字「|」で区切る必要があります。path パラメータを指定すると、snapToRoads リクエストと同様に、API はまず車両が走行する可能性が高い道路への経路をスナップしてから、該当する道路区分の制限速度を決定します。API にパスをスナップしたくない場合は、下記のように placeId パラメータを渡す必要があります。次の例は、3 つの緯度と経度のペアを持つ path パラメータを示しています（path=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796）。
- placeId - 1 つ以上の道路区分を表すプレイス ID。各プレイス ID が、異なる種類の場所ではなく、道路区間を参照していることを確認します。リクエストごとに最大 100 個のプレイス ID を渡すことができます。API は、指定されたプレイス ID で道路スナップは実行しません。レスポンスには、リクエスト内のプレイス ID ごとの速度制限が含まれます。snapToRoads リクエストまたは nearestRoads リクエストを送信して関連するプレイス ID を見つけ、それらを speedLimits リクエストへの入力として指定できます。次の例は、2 つのプレイス ID を持つ placeId パラメータを示しています（placeId=ChIJX12duJAwGQ0Ra0d4Oi4jOGE&placeId=ChIJLQcticc0GQ0RoiNZJVa5GxU）。
key - アプリケーションの API キー。アプリケーションは、Roads API にリクエストを送信するたびに API キーをリクエストし、自身を識別する必要があります。キーの取得方法を学習する。

オプションパラメータ

units - 制限速度を返すかどうか（キロメートルまたはマイル/時）。KPH または MPH に設定できます。デフォルトは KPH です。

レスポンス

speedLimits レスポンスには、次の要素が含まれる場合があります。

speedLimits - 道路のメタデータの配列。各要素は次のフィールドから構成されます。
- placeId - 場所の一意の識別子。Roads API から返されるプレイス ID はすべて、道路区分に対応します。
- speedLimit - その道路区間の制限速度。
- units - KPH または MPH を返します。
snappedPoints - スナップされたポイントの配列。この配列は、リクエストに path パラメータが含まれていた場合にのみ存在します。各ポイントは次のフィールドから構成されます。
- location - latitude と longitude の値が含まれます。
- originalIndex - 元のリクエスト内の対応する値を示す整数。リクエスト内の各値は、レスポンス内のスナップ値にマッピングされる必要があります。これらの値は 0 からインデックス化されるため、originalIndex が 4 のポイントは、path パラメータに渡される 5 番目の緯度と経度のスナップ値になります。
- placeId - 場所の一意の識別子。Roads API から返されるプレイス ID はすべて、道路区分に対応しています。placeId を速度制限リクエストに渡し、その道路区間の速度制限を求めることができます。
warning_message - ユーザーに表示される警告を含む文字列。

パスを使用したリクエストの例

このリクエストは、ポルトガルのリスボンにあるヴァスコダガマ橋を横断する経路において、指定した緯度と経度のペアに最も近い道路区分ごとに制限速度を取得します。

リクエスト

https://roads.googleapis.com/v1/speedLimits?path=38.75807927603043,-9.03741754643809|38.6896537,-9.1770515|41.1399289,-8.6094075&key=YOUR_API_KEY

対応

{
  speedLimits:
  [
    {
      placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE",
      speedLimit: 105,
      units: "KPH"
    },
    {
      placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU",
      speedLimit: 70,
      units: "KPH"
    },
    {
      placeId: "ChIJJ4vQRudkJA0RpednU70A-5M",
      speedLimit: 55,
      units: "KPH"
    }
  ],
  snappedPoints:
  [
    {
      location:
      {
        latitude: 38.75807927603043,
        longitude: -9.037417546438084
      },
      originalIndex: 0,
      placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE"
    },
    {
      location:
      {
        latitude: 38.689653701836896,
        longitude: -9.177051486847693
      },
      originalIndex: 1,
      placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU"
    },
    {
      location:
      {
        latitude: 41.13993011767777,
        longitude: -8.609400794783655
      },
      originalIndex: 2,
      placeId: "ChIJJ4vQRudkJA0RpednU70A-5M"
    }
  ],
  warningMessage: "Input path is too sparse. You should provide a path where consecutive points are closer to each other. Refer to the 'path' parameter in Google Roads API documentation."
}

上記のレスポンスで、ポイントのスパース性に関する警告メッセージに注目してください。任意の地点の最寄りの道路区間の制限速度をリクエストする場合は、代わりに nearestRoads エンドポイントから取得したプレイス ID で speedLimits を呼び出す必要があります。

プレイス ID を使用したリクエストの例

緯度と経度のペアを使用する代わりに、道路区間のプレイス ID を渡すことができます。道路区間のプレイス ID は、snapToRoads リクエストまたは nearestRoads リクエストを使って取得することをおすすめします。プレイス ID を渡すと、API は各プレイス ID で表される道路区分の速度制限を返します。この API では、指定されたプレイス ID に道路スナップは適用されません。

次の例では、ポルトガルのリスボンのヴァスコダガマ橋を渡る道路区間の一部に対して制限速度をリクエストします。

リクエスト

https://roads.googleapis.com/v1/speedLimits?placeId=ChIJX12duJAwGQ0Ra0d4Oi4jOGE&placeId=ChIJLQcticc0GQ0RoiNZJVa5GxU&placeId=ChIJJ4vQRudkJA0RpednU70A-5M&key=YOUR_API_KEY

対応

{
  "speedLimits": [
    {
      placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE",
      speedLimit: 105,
      units: "KPH"
    },
    {
      placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU",
      speedLimit: 70,
      units: "KPH"
    },
    {
      placeId: "ChIJJ4vQRudkJA0RpednU70A-5M",
      speedLimit: 55,
      units: "KPH"
    }
  ]
}

使用に関する推奨事項

Speed Limit サービスの呼び出しを最小限に抑えるため、アセットの場所を 5 ～ 15 分間隔でサンプリングすることをおすすめします（正確な値はアセットの移動速度によって異なります）。アセットが静止している場合、位置情報のサンプルは 1 つで十分です（複数回呼び出す必要はありません）。

全体的なレイテンシを最小限に抑えるため、モバイルアセットの場所を受け取るたびに API を呼び出すのではなく、ある程度データが蓄積されたら制限速度サービスを呼び出すことをおすすめします。

一部またはすべての制限速度が設定されていないのはなぜですか？

speedLimits が表示されない最も一般的な原因は、道路区間ではない場所の制限速度がリクエストされていることです。

この例では、ヴァスコダガマ橋を使用して概念を説明しており、この橋はテホ川に架かる道路 E90 を支えています。ブリッジ自体のプレイス ID は ChIJUzt97ZEwGQ0RM1JzQfqoDtU です。上記のレスポンスの最初の道路セグメントは E90 道路の一部で、プレイス ID は「ChIJX12duJAwGQ0Ra0d4Oi4jOGE」です。このリクエストの例では、道路のプレイス ID を橋のプレイス ID に置き換えた場合、橋のプレイス ID が個々の道路区分を参照していないため、レスポンスの speedLimits 配列には制限速度が 2 つのみになります。また、道路区間のプレイス ID がない場合、レスポンスに速度制限は含まれません。

プレイス ID を使用して制限速度をリクエストする場合は、各プレイス ID が、異なる種類の場所ではなく、道路区間を参照していることを確認してください。個々の道路区間のプレイス ID は、snapToRoads リクエストまたは nearestRoads リクエストを使って取得するのが最適です。どちらのリクエストも、1 回の呼び出しで複数のプレイス ID を返すことができます。