スピードキャップの使用方法
vehicle[speedCap]パラメーターを使用すると、ルートを計算する車両の最大速度を設定できます。
適用される制限速度は、設定された速度上限値よりも常に優先されます。
このパラメーターの影響は、リクエストで使用されるtransportModeよって異なります。次の表を参照してください。
| 移動モード | vehicle[speedCap]の影響 |
|---|---|
scooter | ルートの形状、到達予測時刻、消費 |
car、truck | 到達予測時刻、消費 |
| その他 | サポート対象外 |
自動車やトラックのルート計算リクエストでは、速度上限を設定することで燃料やエネルギーの消費を抑えることができます。 これは、電気自動車が充電のために追加の停車を行わずに目的地に到達できるようにしたり、トラックが指定された時間枠内に物流拠点に到達して貨物の荷下ろしのリソースを確保したりできるようにするための効果的な方法です。
次の例では、速度上限を13.89 m/秒 (50 km/時) に設定した車両のルートを計算しています。
curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=52.514774,13.389289&'\
'destination=52.447211,13.3535751&'\
'return=polyline,summary&'\
'spans=dynamicSpeedInfo&'\
'transportMode=car&'\
'vehicle[speedCap]=13.89&'\
'apiKey=YOUR_API_KEY'機能クラスごとの速度上限
vehicle[speedCapPerFc]パラメーターを使用すると、道路機能クラスごとに専用の速度上限を設定できます。
注
このパラメーターは、
carおよびtruckの移動モードでのみでサポートされています。
vehicle[speedCapPerFc]パラメーターとvehicle[speedCap]パラメーターは、1つのリクエストで同時に使用できます。
その場合、APIは指定された道路に適用される最も低い速度上限値を使用します。
たとえば、リクエストでvehicle[speedCap]=13.89とvehicle[speedCapPerFc]=20を設定した場合、APIは機能クラス1 (FC1) のすべての道路と、計算されたルートに含まれるその他のすべての道路に対して、13.98 m/秒の速度上限を使用します。
vehicle[speedCapPerFc]パラメーターには、目的の速度上限値を、m/秒で表記されたカンマ区切りの速度のリストとして指定します。値の指定順序は、道路機能クラスの順序に対応します。次の例を参照してください。
vehicle[speedCapPerFc]=20- FC1道路に20 m/秒の速度上限を適用します。vehicle[speedCapPerFc]=20,,15- FC1道路に20 m/秒、FC3道路に15 m/秒の速度上限を適用します。vehicle[speedCapPerFc]=,,,,10- FC5道路に10 m/秒の速度上限を適用します。vehicle[speedCapPerFc]=20,18- FC1道路に20 m/秒、FC2道路に18 m/秒の速度上限を適用します。
次の例では、FC1に20 m/秒 (72 km/時)、FC3に15 m/秒 (54 km/時) の速度上限を設定したトラックのルートを計算しています。
vehicle[speedCap]パラメーターも使用されています。
その値は、FC1およびFC3道路に設定された値よりも大きい、FC1およびFC3に属さない道路に対して使用されます。
curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=52.495650,13.276807&'\
'destination=52.506097,13.461151&'\
'return=summary&'\
'spans=dynamicSpeedInfo&'\
'transportMode=truck&'\
'vehicle[speedCap]=25&'\
'vehicle[speedCapPerFc]=20,,15&'\
'apiKey=YOUR_API_KEY'燃料/energy消費への影響
速度上限を設定することは、燃料やエネルギーの消費を抑える効果的な方法です。電気自動車のルート計算リクエストの例を考えてみましょう。 速度上限を設定しないリクエストでは、エネルギー消費量は43 kWhになります。 一方、速度上限を25 m/秒(90 km/時) に設定したリクエストでは、エネルギー消費量が36 kWhに抑えられています。
速度上限が設定されていません
リクエスト
curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=52.66181,13.38251&'\
'destination=51.772324,12.402652&'\
'return=summary&'\
'transportMode=car&'\
'departureTime=any&'\
'ev[freeFlowSpeedTable]=10,0.130,20,0.132,30,0.136,40,0.142,50,0.151,60,0.161,70,0.176,80,0.194,90,0.214,100,0.237,110,0.264,120,0.290,130,0.321,140,0.354,150,0.389,160,0.426,170,0.466,180,0.509,190,0.554,200,0.601&'\
'ev[trafficSpeedTable]=0,0.349,27,0.319,45,0.329,60,0.266,75,0.287,90,0.318,100,0.33,110,0.335,120,0.35,130,0.36,250,0.36&'\
'ev[ascent]=9&'\
'ev[descent]=4.3&'\
'apiKey=YOUR_API_KEY'レスポンス
レスポンス例は途中で省略されています。
{
"routes" : [
{
"id" : "dc225dd3-78d8-49ad-ad82-6350dc6848cd",
"sections" : [
{
...,
"summary": {
"duration": 5582,
"length": 165625,
"consumption": 47.824,
"baseDuration": 5582
}
}
]
}
]
}速度上限が設定されています
リクエスト
curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=52.66181,13.38251&'\
'destination=51.772324,12.402652&'\
'return=summary&'\
'transportMode=car&'\
'vehicle[speedCap]=25&'\
'departureTime=any&'\
'ev[freeFlowSpeedTable]=10,0.130,20,0.132,30,0.136,40,0.142,50,0.151,60,0.161,70,0.176,80,0.194,90,0.214,100,0.237,110,0.264,120,0.290,130,0.321,140,0.354,150,0.389,160,0.426,170,0.466,180,0.509,190,0.554,200,0.601&'\
'ev[trafficSpeedTable]=0,0.349,27,0.319,45,0.329,60,0.266,75,0.287,90,0.318,100,0.33,110,0.335,120,0.35,130,0.36,250,0.36&'\
'ev[ascent]=9&'\
'ev[descent]=4.3&'\
'apiKey=YOUR_API_KEY'レスポンス
レスポンス例は途中で省略されています。
{
"routes" : [
{
"id" : "58f003f1-a472-4f5e-a818-f6ef3b82c8fa",
"sections" : [
{
...,
"summary": {
"duration": 6946,
"length": 165625,
"consumption": 37.0997,
"baseDuration": 6946
}
}
]
}
]
}関連コンテンツ
25 日前の更新