Roads API は、特定の道路セグメントの掲示されている制限速度を返します。速度制限がある道路セグメントの場合、セグメントのデフォルトの速度制限が返されます。
Roads API から返される制限速度データの精度は保証されません。提供された制限速度データはリアルタイムのものではなく、推定、不正確、不完全、最新ではない場合があります。制限速度のデータを利用できる地域については、対象範囲の詳細をご覧ください。
リクエスト
制限速度のリクエストは HTTPS で送信する必要があります。形式は
https://roads.googleapis.com/v1/speedLimits?parameters&key=YOUR_API_KEY
です。
パラメータの使用方法
必須パラメータ
path
またはplaceId
パラメータ。path
- パスを表す最大 100 個の緯度と経度のペアのリスト。緯度と経度の値はカンマで区切ってください。 緯度と経度のペアはパイプ文字「|」で区切る必要があります。path
パラメータを指定すると、API はまず(snapToRoads
リクエストの場合と同様に)車両が走行する可能性が最も高い道路へのパスをスナップし、該当する道路セグメントの制限速度を決定します。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 キー。アプリケーションは、リクエストごとに API キーを含めて、Roads API にリクエストを送信するたびにそれ自体を識別する必要があります。キーを取得する方法を学習する。
オプション パラメータ
units
- 制限速度を km またはマイル(時速)で返すかどうかを指定します。KPH
またはMPH
に設定できます。デフォルトはKPH
です。
レスポンス
speedLimits
レスポンスには以下の要素が存在する可能性があります。
speedLimits
- 道路メタデータの配列。各要素は次のフィールドで構成されます。placeId
: 場所の一意の ID。Roads API によって返されるすべての場所 ID は、道路セグメントに対応します。speedLimit
- 道路セグメントの制限速度。units
-KPH
またはMPH
を返します。
snappedPoints
- スナップされたポイントの配列。この配列は、リクエストにpath
パラメータが含まれている場合にのみ存在します。各ポイントは、次のフィールドで構成されます。location
-latitude
とlongitude
の値が含まれます。originalIndex
- 元のリクエスト内の対応する値を示す整数。リクエスト内の各値は、レスポンスのスナップされた値にマッピングされます。これらの値は0
からインデックスに登録されるため、originalIndex
が4
のポイントは、path
パラメータに渡される 5 番目の緯度と経度のスナップされた値になります。placeId
: 場所の一意の ID。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 を渡すことができます。snapToRoads
または nearestRoads
リクエストを使用して、道路セグメントの場所 ID を取得することをおすすめします。場所 ID を渡すと、場所 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" } ] }
使用の推奨事項
速度制限サービスへの呼び出し量を最小限に抑えるため、5 ~ 15 分間隔でアセットの場所をサンプリングすることをおすすめします(正確な値はアセットの移動速度によって異なります)。アセットが静止している場合は、1 つの場所のサンプルで十分です(複数の呼び出しを行う必要はありません)。
全体的なレイテンシを最小限に抑えるため、モバイル アセットの場所を受け取るたびに API を呼び出すのではなく、ある程度データが蓄積されたら制限速度サービスを呼び出すことをおすすめします。
制限速度の一部またはすべてが表示されないのはなぜですか?
speedLimits
が見つからない最も一般的な原因は、道路セグメント以外の場所の制限速度をリクエストすることです。
上の例では、バスコ ダ ガマ橋を使って概念を説明します。この橋は、リオテホに架かる E90 道路を支えています。ブリッジ自体の場所 ID は ChIJUzt97ZEwGQ0RM1JzQfqoDtU です。上記のレスポンスの最初の道路セグメントは E90 道路の一部であり、場所 ID は ChIJX12duJAwGQ0Ra0d4Oi4jOGE です。このサンプル リクエストでは、道路の場所 ID を橋の場所 ID に置き換えた場合、ブリッジの場所 ID は個々の道路セグメントを参照しないため、レスポンスの speedLimits
配列には速度制限が 2 つしかありません。また、どの道路 ID も道路セグメントにない場合、レスポンスに速度制限は含まれません。
場所 ID を使用して制限速度をリクエストする場合は、場所 ID がそれぞれ道路セグメントを参照し、さまざまな種類の場所を参照していないことを確認してください。個々の道路セグメントの場所 ID を取得するには、snapToRoads
リクエストまたは nearestRoads
リクエストを使用します。どちらのリクエストも、1 回の呼び出しで複数の場所 ID を返すことができます。