EVCarOptions class
All the options to specify how a route for an electric car should be calculated.
At minimum, a valid EVConsumptionModel must be set or the route calculation will fail.
Note: EVCarOptions.ensureReachability must be true to make sure that all stopovers are reachable. For this,
charging stations may be added to the route. If EVCarOptions.ensureReachability is true, you need to
specify the required route options and battery specifications that include the current charge level
of the battery (BatterySpecifications.initialChargeInKilowattHours).
See the parameter description below for more details.
- Annotations
-
- @Deprecated("Will be removed in v4.28.0. Use `RoutingOptions` class instead.")
Constructors
Properties
- allowOptions ↔ AllowOptions
-
The options explicitly allowed by user for route calculations. By default
no options are opt in.
getter/setter pair
- avoidanceOptions ↔ AvoidanceOptions
-
Options to specify restrictions for route calculations. By default
no restrictions are applied.
getter/setter pair
- batterySpecifications ↔ BatterySpecifications
-
Parameters that describe the electric vehicle's battery.
getter/setter pair
- carSpecifications ↔ CarSpecifications
-
Detailed car specifications such as dimensions and weight.
getter/setter pair
- consumptionModel ↔ EVConsumptionModel
-
Vehicle specific parameters, which are then used to calculate energy consumption
for the vehicle on a given route.
getter/setter pair
- ensureReachability ↔ bool
-
Ensure that the vehicle does not run out of energy along the way.
Requires valid EVCarOptions.batterySpecifications.
It also requires that
RouteOptions.optimizationMode = OptimizationMode.fastest,
RouteOptions.speedCapInMetersPerSecond is not set, and
AvoidanceOptions is empty. Otherwise, this object is considered invalid.
Setting this flag enables calculation of a route optimized for electric vehicles.
Charging stations may be added along the route to ensure that the vehicle does
not run out of energy along the way.
It is especially useful for longer routes, because after all, charging stations are much
less common than petrol stations.
Note An
sdk.routing.RoutingError.INVALID_PARAMETERis generated when thesdk.routing.EVCarOptions.ensure_reachabilityis set totruein casesdk.routing.RoutingEngine.import_routeis called. Defaults tofalse.getter/setter pair - evMobilityServiceProviderPreferences ↔ EVMobilityServiceProviderPreferences
-
Defines the preferred E-Mobility Service Providers.
The The E-Mobility Service Provider Partner Ids can be received from
https://www.here.com/docs/bundle/ev-charge-points-api-developer-guide/page/topics/resource-roamings.html
An alternative way to get
partnerIdis theeMobilityServiceProviders.partnerIdas part ofHERE SDK Search. Maximum number of E-Mobility Service Providers is limited to 10. By default, all providers are used.getter/setter pair - hashCode → int
-
The hash code for this object.
no setter
- lastCharacterOfLicensePlate ↔ String?
-
Specifies the last character of a vehicle's license plate, typically used to
evaluate traffic restrictions in certain environmental or low-emission zones.
In cities like Bogotá, Mexico City, or Jakarta, specific license plate digits may
be restricted on certain days or in certain areas to reduce congestion and emissions.
When this value is provided, the HERE SDK considers it during route calculation to
avoid roads or areas where your vehicle may be restricted based on local regulations.
Example usage: "7", when the license plate of a vehicle looks like "B-ET-182487".
getter/setter pair
-
maxSpeedOnSegments
↔ List<
MaxSpeedOnSegment> -
Segments with restriction on maximum DynamicSpeedInfo.baseSpeedInMetersPerSecond.
getter/setter pair
- occupantsNumber ↔ int
-
Specifies the number of occupants in the vehicle, including driver,
can affect the vehicle's ability to use HOV/carpool restricted lanes.
Shouldn't be less than 1 or greater than 255. Defaults to 1.
getter/setter pair
- routeOptions ↔ RouteOptions
-
Specifies the common route calculation options.
getter/setter pair
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- textOptions ↔ RouteTextOptions
-
Customize textual content returned from the route calculation, such
as localization, format, and unit system.
getter/setter pair
- tollOptions ↔ TollOptions
-
Options to specify how the tolls should be calculated,
such as transponders, vehicle category, and emission type.
getter/setter pair
Methods
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool - The equality operator.