ガイドAPIリファレンスChangelogs
ガイド
  1. HERE Routing API V8 - 開発者ガイド
  2. 電気自動車

経由地での補機消費

電気自動車は、空調や照明などの補機システムを動作させるためにもエネルギーを消費します。サポートされているどちらのエネルギー消費モデルでも、非パススルー経由地におけるこの補機消費を考慮できます。

📘

注

補機消費はtransportMode=pedestrian、transportMode=bicycle、およびtransportMode=networkRestrictedTruckではサポートされていません。

次の表に、各消費モデルのリクエストパラメーターを示します。

消費モデル可変補機負荷固定補機負荷
物理的ev[auxiliaryPowerCurve]ev[auxiliaryPowerConsumption]
経験的ev[auxiliaryPowerCurve]ev[auxiliaryConsumption]

途中経由地での補機消費

補機消費量の計算は消費モデルや使用されるリクエストパラメーターによって異なります。

電力曲線

どちらの消費モデルでも、ev[auxiliaryPowerCurve]パラメーターを使用して可変補機負荷を指定できます。APIは、停止中に消費される補機エネルギーの合計を次の式で計算します。

説明：

パラメーター説明
電力曲線に基づく、時刻tにおける補機電力。
セグメントの開始時間 (経過時間)。
セグメントの継続時間：走行中はsegment_travel_time、経由地での停車中はstop_duration。
セグメント中に消費される補機エネルギーの合計。

APIは総消費量に を加算します。

tが電力曲線の最後の点を超えた場合、APIは最終点における曲線の値をそれ以降の一定値として使用します。

ev[auxiliaryPowerCurve]を使用する場合は、次の制約が適用されます。

  • ev[auxiliaryPowerCurve]とev[auxiliaryConsumption]を組み合わせることはできません。
  • ev[auxiliaryPowerCurve]をdepartureTime=anyと組み合わせて使用することはできません。

物理的モデル

consumptionModel=physicalを使用する場合は、ev[auxiliaryPowerConsumption]を使用して一定の補機消費を指定できます。APIは総消費量を次のように計算します。

Total_consumption += ev[auxiliaryPowerConsumption] * stop_duration

APIが必要な単位変換を行います。

経験的モデル

経験的モデルでは、APIは総消費量を次のように計算します。

Total_consumption += ev[auxiliaryConsumption] * stop_duration

APIが必要な単位変換を行います。

例：経由地で停車時間と補機消費

この例では、経由地での停車時間の変化が総エネルギー消費量にどのような影響を与えるかを示します。

リクエスト：

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=52.424409,13.626717&'\
'destination=52.422221,13.637723&'\
'via=52.423201,13.632836!stopduration=3600&'\
'return=travelSummary,summary&'\
'transportMode=car&'\
'departureTime=any&'\
'ev[freeFlowSpeedTable]=0,0.1706,11,0.1135,31,0.0798,51,0.0687,71,0.0771,91,0.0920,101,0.1146,131,0.1409&'\
'ev[auxiliaryConsumption]=1.0&'\
'ev[ascent]=3.0&'\
'ev[descent]=1.0&'\
'traffic[mode]=disabled&'\
'apiKey=YOUR_API_KEY'

レスポンス：

{
  "summary": {
    "duration": 3626,
    "length": 440,
    "consumption": 3.6607,
    "baseDuration": 3626
  },
  "travelSummary": {
    "duration": 26,
    "length": 440,
    "consumption": 3.6607,
    "baseDuration": 26
  }
}

途中経由地での追加エネルギー補機消費

補機システムによるエネルギー消費に加え、テールリフトを使用した商品の積み下ろしなど、経由地で行われる特定の作業によっても追加のエネルギーが消費されます。これを総エネルギー消費量の計算に含めるには、中間経由地の定義にauxiliaryEnergyConsumptionを追加します。

via=49.320006,16.088119!auxiliaryEnergyConsumption=12.0&

次の制限が適用されます。

  • auxiliaryEnergyConsumptionはパススルー経由地 (passThrough=true) には使用できません。
  • auxiliaryEnergyConsumptionはユーザーが追加した充電ステーションでは使用できません。
リクエストパラメーターモデルパラメーター必須説明
auxiliaryEnergyConsumptionいいえ商品の積み下ろし用のテールリフトなど、停車中にバッテリー駆動機器で消費されるエネルギーです。値はkWhで指定します。

例

次の例では、経由地で12kWhの追加エネルギー消費が設定されています。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=49.453107,15.604775&'\
'destination=49.038283,16.680621&'\
'via=49.320006,16.088119!auxiliaryEnergyConsumption=12.0&'\
'return=summary,travelSummary&'\
'transportMode=car&'\
'departureTime=any&'\
'ev[freeFlowSpeedTable]=0,0.1706,11,0.1135,31,0.0798,51,0.0687,71,0.0771,91,0.0920,101,0.1146,131,0.1409&'\
'ev[ascent]=3.0&'\
'ev[descent]=1.0&'\
'ev[initialCharge]=12&'\
'ev[maxCharge]=30.0&'\
'ev[chargingCurve]=0,800,200,800,30000,200&'\
'ev[maxChargeAfterChargingStation]=24.0&'\
'ev[makeReachable]=true&'\
'ev[connectorTypes]=iec62196Type1Combo,iec62196Type2Combo,Chademo,Tesla&'\
'traffic[mode]=disabled&'\
'apiKey=YOUR_API_KEY'

充電地点での補機消費

充電地点での補機消費は次の2つの形で計算に影響を与えます

  1. 充電をセットアップしている間 (ev[chargingSetupDuration]で制御される期間)、補機消費量によってステーション到着時よりも充電量が減少します。
  2. 充電中は、APIは適用される充電電力から補機消費電力を差し引くため、充電時間に影響が及びます。

例：一定の補機消費と電力曲線

次の例では、一定の補機消費を使用した場合と補機電力曲線を使用した場合で、総充電時間がどのように変化するかを比較します。

  • リクエスト1では、一定の補機消費値12,000 W (ev[auxiliaryPowerConsumption]=12000) 使用します。
  • リクエスト2では、補助電力曲線 (ev[auxiliaryPowerCurve]) 使用します。車両が充電ステーションに到着するまでは、この曲線はリクエスト1の一定値と一致するため、到着時の充電量は同じままです。到着後は曲線の値は減少します。

リクエスト2では、充電ステーションでの補機消費が少ないため、充電時間が短くなります (2,594秒対2,962秒)。

リクエスト：

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=52.515634,13.456419&'\
'destination=52.336899,14.130527&'\
'via=52.48334,13.46025!charging=(power=800;current=800;voltage=500;supplyType=DC;minDuration=4000;maxDuration=4000)&'\
'return=polyline,summary,actions,instructions&'\
'transportMode=car&'\
'vehicle[currentWeight]=2100&'\
'departureTime=2026-04-22T18:49:33&'\
'vehicle[frontalArea]=3.1&'\
'vehicle[rollingResistanceCoefficient]=0.02&'\
'vehicle[airDragCoefficient]=0.28&'\
'ev[initialCharge]=18&'\
'ev[maxCharge]=80&'\
'ev[chargingCurve]=0,96,8,193,16,200,32,190,48,96,64,48,80,5&'\
'ev[maxChargingVoltage]=400&'\
'ev[maxChargeAfterChargingStation]=72&'\
'ev[minChargeAtChargingStation]=8&'\
'ev[minChargeAtDestination]=8&'\
'ev[chargingSetupDuration]=300&'\
'ev[makeReachable]=true&'\
'ev[connectorTypes]=iec62196Type1Combo,iec62196Type2Combo,Chademo,gbtDc,saeJ3400&'\
'consumptionModel=physical&'\
'ev[auxiliaryPowerConsumption]=12000&'\
'ev[recuperationEfficiency]=0.7&'\
'ev[driveEfficiency]=0.9&'\
'apiKey=YOUR_API_KEY'

レスポンス (充電時間：2,962秒)：

{
  "postActions": [
    {
      "action": "chargingSetup",
      "duration": 300
    },
    {
      "action": "charging",
      "duration": 2962,
      "consumablePower": 320,
      "arrivalCharge": 14.6885,
      "targetCharge": 80
    },
    {
      "action": "wait",
      "duration": 738
    }
  ]
}

関連コンテンツ

25 日前の更新

このページは役に立ちましたか？