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 キー。アプリケーションは、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 を渡すと、各プレイス 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 を返すことができます。