ガイドAPIリファレンス
ガイド

到着時の最小充電量を指定してルートを計算する

目的地での予備充電の追加が必要な場合があります。次のような理由が考えられます。

  • 消費モデルではエネルギー消費が正確にデータ処理されず、ユーザーは目的地に確実に到着できることを望んでいる。
  • 目的地での充電ができない。次の旅程に予備充電が必要である。

充電予備量を考慮したルートの計算に使用できる3つのオプションパラメーターは次のとおりです。

  • ev[minChargeAtDestination]は目的地の経由地にのみ使用されます。デフォルト値は0です。
  • ev[minChargeAtFirstChargingStation]は最初の充電スタンド経由地に使用されます。デフォルト値は0です。
  • ev[minChargeAtChargingStation]は、ev[minChargeAtFirstChargingStation]が指定されている場合に、最初の経由地を除くすべての充電スタンド経由地に使用されます。デフォルト値は0です。

充電による停車地でも目的地でもない経由地は、予備充電のあるユースケースがないため、対応するパラメーターをサポートしていません。

次の例では、充電スタンドの最小充電量として最大充電量の10% (8kWh) を指定するユースケースを示します。 さらに、目的地で必要な最小充電量として 50kWh を指定します。 このため、目的地の近くに追加の充電スタンドがあります。レスポンスには 3 つのセクションがあります。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'departureTime=any&'\
'origin=52.533959,13.404780&'\
'ev[connectorTypes]=iec62196Type2Combo&'\
'transportMode=car&'\
'destination=51.741505,14.352413&'\
'return=summary&'\
'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[auxiliaryConsumption]=1.8&'\
'ev[ascent]=9&'\
'ev[descent]=4.3&'\
'ev[makeReachable]=true&'\
'ev[initialCharge]=48&'\
'ev[maxCharge]=80&'\
'ev[chargingCurve]=0,96,8,193,16,200,32,190,48,96,64,48,80,5&'\
'ev[maxChargeAfterChargingStation]=72&'\
'ev[minChargeAtChargingStation]=8&'\
'ev[minChargeAtDestination]=50&'\
'apiKey=YOUR_API_KEY'
{
  "routes": [
    {
      "id": "b30cf55f-fee2-4669-afa6-1c9dbaff5ec4",
      "sections": [
        {
          "id": "87f5d58d-b57e-4441-a56a-581c1f7c4f09",
          "type": "vehicle",
          "postActions": [
            {
              "action": "charging",
              "duration": 1521,
              "consumablePower": 300,
              "arrivalCharge": 18.6044,
              "targetCharge": 66.9999
            }
          ],
          "departure": {
            "place": {
              "type": "place",
              "location": {
                "lat": 52.5338755,
                "lng": 13.4050137,
                "elv": 92
              },
              "originalLocation": {
                "lat": 52.5339589,
                "lng": 13.4047799
              }
            },
            "charge": 48
          },
          "arrival": {
            "place": {
              "type": "chargingStation",
              "location": {
                "lat": 51.8887524,
                "lng": 13.8374168,
                "elv": 105
              },
              "displayLocation": {
                "lat": 51.888672,
                "lng": 13.8373939
              },
              "id": "evcp0-ODE3ODJjZmUtMmFlNy0xMWVmLWJhMTUtNDIwMTBhYTQwMDQz",
              "name": "EV Charging Station",
              "attributes": {
                "power": 300,
                "current": 375,
                "voltage": 800,
                "supplyType": "dc",
                "connectorType": "iec62196Type2Combo"
              }
            },
            "charge": 18.6044
          },
          "summary": {
            "duration": 5234,
            "length": 85293,
            "consumption": -18.9999,
            "baseDuration": 5234
          },
          "transport": {
            "mode": "car"
          },
          "consumptionType": "electric"
        },
        {
          "id": "2e6898fe-2e8e-4d6a-9a6b-cbc920d3bf87",
          "type": "vehicle",
          "departure": {
            "place": {
              "type": "chargingStation",
              "location": {
                "lat": 51.8887524,
                "lng": 13.8374168,
                "elv": 105
              },
              "displayLocation": {
                "lat": 51.888672,
                "lng": 13.8373939
              },
              "id": "evcp0-ODE3ODJjZmUtMmFlNy0xMWVmLWJhMTUtNDIwMTBhYTQwMDQz",
              "name": "EV Charging Station",
              "attributes": {
                "power": 300,
                "current": 375,
                "voltage": 800,
                "supplyType": "dc",
                "connectorType": "iec62196Type2Combo"
              }
            },
            "charge": 66.9999
          },
          "arrival": {
            "place": {
              "type": "place",
              "location": {
                "lat": 51.7412356,
                "lng": 14.3525337,
                "elv": 115
              },
              "originalLocation": {
                "lat": 51.741505,
                "lng": 14.3524129
              }
            },
            "charge": 50.0564
          },
          "summary": {
            "duration": 1823,
            "length": 47497,
            "consumption": 16.9435,
            "baseDuration": 1823
          },
          "transport": {
            "mode": "car"
          },
          "consumptionType": "electric"
        }
      ]
    }
  ]
}

初期充電量が少なすぎる場合、ev[minChargeAtChargingStation] の制限により充電スタンドに到達できない可能性があります。 1 つの選択肢はこの数値を減らすことですが、すべての充電スタンドへの到達が低充電となるため、望ましくない影響が 1 つあります。 代わりに、ev[minChargeAtFirstChargingStation] を指定できます。これにより、車は最も近い充電スタンドに到達できますが、ルート上の休憩には影響がありません。

次の例では、初期充電量が低く (10kWh)、ev[minChargeAtChargingStation] を 8kWh に設定してもステーションに到達できないユースケースを説明します。この問題を解決するために ev[minChargeAtFirstChargingStation] を2kWh に設定します。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=52.853812,13.010695&'\
'destination=51.741505,14.352413&'\
'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[auxiliaryConsumption]=1.8&'\
'ev[ascent]=9&'\
'ev[descent]=4.3&'\
'ev[initialCharge]=10&'\
'ev[maxCharge]=80&'\
'ev[chargingCurve]=0,96,8,193,16,200,32,190,48,96,64,48,80,5&'\
'ev[maxChargeAfterChargingStation]=72&'\
'ev[minChargeAtChargingStation]=8&'\
'ev[makeReachable]=true&'\
'ev[connectorTypes]=iec62196Type2Combo&'\
'ev[minChargeAtFirstChargingStation]=2&'\
'apiKey=YOUR_API_KEY'
{
  "routes": [
    {
      "id": "50b23cd6-d6dc-42f8-87e0-927403f2efc2",
      "sections": [
        {
          "id": "aad8590f-e100-4fb0-80a5-a847cb12f48d",
          "type": "vehicle",
          "postActions": [
            {
              "action": "charging",
              "duration": 1390,
              "consumablePower": 225,
              "arrivalCharge": 3.3848,
              "targetCharge": 56.9997
            }
          ],
          "departure": {
            "place": {
              "type": "place",
              "location": {
                "lat": 52.8538096,
                "lng": 13.0113434,
                "elv": 88
              },
              "originalLocation": {
                "lat": 52.8538119,
                "lng": 13.010695
              }
            },
            "charge": 10
          },
          "arrival": {
            "place": {
              "type": "chargingStation",
              "location": {
                "lat": 52.7463799,
                "lng": 13.188652,
                "elv": 76
              },
              "displayLocation": {
                "lat": 52.746375,
                "lng": 13.188554
              },
              "id": "evcp0-ZjZmMGU2MmEtM2I1ZC0xMWVmLWFhMjQtNDIwMTBhYTQwMDQz",
              "name": "Pfalzwerke",
              "attributes": {
                "power": 225,
                "current": 450,
                "voltage": 500,
                "supplyType": "dc",
                "connectorType": "iec62196Type2Combo"
              },
              "brand": {
                "hrn": "7f8c54edcfcf6ab4cdb6a64ecc612fd7",
                "name": "Pfalzwerke"
              },
              "chargePointOperator": {
                "id": "e5e55d2a-48d2-11ef-a172-42010aa40019",
                "name": "Pfalzwerke"
              }
            },
            "charge": 3.3848
          },
          "summary": {
            "duration": 2743,
            "length": 23267,
            "consumption": -46.9997,
            "baseDuration": 2743
          },
          "transport": {
            "mode": "car"
          },
          "consumptionType": "electric"
        },
        {
          "id": "470a04ee-178f-4d26-9ff9-c3b168a2fb9e",
          "type": "vehicle",
          "departure": {
            "place": {
              "type": "chargingStation",
              "location": {
                "lat": 52.7463799,
                "lng": 13.188652,
                "elv": 76
              },
              "displayLocation": {
                "lat": 52.746375,
                "lng": 13.188554
              },
              "id": "evcp0-ZjZmMGU2MmEtM2I1ZC0xMWVmLWFhMjQtNDIwMTBhYTQwMDQz",
              "name": "Pfalzwerke",
              "attributes": {
                "power": 225,
                "current": 450,
                "voltage": 500,
                "supplyType": "dc",
                "connectorType": "iec62196Type2Combo"
              },
              "brand": {
                "hrn": "7f8c54edcfcf6ab4cdb6a64ecc612fd7",
                "name": "Pfalzwerke"
              },
              "chargePointOperator": {
                "id": "e5e55d2a-48d2-11ef-a172-42010aa40019",
                "name": "Pfalzwerke"
              }
            },
            "charge": 56.9997
          },
          "arrival": {
            "place": {
              "type": "place",
              "location": {
                "lat": 51.7412356,
                "lng": 14.3525337,
                "elv": 115
              },
              "originalLocation": {
                "lat": 51.741505,
                "lng": 14.3524129
              }
            },
            "charge": 0.1927
          },
          "summary": {
            "duration": 6267,
            "length": 167638,
            "consumption": 56.807,
            "baseDuration": 6267
          },
          "transport": {
            "mode": "car"
          },
          "consumptionType": "electric"
        }
      ]
    }
  ]
}