HERE Routing API v8でのEVルーティング

APIのEVのルート検索機能は、EV車固有のオプションを使用してルート検索サービスを拡張します。ルート検索のレスポンスには、ルート上の車のエネルギー消費の詳細を含めることができます。ルート計算では、ルートに充電ステーションを追加することもでき、エネルギーを使い果たすことなく目的地に到達できるようにすると同時に、全体的な移動時間と充電時間の結果を最適化できます。

コードサンプルについては、次のチュートリアルを参照してください。

消費量の計算

EVのエネルギー消費量は、物理的モデルと経験的モデルのいずれかを使用して計算できます。これらのモデルの詳細については、次のドキュメントを参照してください。

ルート上の充電レベル

消費モデルに加えて、HERE Routing API V8では、車両のバッテリーパラメーターを指定して最終目的地を含むルート上の各経由地の充電レベルを返すことができます。

リクエストパラメーター	必須	説明
`initialCharge`	はい	ルート開始時の車のバッテリーの充電レベル (kWh)

充電スタンドでの充電時間

Routing API を使用すると、車の充電パラメーターとユーザーの充電の優先設定を指定して、充電スタンドでの充電時間を計算できます。

車の充電パラメーター：

リクエストパラメーター	必須	説明
`maxCharge`	はい	車のバッテリーの合計容量 (kWh)。
`chargingCurve`	はい	特定の充電レベル (kWh) での最大バッテリー充電率 (kW) を表す関数曲線。
`maxChargingVoltage`		車のバッテリーがサポートする最大充電電圧 (ボルト)。
`maxChargingCurrent`		車のバッテリーがサポートする最大充電電流 (アンペア)。
`maxChargeAfterChargingStation`	はい	充電スタンドでバッテリーが充電すべき最大充電量 (kWh)。
`maxPowerAtLowVoltage`		`maxChargingVoltage` >= 800 Vの場合に、800 V未満の電圧を供給する充電スタンドから車両を充電できる最大電力。

ユーザーの充電優先設定：

リクエストパラメーター	必須	説明
`minChargeAtChargingStation`		充電スタンドに到着したときの最小充電量 (kWh)。
`minChargeAtFirstChargingStation`		最初の充電スタンドに到着したときの最小充電量 (kWh)。
`minChargeAtDestination`		ルートの最終目的地での最小充電量 (kWh)。
`chargingSetupDuration`		充電スタンドに到着してから実際に充電するまでの時間 (秒単位)。たとえば、支払い処理に費やされた時間などです。

充電時間の計算

chargingCurve は、バッテリーの充電速度を表す主なパラメーターです。 chargingCurveは、特定の充電状態でバッテリーが受け入れることができる最大電力を指定します。バッテリーが電力のコンポーネント (電圧と電流) に対してより詳細な制限を持っている場合、リクエストではオプションのmaxChargingVoltageパラメーターとmaxChargingCurrentパラメーターを使用してこれらの制限を指定できます。

この2つのパラメーターにより、提供される電力がこの範囲内にあるにもかかわらず、充電スタンドがバッテリーの許容範囲外の電圧と電流を提供する場合に、充電の有効電力をより適切に推定できます。

充電スタンドでサポートされている電圧が800 V未満でも、車のmaxChargingVoltageがこれより高い場合、スタンドの電力は充電時間を計算するために45 kWに制限されます。これは、より高い固有電圧の車両が、より低い電圧のスタンドに接続された場合、定格電力を引き出すことができないという事実を考慮したものです。車両がこれらのスタンドからより高い電力を引き出せる場合、45 kWの電力上限は、パラメーターmaxPowerAtLowVoltageを使用してオーバーライドできます。

充電時間は、バッテリーが充電スタンドのコネクターから車両が引き出せる電力の90%で充電できると仮定して算出されます。

例：以下の条件が指定されている場合：

chargingCurve：150 kWでの定常充電
maxChargingVoltage：400 V
充電スタンドA：最大電力：150 kW、電圧400 V、電流375 A
充電スタンドB：最大電力：150 kW、電圧：800 V、電流：187.5 A

充電スタンドAの電圧はmaxChargingVoltageで指定された制限内です。したがって、consumablePowerは400 V * 375 A = 150 kWとなります。

充電スタンドBの電圧はmaxChargingVoltageを超えています。consumablePowerは400 V * 187.5 A = 75 kWとして計算されます。

充電スタンドでの最大充電量を決定する

maxChargeAfterChargingStationで、EVルート計画中に充電スタンドでの最大充電量を制限できます。このパラメーターは、製造元が推奨するバッテリーのハードウェア制限を指定することを目的としています。このパラメーターは、EV のルート検索アルゴリズムに「最適な」充電レベルを指示するために使用すべきではありません。

充電ステーションを訪れた後の充電値は、このパラメーターの値よりも低くなる可能性があります。このアルゴリズムは、潜在的な各充電ステーションでのさまざまな充電レベルを考慮し、ルートが到達可能であることを確認しながら、ルートの合計所要時間 (移動時間と充電時間) を最適化しようとします。

たとえば、ルート上に高速ではあるが到達できない充電ステーションがある場合、アルゴリズムはまず低速のステーションで充電することを優先しますが、高速なステーションに到達できるレベルまでのみ充電します。このようにして、運転と充電に関して可能な限り最良の組み合わせが得られます。

到達可能なルートを確保するための充電スタンドを追加する

消費モデル、初期充電レベル、充電時間を計算するためのパラメーターに加えて、Routing APIを使用すると、総移動時間と充電時間に最適化された到達可能なルートをリクエストできます。必要に応じて、到達可能性を確保するために充電スタンドがルートに追加されます。

リクエストパラメーター	必須	説明
`makeReachable`	はい	`true` に設定すると、ルーターは計算されたルートが指定された制約内で到達可能であることを確認します。
`connectorTypes`	はい	車と互換性のあるコネクタータイプのカンマ区切りリスト。
`preferredBrands`	いいえ	充電スタンドのブランド ID のカンマ区切りリスト。`makeReachable` が `true` に設定されている場合、ルートの総所要時間 (移動時間と充電時間) が長くなる場合でも (充電地点ごとに最大 15 分)、指定されたブランドの充電スタンドが潜在的な充電地点として優先されます。
`preferredChargePointOperators`	いいえ	充電ポイントのオペレーター ID のカンマ区切りのリスト。`makeReachable` が `true` に設定されている場合、ルートの総所要時間 (移動時間と充電時間) が長くなる場合でも (充電地点ごとに最大 15 分)、指定された充電ポイントオペレーターの充電スタンドが潜在的な充電地点として優先されます。
`eMobilityServiceProviderPreferences`	いいえ	eMobilityサービスプロバイダーIDと優先度 (`High`、`Medium`、`Low`、`Exclude`) のカンマ区切りリスト。より高い優先度を持つeMobilityサービスプロバイダーに対応した充電スタンドが、充電停止地点として優先的に選択されます。詳細については、「APIリファレンス」を参照してください。

📘
注
preferredBrands は廃止されました。代わりに preferredChargePointOperators を使用します。ユーザーはパラメーター eMobilityServiceProviderPreferences でデフォルトの優先レベルを指定できます。たとえば、default;preference=Low です。デフォルトの優先レベルは、指定されたeMobilityサービスプロバイダーをサポートしないステーションに適用されます。ユーザーがデフォルトの優先レベルを指定しない場合は、exclude に設定されます。つまり、優先設定で指定されたeMobilityサービスプロバイダーをサポートしていないステーションは、充電地点として選択されることがありません。ユーザーはデフォルト優先設定として任意の優先レベルを指定できますが、eMobilityサービスプロバイダーに指定されている最も低い優先レベルよりも高い優先レベルを割り当てることはお勧めしません。詳細については、「APIリファレンス」を参照してください。

充電スタンド

Routing APIでは、以下の理由からDCタイプのスタンドのみが考慮されます。

ACステーションでのフル充電にはかなりの時間がかかり (数時間)、ルートに沿った充電を伴うEVルート計画のユースケースに当てはまりません。
DCステーションの充電ネットワークはすでに十分なカバレージを提供しています。詳細については、「カバレージとEVのルート検索」を参照してください。

HERE EV Charge Points API v3

Routing APIは、ルートに追加された充電スタンドのロケーションIDを返します。このIDは、HERE EV Charge Points API v3を使用して、充電スタンドに関する追加情報を取得するために利用できます。詳細は、このページでご確認ください。ev[preferredChargePointOperators]、ev[excludeChargePointOperators]、ev[eMobilityServiceProviderPreferences]に使用される充電ポイントオペレーター (CPO) およびeMobilityサービスプロバイダー (eMSP) のIDも、このサービスを通じて取得できます (こちらを参照)。

以前のバージョンの開発者ガイドでは、HERE Charge Points APIのv2バージョンを参照していました。v2からv3に移行するユーザーは、この移行ガイドをご使用のうえ、新しいサービスバージョンに合わせて実装を更新してください。