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

EV充電ポイントの確認方法

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

背景情報

HERE Waypoints Sequence API V8は、経由地間の電気自動車 (EV) の充電に使用する時間を計算できます。これは単純なモデルに従って行われ、一定時間で一定の距離分のエネルギーを車両に充電できることを想定しています。

距離と、車両を適切なレベルまで充電するために必要な時間はユーザーが定義できます。

充電時間はURLパラメーターevChargingTimePerDistance=timeInSecondsToRegainChargingLevel,distanceInMeterUntilRechargeで制御します。

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

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

すべての休憩および充電時間は、それぞれの2つの経由地間で集計されて提供されます。目的地での充電はサポートされていません。サービス時間には加算できます。

部分充電はサポートされていません。最後の経由地に到達するために充電が必要な場合、到達する前に車両はフル充電されます。

HERE Routing APIを使用してより精密な充電時間を計算できます。

リクエスト

curl -H "Authorization: Bearer BEARER_TOKEN" "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"

レスポンス

{
  "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,
          "waiting": 0
        },
        {
          "fromWaypoint": "Berlin",
          "toWaypoint": "Copenhagen",
          "distance": 436325,
          "time": 26100,
          "rest": 14400,
          "waiting": 0
        }
      ],
      "description": "Targeted best time; without traffic",
      "timeBreakdown": {
        "driving": 52442,
        "service": 1200,
        "rest": 21600,
        "waiting": 0
      }
    }
  ],
  "processingTimeDesc": "959ms",
  "responseCode": "200",
  "warnings": null,
  "requestId": null
}