EV Range Map

EV Range Map is a component of the Navigation SDK UX Framework which calculates and visualizes range on a map based on EV's battery characteristics and energy consumption model. This feature is only available when ELECTRIC engine type is specified.

Installation

Groovy

Kotlin

build.gradle

Groovy

Kotlin

dependencies {
  ...
    implementation "com.mapbox.navigationux:ev-rangemap:1.3.0"
  ...
}

build.gradle.kts

Groovy

Kotlin

dependencies {
  ...
    implementation("com.mapbox.navigationux:ev-rangemap:1.3.0")
  ...
}

Add the library dependency to your build.gradle.kts or build.gradle file. The library version always matches UX Framework version as they have the same release cadence.

Show/Hide EV Range Map

Use DashCoordination#showEvRangeMap to trigger the calculation of an EV Range Map. Once the EV Range Map is created, the SDK will draw it on the map:

Dash.controller.showEvRangeMap()

Note that this call doesn't affect the camera viewport and if you want to include the range map into the viewport you should also observe DashEvents#observeEvRangeMapState and provide the RangeMapState.rangeMapFramePoints for the camera via Dash.applyUpdate (see example)

To hide the EV Range map use DashCoordination#hideEvRangeMap:

Dash.controller.hideEvRangeMap()

The UX Framework also provides a pre-configured sidebar button that allows users to show and hide an EV Range Map. To display the button, users have to enable Show Range Map button option in Vehicle Type settings screen. In this case the feature is only available in free drive mode.

GUIDE

EV Range Map configuration

Learn how to configure appearance of the EV Range Map.

この{Type}は役に立ちましたか？