電気自動車の充電を考慮する

ユーザーストーリー

ユーザーは電気自動車を使用して旅程を計画しており、さまざまなWaypointsを訪問する必要があります。 車両の再充電に必要な時間を考慮する ために、このパラメータevChargingTimePerDistanceを使用できます。

背景情報

HERE Waypoints Sequence API V8 は、Waypoints 間の電気自動車（「 EV 」）の充電に使用する時間を計算できます。 これは、単純なモデルの後で行います。 一定時間内に、一定の距離のエネルギーを車両に充電できるものと想定されています。 車両を適切なレベルに充電するために必要な距離と時間を定義するのは、ユーザーの選択です。 充電時間は URL パラメータevChargingTimePerDistance=timeInSecondsToRegainChargingLevel,distanceInMeterUntilRechargeで制御されます。

充電に必要な時間は休憩時間と見なされます。これは、ドライバーが何もしないことを前提としているためです。

• 法的な休憩時間がない場合: 「 REST 」と記されたレスポンスのすべての時間が車両の充電に必要です
• 法的な休憩時間の場合： 通常の休憩時間が充電に使用されていることを前提としています。 ドライバーの休憩時間が必要な充電時間と等しいか、またはそれを超える場合、追加時間は加算されません。 ドライバーの休息時間が十分でない場合、必要な追加の充電時間が休憩時間に加算されます。

すべての休憩および充電時間は、 2 つのWaypoints間の要約形式で提供されます。 目的地での充電はサポートされていません。 サービス時間に加算できます。

部分的な充電はサポートされていません。 特に、最後のWaypointsに到達するために充電が必要な場合、車両は到達する前に完全に充電されます。

どのような場合でも、 HERE Routing API を使用して充電時間を計算できます。

リクエスト

curl -H "Authorization: Bearer TOKEN_HERE" "https://wps.hereapi.com/v8/findsequence2?departure=2016-10-14T07:30:00Z&mode=fastest;truck;traffic:disabled;&start=Warsaw;52.2356,21.01038&end=Copenhagen;55.68524,12.57106;st:900&destination1=Berlin;52.51605,13.37691;st:300&evChargingTimePerDistance=7200,300000"

curl "https://wps.hereapi.com/v8/findsequence2?departure=2016-10-14T07:30:00Z&mode=fastest;truck;traffic:disabled;&start=Warsaw;52.2356,21.01038&end=Copenhagen;55.68524,12.57106;st:900&destination1=Berlin;52.51605,13.37691;st:300&evChargingTimePerDistance=7200,300000&apikey=APIKEY_HERE"

レスポンス

{
  "results": [
    {
      "waypoints": [
        {
          "id": "Warsaw",
          "lat": 52.2356,
          "lng": 21.01038,
          "sequence": 0,
          "estimatedArrival": null,
          "estimatedDeparture": "2016-10-14T07:30:00Z",
          "fulfilledConstraints": []
        },
        {
          "id": "Berlin",
          "lat": 52.51605,
          "lng": 13.37691,
          "sequence": 1,
          "estimatedArrival": "2016-10-14T16:49:02Z",
          "estimatedDeparture": "2016-10-14T16:54:02Z",
          "fulfilledConstraints": [
            "st:300"
          ]
        },
        {
          "id": "Copenhagen",
          "lat": 55.68524,
          "lng": 12.57106,
          "sequence": 2,
          "estimatedArrival": "2016-10-15T04:09:02Z",
          "estimatedDeparture": null,
          "fulfilledConstraints": [
            "st:900"
          ]
        }
      ],
      "distance": "1010126",
      "time": "75242",
      "interconnections": [
        {
          "fromWaypoint": "Warsaw",
          "toWaypoint": "Berlin",
          "distance": 573801,
          "time": 26342,
          "rest": 7200,     # 7200s of charging. That's one charge stop after 300km. 273.801km are driven without further charging
          "waiting": 0
        },
        {
          "fromWaypoint": "Berlin",
          "toWaypoint": "Copenhagen",
          "distance": 436325,
          "time": 26100,
          "rest": 14400,    # 14400s of charging. Since the last charging 710.126km still must be driven. That requires two more stops stops. 
          "waiting": 0
        }
      ],
      "description": "Targeted best time; without traffic",
      "timeBreakdown": {
        "driving": 52442,
        "service": 1200,
        "rest": 21600,  # Three charging stops in total.
        "waiting": 0
      }
    }
  ],
  "processingTimeDesc": "959ms",
  "responseCode": "200",
  "warnings": null,
  "requestId": null
}