Version

Date

Change

Description

4.27.1.0

2026-07-27

ADDED

Map view: Added support for POI filtering with `MapContentSettings.configurePoiFilter(PoiFilterCriteria)` and `MapContentSettings.resetPoiFilters()` using the new types `EVPoiFilterCriteriaBuilder`, `ElectricCurrentType`, and `ElectricVehicleType` to create a `PoiFilterCriteria`. Note that this is a **beta** release of this feature.

4.27.1.0

2026-07-27

FIXED

Navigation: Fixed an issue related to `VisualNavigator.routeDrawOrder` not working as expected, causing the configured draw order not being applied correctly and the active route may be rendered below another route. Now the API works as expected.

4.27.1.0

2026-07-27

ADDED

Map view: Added `MapScene.addMapPolylineLayer(String, MapLayerPriority?)` to create a named polyline layer at a specific render priority. Added `MapScene.addMapPolylineToLayer(MapPolyline, String)` and `MapScene.addMapPolylinesToLayer(List, String)` to add polylines to a named layer. Added `MapScene.removeMapPolylineLayer(String)` to remove a named polyline layer and all polylines it contains.

4.27.1.0

2026-07-27

ADDED

Navigation: Added `VisualNavigator.routeLayerOverlay` to expose the name of the internal route polyline placeholder layer. Pass this name to build `MapLayerPriority` and use `MapScene.addMapPolylineLayer` to position custom polylines above the navigation route. For custom polylines below the route, use the default map polyline layer. Note that this is a **beta** release of this feature.

4.27.1.0

2026-07-27

ADDED

Map view: Added `MapContextSceneLoadCacheOptions` and `MapContextMemoryManagementOptions.sceneLoadCacheOptions` for scene load cache customization. Note that this is a **beta** release of this feature.

4.27.1.0

2026-07-27

ADDED

Electronic horizon: Added weak listener support for `ElectronicHorizonEngine.addElectronicHorizonListener(ElectronicHorizonListener)`.

4.27.1.0

2026-07-27

CHANGED

Removed `HazardousMaterialRestriction.hazardousMaterial`. Use `HazardousMaterialRestriction.hazardousMaterials` instead.

4.27.1.0

2026-07-27

ADDED

This version of the HERE SDK is delivered with map data v227 for `CatalogType.optimizedClientMap` catalog and v98 for `CatalogType.optimizedClientMapJapan` catalog.

4.27.1.0

2026-07-27

FIXED

Navigation: Fixed missing toll stop warnings observed through `TollStopWarningListener` when the exact number of lanes is not available in the map.

4.27.1.0

2026-07-27

FIXED

Navigation: Fixed an error during navigation that used to cause an error message being logged repeatedly related to unsupported categories.

4.27.1.0

2026-07-27

KNOWN ISSUE

Map view: Flutter's hot restart feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details: https://github.com/flutter/flutter/issues/58987.

4.27.1.0

2026-07-27

KNOWN ISSUE

Navigation: When a `Route` contains a ferry `Section`, then false positive route deviations may be reported within that `Section`.

4.27.1.0

2026-07-27

KNOWN ISSUE

Android: To ensure Flutter based Android application stability and reliable map rendering, certain graphics features and the rendering of semi-transparent map content are automatically adjusted or restricted on devices using PowerVR Rogue GPUs, Adreno 730-740 GPUs, or ARM Mali GPU drivers version 32-38. On affected devices, enabling these features or rendering semi-transparent map content may increase memory usage and lead to application freezes or map view instability. The `MapFeatures.ambientOcclusion` and `MapFeatures.shadows` will be prohibited, even if there is a request to enable them. `MapFeatures.congestionZones`, `MapFeatures.environmentalZones`, `MapFeatures.lowSpeedZones` and roads in `MapScheme.hybridDay`, `MapScheme.hybridNight`, `MapScheme.liteHybridDay`, `MapScheme.liteHybridNight`, `MapScheme.logisticsHybridDay`, `MapScheme.logisticsHybridNight` display visible darkening due to overlapping rendering. Roads show this darkening at the road segment junctions. For semi-transparent `MapPolyline`, the polylines will lose their transparency. Furthermore, `MapFeatures.terrain` with `MapFeatureModes.terrain3D` will be automatically switched to `MapFeatureModes.terrainHillshade` if the GPU is PowerVR Rogue.

4.27.1.0

2026-07-27

KNOWN ISSUE

The `SpeedLimitListener` is **incorrectly labelled as deprecated**. The 4.27.2.0 release is expected to address this issue.

4.27.1.0

2026-07-27

KNOWN ISSUE

Warner: The `WarnerEngine` is **incorrectly labelled as beta**. The 4.27.2.0 release is expected to address this issue. The feature is now considered to be stable and any future changes will follow a strict deprecation process.

4.27.0.0

2026-07-10

CHANGED

Map view: Removed deprecated `LocationIndicator.setMarker3dModel(MapMarker3DModel, double, LocationIndicatorMarkerType)`. Use `LocationIndicator.setMarker3dModelWithRenderSizeUnit(MapMarker3DModel, double, LocationIndicatorMarkerType, RenderSizeUnit)` instead.

4.27.0.0

2026-07-10

CHANGED

Map view: Removed deprecated `MapCameraKeyframeTrack.lookAtDistanceWithEasing(List, Easing, KeyframeInterpolationMode)`. Use `MapCameraKeyframeTrack.lookAtDistanceWithKind(MapMeasureKind, List, Easing, KeyframeInterpolationMode)` instead.

4.27.0.0

2026-07-10

CHANGED

Navigation: Moved `AreaCameraBehavior`, `AutomotiveCameraBehavior`, `TrackingCameraBehavior` from Beta to Alpha.

4.27.0.0

2026-07-10

CHANGED

Navigation: Removed the previously deprecated `RouteProgress.sectionIndex`. Use `RouteProgress.routeMatchedLocation.sectionIndex` instead.

4.27.0.0

2026-07-10

CHANGED

Navigation: Removed the previously deprecated `RouteProgress.spanIndex`. Use `RouteProgress.routeMatchedLocation.spanIndex` instead.

4.27.0.0

2026-07-10

CHANGED

Offline routing: Removed previously deprecated `RoutePrefetcher.prefetchAroundLocationWithRadius`. Use `PolygonPrefetcher.prefetch` instead.

4.27.0.0

2026-07-10

CHANGED

Navigation: Removed the previously deprecated `ManeuverNotificationOptions.enableDestinationReachedNotification`. Use `ManeuverNotificationOptions.arrivalNotificationOption` instead.

4.27.0.0

2026-07-10

CHANGED

Routing: Removed the previously deprecated `ViolatedRestriction.forbiddenTruckType`. Use `ViolatedRestriction.Details.forbiddenTruckCategory` instead.

4.27.0.0

2026-07-10

CHANGED

Core: Removed the previously deprecated `VehicleSpecification.truckType`. Use `VehicleSpecification.truckCategory` instead.

4.27.0.0

2026-07-10

CHANGED

Navigation: Removed the previously deprecated constructors for `ManeuverNotificationOptions`. Use `ManeuverNotificationOptions.withDefaults()` instead.

4.27.0.0

2026-07-10

ADDED

This version of the HERE SDK is delivered with map data v225 for `CatalogType.optimizedClientMap` catalog and v97 for `CatalogType.optimizedClientMapJapan` catalog.

4.27.0.0

2026-07-10

CHANGED

Navigation: Replaced usage of `MapMeasure` with `double` in `AreaCameraBehavior` and `TrackingCameraBehavior`.

4.27.0.0

2026-07-10

CHANGED

Navigation: Deprecated in `NavigatorInterface`: `environmentalZoneWarningListener`, `safetyCameraWarningListener`, `safetyCameraWarningOptions`, `dangerZoneWarningListener`, `truckRestrictionsWarningListener`, `truckRestrictionsWarningOptions`, `roadSignWarningListener`, `roadSignWarningOptions`, `schoolZoneWarningListener`, `schoolZoneWarningOptions`, `realisticViewWarningListener`, `realisticViewWarningOptions`, `borderCrossingWarningListener`, `borderCrossingWarningOptions`, `tollStopWarningListener`, `railwayCrossingWarningListener`, `lowSpeedZoneWarningListener`, `trafficMergeWarningListener`, `trafficMergeWarningOptions`, `getWarningNotificationDistances`, `setWarningNotificationDistances`. Deprecated listener types/interfaces: `BorderCrossingWarningListener`, `DangerZoneWarningListener`, `EnvironmentalZoneWarningListener`, `LowSpeedZoneWarningListener`, `RailwayCrossingWarningListener`, `RealisticViewWarningListener`, `RoadSignWarningListener`, `SafetyCameraWarningListener`, `SchoolZoneWarningListener`, `TollStopWarningListener`, `TrafficMergeWarningListener`, `TruckRestrictionsWarningListener`. Use `WarnerEngine.addWarningListener` instead. Deprecated per-warning distance fields: `RealisticViewWarning.distanceToRealisticViewInMeters`, `DangerZoneWarning.distanceInMeters`, `SafetyCameraWarning.distanceToCameraInMeters`, `RoadSignWarning.distanceToRoadSignInMeters`, `BorderCrossingWarning.distanceToBorderCrossingInMeters`, `EnvironmentalZoneWarning.distanceInMeters`, `RailwayCrossingWarning.distanceToRailwayCrossingInMeters`, `SchoolZoneWarning.distanceToSchoolZoneInMeters`, `TollStop.distanceToTollStopInMeters`, `LowSpeedZoneWarning.distanceToLowSpeedZoneInMeters`, `TrafficMergeWarning.distanceToTrafficMergeInMeters`, `TruckRestrictionWarning.distanceInMeters`. Use `WarningUpdate.distanceTillStartInMeters` and `WarningUpdate.distanceTillEndInMeters` instead.

4.27.0.0

2026-07-10

CHANGED

Warner: Introduced a unified warning model delivered through `WarningListener.onWarnings(warnings, warningsRegistry)`. Added `Warning` (identifies a warning via `id`, `warningType`, and optional `customWarningType`), `WarningUpdate` (carries `warning`, `warningStatus`, `distanceTillStartInMeters`, and `distanceTillEndInMeters`), and the `WarningStatus` enum (`ahead`, `approaching`, `reached`, `inside`, `passed`). Concrete warning details are retrieved from the provided `WarningsRegistry` using `Warning.id`. Removed `WarnerEngine.getWarningsRegistry()`. Use the `WarningsRegistry` received in the listener callback instead. Note that this is a **beta** release of this feature.

4.27.0.0

2026-07-10

CHANGED

Updated the supported Flutter version from 3.38.10 to 3.41.9 and the corresponding Dart version from 3.10.9 to 3.11.5. Therefore, with this release only **Flutter 3.41.9** and **Dart 3.11.5** are supported. Other versions may also work, but are not guaranteed to work. The next Flutter update is planned with HERE SDK 4.28.0.0.

4.27.0.0

2026-07-10

CHANGED

Navigation: Changed render order of `MapPolyline` objects and the route added by `VisualNavigator`. The route is now rendered on top of the `MapPolyline` objects.

4.27.0.0

2026-07-10

FIXED

Navigation: Fixed an ANR that could occur when setting custom `ManeuverNotificationOptions` on `Navigator` or `VisualNavigator`.

4.27.0.0

2026-07-10

ADDED

Indoor map: Added support for multimodal indoor routing and via waypoints.

4.27.0.0

2026-07-10

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.27.0.0

2026-07-10

KNOWN ISSUE

Navigation: When a `Route` contains a ferry `Section`, then false positive route deviations may be reported within that `Section`.

4.27.0.0

2026-07-10

KNOWN ISSUE

Navigation: When route polylines overlap and `VisualNavigator.setRouteDrawOrder()` is set, then the configured draw order may not be applied correctly and the active route may be rendered below another route. The 4.27.1 release is expected to address this issue.

4.27.0.0

2026-07-10

KNOWN ISSUE

Navigation: During navigation, an error message related to unsupported categories may be logged repeatedly.

4.27.0.0

2026-07-10

KNOWN ISSUE

Warner: The `WarnerEngine` is **incorrectly labelled as beta**. The 4.27.1 release is expected to address this issue. The feature is now considered to be stable and any future changes will follow a strict deprecation process.

4.26.5.0

2026-06-30

FIXED

Map view: Fixed `LocationIndicator` rotating at low or zero speed.

4.26.5.0

2026-06-30

CHANGED

Navigation: Changed the return type of `WarnerEngine.setWarningNotificationDistances(...)` and `WarnerEngine.setCustomWarningNotificationDistances(...)` from `bool` to `void`.

4.26.5.0

2026-06-30

FIXED

Navigation: Fixed an issue where an intersection of multi-carriageway and single-carriageway roads was incorrectly considered as multiple junctions for `Maneuver` generation, which led to missing or redundant maneuvers.

4.26.5.0

2026-06-30

FIXED

Navigation: Fixed incorrect `LaneAssistance` data and lane-based voice instructions when a lane forks into two parallel roads.

4.26.5.0

2026-06-30

FIXED

Routing: Fixed an issue where `ManeuverAction.leftFork` and `ManeuverAction.rightFork` were returned instead of `ManeuverAction.leftRamp` and `ManeuverAction.rightRamp` for road bifurcations, resulting in an inaccurate maneuver icon.

4.26.5.0

2026-06-30

ADDED

This version of the HERE SDK is delivered with map data v223 for `CatalogType.optimizedClientMap` catalog and v97 for `CatalogType.optimizedClientMapJapan` catalog.

4.26.5.0

2026-06-30

FIXED

Navigation: Fixed warning options being reset after setting the route when using the `WarnerEngine` class.

4.26.5.0

2026-06-30

FIXED

Navigation: Fixed an issue where traffic-on-route updates failed in `Navigator` and `VisualNavigator` when they could not verify that the `TrafficOnRoute` instance was calculated from the current route. This prevented traffic updates from being applied on HERE SDK version 4.26.0 and later.

4.26.5.0

2026-06-30

ADDED

Routing: Added `Span.isoCountryCode` to be used with `RoadShieldIconProperties.isoCountryCode`.

4.26.5.0

2026-06-30

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.26.5.0

2026-06-30

KNOWN ISSUE

Navigation: When a `Route` contains a ferry `Section`, then false positive route deviations may be reported within that `Section`.

4.26.5.0

2026-06-30

KNOWN ISSUE

Navigation: When route polylines overlap and `VisualNavigator.setRouteDrawOrder()` is set, then the configured draw order may not be applied correctly and the active route may be rendered below another route.

4.26.5.0

2026-06-30

KNOWN ISSUE

Navigation: When turn-by-turn navigation is active for routes exceeding 1 km, then the route polyline on the base map may be rendered in gray even when custom route colors are configured via `MapPolyline` and `SolidRepresentation` APIs.

4.26.4.0

2026-06-05

ADDED

Map view: Added the following common Anchor2D instances for top, left, right, bottom, center and the 4 corners `Anchor2D.center()`, `Anchor2D.top()`, `Anchor2D.topRight()`, `Anchor2D.right()`, `Anchor2D.bottomRight()`, `Anchor2D.bottom()`, `Anchor2D.bottomLeft()`, `Anchor2D.left()` and `Anchor2D.topLeft()`.

4.26.4.0

2026-06-05

CHANGED

Indoor map: Removed deprecated `VenueTransportMode.auto` enum, use transport mode `car` instead. Removed deprecated `VenueTransportMode.motorcycle` enum, use transport mode `scooter` instead. Removed deprecated `VenueTransportMode.emergencyVehicle` enum, use transport mode `car` instead.

4.26.4.0

2026-06-05

FIXED

Navigation: Fixed `TrackingCameraBehavior` zoom-in functionality when matching the `Maneuver`.

4.26.4.0

2026-06-05

FIXED

Navigation: Fixed incorrect bearing when approaching a `Maneuver` in `TrackingCameraBehavior`.

4.26.4.0

2026-06-05

FIXED

Navigation: Fixed wrong `SpeedLimit` reported for trucks in some countries on built-up areas.

4.26.4.0

2026-06-05

ADDED

Added `offlineSearch` value to `SDKNativeEngine.PurgeMemoryStrategy` enum. Calling `purgeMemoryCaches(offlineSearch)` clears only offline search caches, leaving map tile and routing caches intact.

4.26.4.0

2026-06-05

ADDED

Navigation: Added `LocationSimulatorOptions.useDefaultSpeedWhenMissing` to allow disabling the default speed on GPX track points missing a speed value. Added `LocationSimulatorOptions.calculateBearingWhenMissing` to allow disabling bearing calculation from adjacent track points.

4.26.4.0

2026-06-05

FIXED

Navigation: Fixed `DynamicRoutingEngine` incorrectly passing `TollOptions` to internal route refresh requests when `RouteOptions.enableTolls` was enabled, causing a `RoutingError.invalidParameter` error.

4.26.4.0

2026-06-05

ADDED

Routing: Added support for section level notice in `IndoorSectionDetails`.

4.26.4.0

2026-06-05

ADDED

Map view: Added `MapImage.size : Size2D` property that returns the pixel size of the image.

4.26.4.0

2026-06-05

FIXED

Offline routing: Fixed `SectionNotice` severity for no-through road restriction in offline routing to be reported as `info` instead of `critical`.

4.26.4.0

2026-06-05

ADDED

Map view: Increased multi-color polyline color stop count limit to 16384, color count limit increased to 1024 affecting `MapPolylineSolidMultiColorRepresentation` API. Additionally, the performance of this feature was improved. Note that this is a **beta** release of this feature.

4.26.4.0

2026-06-05

FIXED

Fixed enabled warnings in `WarnerEngine` when it is received from `Navigator`.

4.26.4.0

2026-06-05

FIXED

Navigation: Fixed rare incorrect U-turn maneuver instructions for non-multicarriage roads with empty road and route names.

4.26.4.0

2026-06-05

FIXED

Navigation: Fixed the wrong `straight` recommendation on `CurrentSituationLaneAssistanceView`, `ManeuverViewLaneAssistance`, and `JunctionViewLaneAssistance` when entering a complex junction without markings at the entrance.

4.26.4.0

2026-06-05

FIXED

Navigation: Fixed the wrong `straight` lane recommendation on `CurrentSituationLaneAssistanceView`, `ManeuverViewLaneAssistance`, and `JunctionViewLaneAssistance` that happens on some exits to sliproads.

4.26.4.0

2026-06-05

FIXED

Navigation: Fixed the incorrect lane recommendation on `CurrentSituationLaneAssistanceView`, `ManeuverViewLaneAssistance`, and `JunctionViewLaneAssistance` that happens when the marking did not match the angle of the street.

4.26.4.0

2026-06-05

FIXED

Navigation: Fixed the wrong lane recommendation on `CurrentSituationLaneAssistanceView`, `ManeuverViewLaneAssistance`, and `JunctionViewLaneAssistance` caused by inconsistent map data.

4.26.4.0

2026-06-05

FIXED

Navigation: Fixed incorrect `straight` lane recommendation on `CurrentSituationLaneAssistanceView`, `ManeuverViewLaneAssistance`, and `JunctionViewLaneAssistance` when entering a large junction with lane markings at an unexpected location.

4.26.4.0

2026-06-05

ADDED

Map view: Added class `MapInteractionListener` to support receiving notifications from map interactions. Added enum class `MapInteractionState` to describe the supported states of a map interaction. Added `Gestures.mapInteractionListener` property to store the current `MapInteractionListener`.

4.26.4.0

2026-06-05

ADDED

Map view: Added new method `Color DataAttributes.getColor()` to get an attribute of type `Color` and `DataAttributeBuilder.withColor(String, Color)` to add an attribute of type `Color`.

4.26.4.0

2026-06-05

ADDED

Offline search: Added support for `PlaceFilter.ev.supplierNames` and `PlaceFilter.ev.connectorTypeIDs` when using EV station filtering in `OfflineSearchEngine`.

4.26.4.0

2026-06-05

FIXED

Offline routing: Fixed routing options not being preserved when performing a return to route in offline mode.

4.26.4.0

2026-06-05

ADDED

Map view: Added `MapArrow.progress` and `MapArrow.progressColor` properties to style two parts of a map arrow with different colors.

4.26.4.0

2026-06-05

CHANGED

Offline maps: Improved clearing of the in-memory map cache when `sdkNativeEngine.purgeMemoryCache(PurgeMemoryStrategy.full)` is called. Now, as much memory as possible is released.

4.26.4.0

2026-06-05

ADDED

Navigation: Added `TrackingCameraBehavior.headingStabilizationThresholdInDegrees`. Public setters on `TrackingCameraBehavior` (tilt, bearing, zoom policy) now apply immediately when called before the camera is attached and animate to the new target afterwards, so a configuration sequence run during setup lands the camera at the configured pose on the first frame instead of animating from compiled-in defaults.

4.26.4.0

2026-06-05

FIXED

Navigation: Fixed the text notifications for both safety camera warner and for traffic merge warner when using the new `WarnerEngine` API.

4.26.4.0

2026-06-05

ADDED

Search: Added `EVChargingLocation.nearbyPlaces` that represents the list of Places within walking distance from the EV charging location and `EVChargingLocation.hasMoreNearbyPlaces` that represents the boolean flag indicating whether there are additional nearby places beyond those included in the `EVChargingLocation.nearbyPlaces` list.

4.26.4.0

2026-06-05

ADDED

This version of the HERE SDK is delivered with map data v221 for `CatalogType.optimizedClientMap` catalog and v96 for `CatalogType.optimizedClientMapJapan` catalog.

4.26.4.0

2026-06-05

CHANGED

Map view: Modified a **beta** API by replacing property `MapContextMemoryManagementResult.resultCode` by a boolean `MapContextMemoryManagementResult.success` to represent the failure or success of the method `MapContext.setMemoryManagementOptions()`. In case the input value for tile cache or video memory is larger than the supported maximum allowed limit, it is clamped. Removed the obsolete beta API enum `MapContextMemoryManagementResultCode`.

4.26.4.0

2026-06-05

ADDED

Map view: Implemented dynamic height extrusion for building geometry (extruded & 3d landmark) depending on camera zoom and tilt.

4.26.4.0

2026-06-05

CHANGED

Starting with the next release, HERE SDK 4.26.5.0, we plan to remove documentation assets from the release packages, since the same content is available online on our [documentation pages](https://docs.here.com/here-sdk/docs). For now, this includes only the [Developer Guide](https://docs.here.com/here-sdk/docs/flutter-readme). Please refer to the linked online versions to ensure you always have access to the latest content for the HERE SDK version of your choice. If you still need these documents for offline use, please contact us through your HERE representative.

4.26.4.0

2026-06-05

ADDED

Following the release of HERE SDK 4.26.0.0, HERE SDK 4.26.4.0 is the next regular version we are publishing. HERE SDK versions 4.26.1.0, 4.26.2.0, and 4.26.3.0 were internal releases and will not be published, as we decided to focus our efforts on further stabilizing the major release. Therefore, HERE SDK 4.26.4.0 marks the next regular release in the 4.26 release line.

4.26.4.0

2026-06-05

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.26.4.0

2026-06-05

KNOWN ISSUE

Navigation: When a `Route` contains a ferry `Section`, then false positive route deviations may be reported within that `Section`.

4.26.4.0

2026-06-05

KNOWN ISSUE

Navigation: When route polylines overlap and `VisualNavigator.setRouteDrawOrder()` is set, then the configured draw order may not be applied correctly and the active route may be rendered below another route.

4.26.4.0

2026-06-05

KNOWN ISSUE

Navigation: When turn-by-turn navigation is active for routes exceeding 1 km, then the route polyline on the base map may be rendered in gray even when custom route colors are configured via `MapPolyline` and `SolidRepresentation` APIs.

4.26.0.0

2026-05-19

ADDED

We’re refreshing the documentation with a modernized design, improved search, and enhanced AI capabilities for a better overall experience. The online API Reference aligns now with the version included in the HERE SDK package. During the transition, you may notice temporary inconsistencies. We apologize for any inconvenience and recommend consulting the documentation assets included in the HERE SDK package if you encounter any issues. We value your feedback and would love to hear what you think of the new experience.

4.26.0.0

2026-05-19

ADDED

Map view: Added property `VehicleRestriction.appliesToDelivery` indicating whether the restriction applies to delivery vehicles. Support added to `VehicleRestrictionIconProperties` and `PickMapContentResult`. Note that this is a **beta** release of this feature.

4.26.0.0

2026-05-19

ADDED

Map view: Added `MapScene.removeAllMapItems()` to remove all map items from a scene.

4.26.0.0

2026-05-19

ADDED

Added `WarnerEngine`, `WarningListener`, `WarningsRegistry`, `CustomWarning`, and `CustomWarningProvider` types. Added optional `Warning.customWarningType` to support custom warnings. Added `custom` to `WarningType`. Added a `warnerEngine` getter to `NavigatorInterface` so that applications can access the `WarnerEngine`. Check the [NavigationWarners](https://github.com/heremaps/here-sdk-examples) app and the Developer Guide for a usage example. Note that this is a **beta** release of this feature.

4.26.0.0

2026-05-19

ADDED

Navigation: Added unique warning instance identifiers via `id` for: `BorderCrossingWarning`, `DangerZoneWarning`, `EnvironmentalZoneWarning`, `LowSpeedZoneWarning`, `RailwayCrossingWarning`, `RealisticViewWarning`, `RoadSignWarning`, `SafetyCameraWarning`, `SchoolZoneWarning`, `TollStop`, `TrafficMergeWarning`, and `TruckRestrictionWarning`.

4.26.0.0

2026-05-19

ADDED

Navigation: Added `LaneDecreaseWarning` class which notifies of an upcoming reduction in the number of available lanes. Added `LaneDecreaseWarningListener` which can be set on `Navigator` and `VisualNavigator` to receive `LaneDecreaseWarning` notifications. Note that this is a **beta** release of this feature.

4.26.0.0

2026-05-19

CHANGED

Deprecated `VehicleProfile`. Use `TransportSpecification` instead. Deprecated `VehicleType`. Use `TransportMode` instead. Deprecated `PedestrianProfile`. Use `TransportSpecification` instead.

4.26.0.0

2026-05-19

FIXED

Navigation: Fixed a crash in `VisualNavigator` that occurs when creating a route polyline from traffic spans with zero length.

4.26.0.0

2026-05-19

CHANGED

Map data: Removed the previously deprecated `PhysicalAttributes.isDividedRoad`. Use `PhysicalAttributes.divider` to get `RoadDivider` and `PhysicalAttributes.isMultiplyDigitized` for the multiply-digitized attribute instead.

4.26.0.0

2026-05-19

CHANGED

Search: Removed `SearchError.layersNotEnabled` error code as it is no longer applicable. Use `LayerConfigurationFeature.offlineSearchGlobal` instead to enable the new offline search algorithm (beta).

4.26.0.0

2026-05-19

CHANGED

Removed deprecated `BorderCrossingWarning.countryCode`, `BorderCrossingWarning.stateCode`, `BorderCrossingWarning.speedLimits`. This information is now accessible in `BorderCrossingWarning.administrativeRules`.

4.26.0.0

2026-05-19

ADDED

Offline search: Added a new improved algorithm for the `OfflineSearchEngine` for implicitly prefetched map content, in addition to downloaded regions. To activate the new behavior, include `LayerConfigurationFeature.offlineSearchGlobal` in both `SDKOptions.layerConfiguration.enabledFeatures` and `SDKOptions.layerConfiguration.implicitlyPrefetchedFeatures`. Note that this is a **beta** release of this feature.

4.26.0.0

2026-05-19

CHANGED

Offline maps: Changed the default layer configuration by removing `LayerConfigurationFeature.truck` from `SDKOptions.layerConfiguration.enabledFeatures`. By default, the `MapDownloader` no longer downloads offline truck routing/vehicle restriction data for map display. To preserve the previous behavior, configure custom values for `SDKOptions.layerConfiguration.enabledFeatures`.

4.26.0.0

2026-05-19

CHANGED

Offline maps: Changed the default layer configuration by removing `LayerConfigurationFeature.detailRendering`, `LayerConfigurationFeature.offlineSearch`, `LayerConfigurationFeature.offlineRouting`, `LayerConfigurationFeature.rendering` and `LayerConfigurationFeature.truck` from `SDKOptions.layerConfiguration.implicitlyPrefetchedFeatures`. By default, the HERE SDK no longer implicitly prefetches map content for offline search, offline routing, offline truck routing/vehicle restriction data for map display and detailed extruded buildings. To preserve the previous behavior, configure custom values for `SDKOptions.layerConfiguration.implicitlyPrefetchedFeatures`.

4.26.0.0

2026-05-19

FIXED

Navigation: Fixed map access issues in the `Navigator` caused by catalog changes/updates during initialization. These issues previously resulted in incorrect or missing map-matching, which prevented, for example, route deviations from being detected.

4.26.0.0

2026-05-19

ADDED

Map matcher: Added `LocationManager` for position updates and to provide the map-matched location using the `LocationManagerListener`. Added `MatchedLocationListener` to receive information when the current map-matched location has been updated. Note that this is a **beta** release of this feature.

4.26.0.0

2026-05-19

ADDED

Navigation: Added `locationManager` to `NavigatorInterface` to retrieve the `LocationManager` used by the `Navigator` for map-matched location processing. Note that this is a **beta** release of this feature.

4.26.0.0

2026-05-19

ADDED

Routing: Added class `IndoorSectionDetails` describing details of sections related to indoor routing. Added class `IndoorManeuverActions` containing supported types of actions for indoor routing. Added class `IndoorRoutePlace` representing a place for indoor routing.

4.26.0.0

2026-05-19

CHANGED

Routing: Removed `IndoorFeatures` (previously in venue routing). Use `IndoorLevelChangeFeatures` instead. Removed `IndoorLevelChangeAction`. Use `IndoorLevelChangeData` instead. Removed `IndoorManeuver` (from venue routing). Use `IndoorManeuver` (in routing) instead. Removed `IndoorSpaceAction`. Use `IndoorSpaceData` instead.

4.26.0.0

2026-05-19

CHANGED

Search: Removed the previously deprecated `PlaceCategory.sightsLandmarkAttaction`. Use `PlaceCategory.sightsLandmarkAttraction` instead.

4.26.0.0

2026-05-19

ADDED

Offline maps: Added property `InstalledRegion.lastUpdateTime` to show when the last update took place to the region installed in persistent map storage.

4.26.0.0

2026-05-19

ADDED

This version of the HERE SDK is delivered with map data v213 for the `CatalogType.optimizedClientMap` catalog and v94 for the `CatalogType.optimizedClientMapJapan` catalog.

4.26.0.0

2026-05-19

ADDED

Navigation: Added a new `laneDecrease` value to `WarningType` for use with the `WarnerEngine`. Added new `LaneDecreaseWarning`. Added `LaneDecreaseWarningOptions` to configure options. Added `laneDecreaseWarningOptions` to `WarningOptions`. Added `getLaneDecreaseWarning()` to `WarningsRegistry` to retrieve `LaneDecreaseWarning`. Note that this is a **beta** release of this feature.

4.26.0.0

2026-05-19

ADDED

Map view: Added `MapPolylineSolidMultiColorRepresentation` API allowing users to create multi-colored polylines. `DataAttributesAccessor` and `DataAttributeValue` now support values of `Color` type. Note that this is a **beta** release of this feature.

4.26.0.0

2026-05-19

ADDED

Positioning: On Android, added `vdrEnabled` to `SensorOptions` for controlling the VDR (Vehicle Dead Reckoning) usage with GNSS. Using this feature requires a separate license. Please contact us for more details, when you are interested.

4.26.0.0

2026-05-19

ADDED

Updated the supported Flutter version from 3.35.7 to 3.38.10 and the corresponding Dart version from 3.9.2 to 3.10.9. Therefore, with this release only **Flutter 3.38.10** and **Dart 3.10.9** are supported. Other versions may also work, but are not guaranteed to work. The next Flutter update is planned with HERE SDK 4.27.0.0.

4.26.0.0

2026-05-19

FIXED

Navigation: Fixed an issue where end-user `MapPolyline` objects were covered by the route added by `VisualNavigator`.

4.26.0.0

2026-05-19

ADDED

Routing: Added `RoutingEngine.refreshRouteWithRouteHandleAndRefreshRouteParameters(...)` method with a `RefreshRouteParameters` parameter to make parameters consistent.

4.26.0.0

2026-05-19

CHANGED

Routing: Deprecated `RoutingEngine.refreshRouteWithTraveledDistanceAndRoutingOptions(...)` and `RoutingEngine.refreshRouteWithRouteHandleAndRoutingOptions(...)`. Please use `RoutingEngine.refreshRouteWithRouteHandleAndRefreshRouteParameters(...)`.

4.26.0.0

2026-05-19

FIXED

Navigation: Fixed creation of the `ElectronicHorizon` and its usage in tracking mode at the start of `Navigator`.

4.26.0.0

2026-05-19

ADDED

Navigation: Added optional `commercialVehicleRegulations` property to `BorderCrossingWarning` providing vehicle-specific access restrictions, speed limits, and drive/rest regulations. Added `includeCommercialVehicleRegulations` option to `BorderCrossingWarningOptions` with default value `false`. Note that this is a **beta** release of this feature.

4.26.0.0

2026-05-19

ADDED

Offline routing: Added `OfflineRoutingEngine.refreshRouteWithRouteHandleAndRefreshRouteParameters(...)` method.

4.26.0.0

2026-05-19

ADDED

Navigation: Added `AdministrativeCommercialVehicleRules` and related types (`VehicleSpecificSpeedLimit`, `VehicleSpecificAccess`, `VehicleRestrictionCondition`, `RoadProfileCondition`, `VehicleProfileRestriction`, `DriveRestRegulation`, `CommercialVehicleRoadType`, `HazardousMaterialType`, `PhysicalStructure`, `VehicleTypeCondition`) to provide vehicle-specific access restrictions, speed limits, and drive/rest regulations when crossing into a new administrative region. This information is available through the `BorderCrossingWarning.commercialVehicleRegulations` field. Added `AdministrativeRules.adminContextId` and `AdministrativeRules.parentAdminContextIds` to support loading of commercial vehicle regulations (CVR) data. Note that this is a **beta** release of this feature.

4.26.0.0

2026-05-19

FIXED

Navigation: Fixed an issue in route progress visualization that could occur when `VisualNavigator` received outdated or invalid `TrafficOnRoute` data.

4.26.0.0

2026-05-19

FIXED

Navigation: Fixed an issue in map matching that could occur when nearby roads had inaccurate elevation data.

4.26.0.0

2026-05-19

FIXED

Navigation: Fixed a data race condition in the `Navigator` implementation that could cause a crash when notifying warnings, such as `RealisticViewWarning`.

4.26.0.0

2026-05-19

FIXED

Navigation: Fixed an issue where turn-by-turn maneuver instructions were incorrectly suppressed at complex intersections with multiple exit options and non-straight configuration.

4.26.0.0

2026-05-19

FIXED

Navigation: Fixed a memory leak caused by improper listener cleanup in `Navigator` and `VisualNavigator` when `RealisticViewWarning` was active.

4.26.0.0

2026-05-19

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.26.0.0

2026-05-19

KNOWN ISSUE

Navigation: When a `Route` contains a ferry `Section`, then false positive route deviations may be reported within that `Section`.

4.25.5.0

2026-04-14

ADDED

Routing: Added `VehicleSpecification.emptyWeightInKilograms` to calculate routes based on the vehicle's empty weight. If no route can be found, `VehicleRestrictionMaxWeightType.empty` is set, and `VehicleRestrictionMaxWeight.valueInKilograms` contains the maximum allowed empty weight.

4.25.5.0

2026-04-14

ADDED

Map view: Added `MapCamera.setFarPlaneConfiguration()` and `MapCamera.FarPlaneConfiguration` to override the far-plane distance per zoom level, with linear interpolation between zoom levels.

4.25.5.0

2026-04-14

CHANGED

Navigation: Renamed `cropRectangle` to `viewRectangle` in `AreaCameraBehavior`. Renamed `maxZoomLevel` to `maxZoom` and changed its type from `Double` to `MapMeasure` in `AreaCameraBehavior`. Replaced the `visiblePoints` property with `setVisiblePoints()` and `getVisiblePoints()` methods in `AreaCameraBehavior`. The class is still released as **beta**.

4.25.5.0

2026-04-14

CHANGED

Map view: Renamed `MapContext.setMemoryManagementOptions(MemoryManagementOptions, SetVideoMemoryLimitCallback)` and the callback `MapContextSetVideoMemoryLimitCallback(int)`. Use `MapContext.setMemoryManagementOptions(MemoryManagementOptions, MapContextSetMemoryManagementOptionsCallback)` and the callback `MapContextSetMemoryManagementOptionsCallback(MemoryManagementResult)` instead. Added the new enum `MapContext.MemoryManagementResultCode` and the new struct `MapContext.MemoryManagementResult`. Note that this feature is released as **beta** and may contain bugs or unexpected behavior. Related APIs may change in future releases without a deprecation process.

4.25.5.0

2026-04-14

ADDED

Routing: Added `ChargingConnectorType.SAE_J3400` to support the SAE J3400 connector type for the North American Charging Standard (NACS).

4.25.5.0

2026-04-14

CHANGED

Routing: Deprecated `ChargingConnectorType.TESLA`. Use `ChargingConnectorType.SAE_J3400` instead.

4.25.5.0

2026-04-14

CHANGED

Refactored `ElectronicHorizonErrorCode` to distinguish electronic horizon engine errors from position errors. Added `ElectronicHorizonDataLoaderErrorCode` and updated `ElectronicHorizonDataLoaderResult.errorCode` to use the new enum.

4.25.5.0

2026-04-14

ADDED

Map view: Added `MapScene.addMapPolygons(...)`, `MapScene.removeMapPolygons(...)`, and `MapScene.removeAllMapPolygons(...)` to add and remove collections of map polygons.

4.25.5.0

2026-04-14

ADDED

Map view: Added `MapScene.addMapMarkers3d(...)`, `MapScene.removeMapMarkers3d(...)`, and `MapScene.removeAllMapMarkers3d(...)` to add and remove collections of 3D map markers.

4.25.5.0

2026-04-14

CHANGED

Map data: Deprecated `TollCost.vehicleProfiles`. Use `TollCost.transportSpecifications` instead.

4.25.5.0

2026-04-14

ADDED

This version of the HERE SDK is delivered with map data v210 for the `CatalogType.optimizedClientMap` catalog and v94 for the `CatalogType.optimizedClientMapJapan` catalog.

4.25.5.0

2026-04-14

ADDED

Map view: Added `MapScene.removeAllMapPolylines(...)` to remove all map polylines from the scene.

4.25.5.0

2026-04-14

ADDED

We have released a new version of the [HERE SDK Reference Application](https://github.com/heremaps/here-sdk-ref-app-flutter). With version [1.17.0](https://github.com/heremaps/here-sdk-ref-app-flutter/releases/tag/1.17.0), we added support for the HERE SDK 4.25.0.0, updated applicable app dependencies, and included various improvements.

4.25.5.0

2026-04-14

CHANGED

Deprecated `BusSpecifications`, `CarSpecifications`, and `TruckSpecifications`. Use `TransportSpecification` instead.

4.25.5.0

2026-04-14

CHANGED

Navigation: Changed zoom-related fields in `TrackingCameraBehavior.SpeedThreshold`, `FunctionalRoadClassZoomPolicyOptions`, and `ManeuverZoomRange` from `Double` to `MapMeasure`. Renamed `SpeedThreshold.zoomLevel` to `zoom`, `FunctionalRoadClassZoomPolicyOptions.defaultZoomLevel` to `defaultZoom`, `functionalRoadClassToZoomLevel` to `functionalRoadClassToZoom`, and `cropRectangle` to `viewRectangle`. Replaced the `maneuverModeConfiguration` property with `setManeuverModeConfiguration()` and `getManeuverModeConfiguration()` methods. Note that this class is still released as **beta**.

4.25.5.0

2026-04-14

FIXED

Navigation: Corrected `FixedCameraBehavior` so that `MapMeasure.Kind.scale` is no longer supported.

4.25.5.0

2026-04-14

ADDED

Map view: Added `MapScene.removeAllMapMarkers(...)` to remove all map markers from the scene.

4.25.5.0

2026-04-14

FIXED

Navigation: Corrected `SpeedBasedCameraBehavior.ProfileValue.zoom` so that `MapMeasure.Kind.scale` is no longer supported.

4.25.5.0

2026-04-14

CHANGED

Navigation: Corrected `AreaCameraBehavior.maxZoom` so that `MapMeasure.Kind.scale` is no longer supported. Note that the class is still released as **beta**.

4.25.5.0

2026-04-14

CHANGED

Deprecated the `TransportProfile` class. Use `TransportSpecification` instead.

4.25.5.0

2026-04-14

CHANGED

Navigation: Deprecated `NavigatorInterface.trackingTransportProfile`. Use `NavigatorInterface.trackingTransportSpecification` instead.

4.25.5.0

2026-04-14

ADDED

Navigation: Added `NavigatorInterface.trackingTransportSpecification` to define the vehicle properties for the `Navigator` when no route is present.

4.25.5.0

2026-04-14

ADDED

Navigation: Added the static methods `defaultFunctionalRoadClassZoomPolicyOptions()`, `defaultSpeedBasedZoomPolicyOptions()`, and `defaultManeuverModeConfiguration()` to `TrackingCameraBehavior`. This is a **beta** feature.

4.25.5.0

2026-04-14

FIXED

Navigation: Fixed an issue where the route and maneuver arrows could sometimes disappear in multi-display setups with multiple `VisualNavigator` instances.

4.25.5.0

2026-04-14

CHANGED

**Upcoming breaking change for offline maps:** HERE SDK 4.26.0.0 will contain changes to the default layer configuration. `OFFLINE_SEARCH`, `OFFLINE_ROUTING`, and `TRUCK` will be removed from `SDKOptions.layerConfiguration.implicitlyPrefetchedFeatures`, and `TRUCK` will be removed from `SDKOptions.layerConfiguration.enabledFeatures`. By default, the SDK will no longer implicitly prefetch map content for offline search, offline routing, and offline truck routing, and `MapDownloader` will no longer download offline truck routing content. If you need to preserve the previous behavior, configure a custom `SDKOptions.layerConfiguration.implicitlyPrefetchedFeatures`.

4.25.5.0

2026-04-14

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.25.5.0

2026-04-14

KNOWN ISSUE

Navigation: When a `Route` contains a ferry `Section`, then false positive route deviations may be reported within that `Section`.

4.25.4.0

2026-03-10

CHANGED

Map view: For several map schemes, landmarks are now enabled, by default. On top, terrain is now enabled for topo map schemes, by default. An overview of the new [default map features and map feature modes per map scheme](https://www.here.com/docs/bundle/style-editor-user-guide/page/topics/carto/features-and-modes.html#default-features-and-modes-per-map-scheme) can be seen in the HERE Style Editor documentation. The detailed changes for this release: `MapFeatures.landmarks` is enabled for and set to `MapFeatureModes.landmarksTextureless` mode for `MapScheme.liteDay` and `MapScheme.liteNight` map schemes. `MapFeatures.landmarks` is enabled for and set to `MapFeatureModes.landmarksGrayscale` mode for `MapScheme.normalDay`, `MapScheme.normalNight`, `MapScheme.logisticsDay`, `MapScheme.logisticsNight`, `MapScheme.topoDay`, `MapScheme.topoNight` map schemes. `MapFeatures.terrain` is enabled and set to `MapFeatureModes.terrainHillshade` mode for `MapScheme.topoDay`, `MapScheme.topoNight` map schemes. This change has performance implications, with additional data consumption and impact on rendering frame rate. Note that terrain data is not enabled by default for offline maps and will not be displayed in offline mode unless specifically enabled. See `SDKOptions.layerConfiguration` for more details. Note that you can disable undesired map features when loading a map scheme as described in the [Developer Guide](https://www.here.com/docs/bundle/sdk-for-flutter-developer-guide/page/topics/map-features.html).

4.25.4.0

2026-03-10

ADDED

Routing: Added `VehicleSpecification.kingpinToRearAxleDistanceInCentimeters` to calculate routes that support this kingpin to rear axle distance. In case no route can be found the `ViolatedRestriction.details.maxKingpinToRearAxleDistanceInCentimeters` contains the max distance.

4.25.4.0

2026-03-10

CHANGED

Renamed `ElectronicHorizonPathPosition` to `ElectronicHorizonPosition`. Note that this is a **beta** release of this feature.

4.25.4.0

2026-03-10

CHANGED

Renamed `ElectronicHorizonPathSegment` to `ElectronicHorizonSegment`. Note that this is a **beta** release of this feature.

4.25.4.0

2026-03-10

CHANGED

Renamed `ElectronicHorizonPathSegmentId` to `ElectronicHorizonSegmentId`. Note that this is a **beta** release of this feature.

4.25.4.0

2026-03-10

CHANGED

Removed `ElectronicHorizonPositionListener` interface. Position updates are now delivered through the unified `ElectronicHorizonListener.onElectronicHorizonUpdated()` with optional error code and update parameters. The `ElectronicHorizonUpdate` has been restructured to include an optional `ElectronicHorizon` struct containing full predicted paths, an optional `ElectronicHorizonSegmentChanges` struct for incremental segment tracking, and a required `position` field for the current vehicle position. Renamed fields for clarity: `electronicHorizonPaths` to `electronicHorizon.paths`, and `addedSegments`/`removedSegmentIds` to `segmentChanges.added`/`segmentChanges.removedIds`.

4.25.4.0

2026-03-10

CHANGED

Routing: Deprecated `BicycleOptions` class. Use the `RoutingOptions` class instead. Deprecated `BusOptions` class. Use the `RoutingOptions` class instead. Deprecated `CarOptions` class. Use the `RoutingOptions` class instead. Deprecated `EVCarOptions` class. Use the `RoutingOptions` class instead. Deprecated `EVTruckOptions` class. Use the `RoutingOptions` class instead. Deprecated `PedestrianOptions` class. Use the `RoutingOptions` class instead. Deprecated `PrivateBusOptions` class. Use the `RoutingOptions` class instead. Deprecated `ScooterOptions` class. Use the `RoutingOptions` class instead. Deprecated `TaxiOptions` class. Use the `RoutingOptions` class instead. Deprecated `TruckOptions` class. Use the `RoutingOptions` class instead.

4.25.4.0

2026-03-10

CHANGED

Routing: Deprecated `IsolineOptions.withCarOptions`. Use the `IsolineOptions.withRoutingOptions` instead. Deprecated `IsolineOptions.withTruckOptions`. Use the `IsolineOptions.withRoutingOptions` instead. Deprecated `IsolineOptions.withEVCarOptions`. Use the `IsolineOptions.withRoutingOptions` instead. Deprecated `IsolineOptions.withEVTruckOptions`. Use the `IsolineOptions.withRoutingOptions` instead. Deprecated `IsolineOptions.carOptions`. Use the `IsolineOptions.routingOptions` instead. Deprecated `IsolineOptions.truckOptions`. Use the `IsolineOptions.routingOptions` instead. Deprecated `IsolineOptions.evCarOptions`. Use the `IsolineOptions.routingOptions` instead. Deprecated `IsolineOptions.evTruckOptions`. Use the `IsolineOptions.routingOptions` instead.

4.25.4.0

2026-03-10

CHANGED

Map view: Improved the default map feature mode for road exit labels: The `MapFeatures.roadExitLabels` default enabled mode changed from `roadExitLabelsNumbersOnly` to `MapFeatureModes.roadExitLabelsAll` mode for `MapScheme.logisticsDay`, `MapScheme.logisticsNight`, `MapScheme.logisticsHybridDay`, `MapScheme.logisticsHybridNight` map schemes. For other map schemes, `roadExitLabelsNumbersOnly` will stay as the default feature mode. An overview of the new [default map features and map feature modes per map scheme](https://www.here.com/docs/bundle/style-editor-user-guide/page/topics/carto/features-and-modes.html#default-features-and-modes-per-map-scheme) can be seen in the HERE Style Editor documentation.

4.25.4.0

2026-03-10

CHANGED

Map view: Added `LayerConfigurationFeature.landmarks3d` to the list of default enabled features for `LayerConfiguration.enabledFeatures`, as the landmark `MapFeature` is now enabled by default for most non-hybrid schemes.

4.25.4.0

2026-03-10

CHANGED

Removed `ElectronicHorizonPaths` typealias. Note that `ElectronicHorizon` is still a **beta** release.

4.25.4.0

2026-03-10

ADDED

This version of the HERE SDK is delivered with map data v207 for `CatalogType.optimizedClientMap` catalog and v92 for `CatalogType.optimizedClientMapJapan` catalog.

4.25.4.0

2026-03-10

CHANGED

Navigation: Deprecated `FixedCameraBehavior.cameraDistanceInMeters`. Use `FixedCameraBehavior.zoom` instead.

4.25.4.0

2026-03-10

ADDED

Navigation: Added `FixedCameraBehavior.zoom` to align with other camera behavior classes.

4.25.4.0

2026-03-10

ADDED

Search: Added `EVChargingLocation.supportPhoneNumber` for the phone number that EV drivers should call when they need assistance at the charge location.

4.25.4.0

2026-03-10

CHANGED

Routing: Deprecated `TruckType` class. Use the `TruckCategory` class instead. Deprecated `VehicleSpecification.truckType`. Use the `VehicleSpecification.truckCategory` instead.

4.25.4.0

2026-03-10

ADDED

Search: Added `EVChargingLocation.timeZone` for the time zone of the charging location and `EVChargingConnector.tariffIndexes` for the tariff indexes of the charging location.

4.25.4.0

2026-03-10

FIXED

Navigation: A U-turn maneuver is now generated for some particular U-turn cases involving a road name change.

4.25.4.0

2026-03-10

FIXED

Navigation: Fixed navigation jumps or flaky heading when at slow speed or stopped.

4.25.4.0

2026-03-10

FIXED

Navigation: Fixed unnecessary redrawing in `VisualNavigator` that happens when location and camera pose remain unchanged.

4.25.4.0

2026-03-10

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.25.4.0

2026-03-10

KNOWN ISSUE

Navigation: When a `Route` contains a ferry `Section`, then false positive route deviations may be reported within that `Section`.

4.25.3.0

2026-02-19

ADDED

Map view: Added following functions to `MapContext`, `MapContext.getMemoryManagementOptions()`, `MapContext.setMemoryManagementOptions(MemoryManagementOptions,MapContextSetVideoMemoryLimitCallback)`, and lambda `MapContext.MapContextSetVideoMemoryLimitCallback(int)`. Added struct `MapContext.MemoryManagementOptions`. Added the enum `MapContext.MemoryManagementStrategy`.
Note: This is a **beta** release of this feature, so there could be a few bugs and unexpected behaviors. Related APIs may change for new releases without a deprecation process.

4.25.3.0

2026-02-19

CHANGED

Deprecated method `LockingProcess.getLockingProcessId(SDKOptions)`. Use `LockingProcess.getLlockingProcessId(AndroidContext, SDKOptions)` instead. Deprecated method `LockingProcess.destroyLockingProcess(SDKOptions, Long)`. Please use `LockingProcess.destroyLockingProcess(AndroidContext, SDKOptions, Long)` instead.

4.25.3.0

2026-02-19

CHANGED

Routing: Deprecated `route.calculationOptions(...)`. Use `RoutingOptions` instead. Deprecated `RefreshRouteOptions` and `RefreshRouteOptionsData` use the `RoutingOptions` class from the `route` object instead.

4.25.3.0

2026-02-19

CHANGED

Navigation: `ZoomPolicy` of `TrackingCameraBehavior` converted from abstract class to class. The API is still in **beta** status.

4.25.3.0

2026-02-19

ADDED

This version of the HERE SDK is delivered with map data v206 for `CatalogType.optimizedClientMap` catalog and v91 for `CatalogType.optimizedClientMapJapan` catalog.

4.25.3.0

2026-02-19

FIXED

Navigation: Corrected implementation of setting fixed bearing in `TrackingCameraBehavior`.

4.25.3.0

2026-02-19

CHANGED

Renamed `ElectronicHorizon` to `ElectronicHorizonEngine`. The API is still in **beta** status.

4.25.3.0

2026-02-19

ADDED

Routing: Removed **beta** status for `RoutingOptions`, `RoutingInterface.calculateRouteWithRoutingOptions(...)`, `Route.routingOptions` and `RoutingEngine.refreshRouteWithTraveledDistanceAndRoutingOptions(...)`, `RoutingEngine.refreshRouteWithRouteHandleAndRoutingOptions(...)`, `RoutingEngine.importRouteWithRoutingOptions(...)`, `RoutingEngine.importRouteWithStopsAndRoutingOptions(...)`, `RoutingEngine.importRouteFromHandleWithRoutingOptions(...)`. The APIs are considered to be stable.

4.25.3.0

2026-02-19

ADDED

Offline routing: Removed **beta** status for `OfflineRoutingEngine.importFromHandleWithRoutingOptions(...)`. The API is now considered to be stable.

4.25.3.0

2026-02-19

ADDED

Offline search: Added `EVChargingStation.physicalReference` for visual identification of EVSE, available only for offline search.

4.25.3.0

2026-02-19

FIXED

Navigation: Fixed a crash caused by undefined behavior when a user-provided `DynamicRoutingListener` invoked `dynamicRoutingEngine.stop()` inside the `onBetterRouteFound(...)` callback.

4.25.3.0

2026-02-19

ADDED

Added helper method `TruckRestrictionWarning.isGeneral()` to identify general truck restrictions.

4.25.3.0

2026-02-19

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.25.3.0

2026-02-19

KNOWN ISSUE

Navigation: When a `Route` contains a ferry `Section`, then false positive route deviations may be reported within that `Section`.

4.25.2.0

2026-02-06

FIXED

Offline maps: Applying a feature configuration no longer causes the `MapDownloader` to report an inaccurate size for a `Region`. This was a size reporting issue only and did not impact the actual size of the data stored on disk.

4.25.2.0

2026-02-06

FIXED

Navigation: Fixed `TollStopWarningListener` not sending events when close to a toll station in Brazil.

4.25.2.0

2026-02-06

ADDED

Routing: Added information about multi-travel pass characteristics to `TollFare` interface for online-routing.

4.25.2.0

2026-02-06

CHANGED

Removed `VehicleSpecification.CarBuilder.withTruckCategory()`, `VehicleSpecification.CarBuilder.withIsTruckLight()`, `VehicleSpecification.CarBuilder.withWeightPerAxleGroup()`, `VehicleSpecification.CarBuilder.withHazardousMaterials()`. Removed `VehicleSpecification.TaxiBuilder.withTruckCategory()`, `VehicleSpecification.TaxiBuilder.withIsTruckLight()`, `VehicleSpecification.TaxiBuilder.withWeightPerAxleGroup()`, `VehicleSpecification.TaxiBuilder.withHazardousMaterials()`. Removed `VehicleSpecification.BusBuilder.withTruckCategory()`, `VehicleSpecification.BusBuilder.withIsTruckLight()`, `VehicleSpecification.BusBuilder.withHazardousMaterials()`. Removed `VehicleSpecification.PrivateBusBuilder.withTruckCategory()`, `VehicleSpecification.PrivateBusBuilder.withIsTruckLight()`, `VehicleSpecification.PrivateBusBuilder.withHazardousMaterials()`. The class `VehicleSpecification` is marked as **beta**, so no deprecation process is necessary.

4.25.2.0

2026-02-06

ADDED

Indoor map: Added `VenueModel.geometries` for fetching all the geometries of Venue.

4.25.2.0

2026-02-06

ADDED

Navigation: Added new constructors to `VisualNavigator` allowing to pass instance of `NavigatorInterface`.

4.25.2.0

2026-02-06

FIXED

Navigation: Fixed an issue where route suggestions from `DynamicRoutingEngine` started from the first waypoint of the original route instead of the current position.

4.25.2.0

2026-02-06

ADDED

This version of the HERE SDK is delivered with map data v205 for `CatalogType.optimizedClientMap` catalog and v90 for `CatalogType.optimizedClientMapJapan` catalog.

4.25.2.0

2026-02-06

ADDED

Routing: Added `fromDefaultParameterConfiguration()` static function to `RoutingOptions`, which constructs a `RoutingOptions` object with the transport specifications taken from `SDKNativeEngine.parameterConfig.transportSpecification`. Note: This is a **beta** release of this feature. There could be a few bugs and unexpected behaviors. Related APIs may change for new releases without a deprecation process.

4.25.2.0

2026-02-06

CHANGED

Routing: Deprecated `RoutingEngine.importCarRoute(...)`, `RoutingEngine.importPedestrianRoute(...)`, `RoutingEngine.importBicycleRoute(...)`, `RoutingEngine.importTruckRoute(...)`, `RoutingEngine.importTaxiRoute(...)`, `RoutingEngine.importScooterRoute(...)`, `RoutingEngine.importBusRoute(...)`, `RoutingEngine.importPrivateBusRoute(...)`, `RoutingEngine.importEVCarRoute(...)`, `RoutingEngine.importEVTruckRoute()` methods. Use the `RoutingEngine.importRouteWithRoutingOptions(...)` method instead. Deprecated `RoutingEngine.importCarRouteWithStops(...)`, `RoutingEngine.importPedestrianRouteWithStops(...)`, `RoutingEngine.importBicycleRouteWithStops(...)`, `RoutingEngine.importTruckRouteWithStops(...)`, `RoutingEngine.importTaxiRouteWithStops(...)`, `RoutingEngine.importScooterRouteWithStops(...)`, `RoutingEngine.importBusRouteWithStops(...)`, `RoutingEngine.importPrivateBusRouteWithStops(...)`, `RoutingEngine.importEVCarRouteWithStops(...), `RoutingEngine.importEVTruckRouteWithStops(...)` methods. Use the `RoutingEngine.importRouteWithStopsAndRoutingOptions(...)` method instead. Deprecated `RoutingEngine.importRouteFromHandle(...)` method. Use the `RoutingEngine.importRouteFromHandleWithRoutingOptions` method instead. Note: The suggested methods are still marked as **beta**, but the APIs are already considered stable, and we plan to move them out of beta in the next release.

4.25.2.0

2026-02-06

ADDED

Navigation: Added the following classes and methods to `TrackingCameraBehavior`: `TrackingCameraBehavior.maneuverDetectionEnabled`: property to enable/disable maneuver detection. `TrackingCameraBehavior.maneuverModeConfiguration`: property holding the maneuver mode configuration. `ManeuverModeConfiguration`: contains an array of `ManeuverRule` objects as well as a bearing threshold. The current context (road class, next maneuver, and previous maneuver) will be matched against each `ManeuverRule` in sequence; it will act according to the first positive match. If there is no match, the camera will not react at all. The bearing threshold defines the maximum allowable angle between the current bearing and the bearing to the next maneuver; if the actual angle is greater, the camera will not turn to face the next maneuver. `ManeuverRule`: contains an array of `FunctionalRoadClass` objects, an array of `ManeuverAction` objects, and an optional `ManeuverRuleOptions`. The rule will be considered a match if two conditions are met. First, the current road class is in the `FunctionalRoadClass` array and an adjacent maneuver's `ManeuverAction` is within the `ManeuverAction` array. If either array is empty, it implies that the rule is applicable to all variants of those objects. Second, the current position is within the relevant threshold of `ManeuverRuleOptions`. If `ManeuverRuleOptions` is `null`, it means that the camera should not react at all. In this case, it will not check any subsequent rules for a match. `ManeuverRuleOptions`: contains `earlyPreManeuverActivationThresholdInMeters`, `preManeuverActivationThresholdInMeters`, `postManeuverActivationThresholdInMeters`, and `ManeuverZoomRange`. If the current position is within `preManeuverActivationThresholdInMeters` before the next maneuver, it will react to that maneuver, assuming there was a `ManeuverRule` match. If the current position is within `postManeuverActivationThresholdInMeters` of the previous maneuver, it will react to that maneuver. If both are true, it will prefer to react to the next maneuver rather than the previous one. Finally, if the current position enters within `earlyPreManeuverActivationThresholdInMeters` of the next maneuver while still within `postManeuverActivationThresholdInMeters` of the previous maneuver, it will ignore the previous maneuver and react to the next maneuver until it has been passed, even if the current position wasn't within `preManeuverActivationThresholdInMeters` of the next maneuver. `ManeuverZoomRange` defines the zoom range to which the camera must adhere when reacting to a maneuver. `ManeuverZoomRange`: contains `minZoom` and `maxZoom`. This update adds a maneuver mode to `TrackingCameraBehavior`, a new feature that allows `TrackingCameraBehavior` to highlight/focus on proximate maneuvers using a configurable set of rules (`ManeuverModeConfiguration`) that define for which maneuvers and at what distances it should activate. Note: This is a **beta** release of this feature. There could be a few bugs and unexpected behaviors. Related APIs may change in new releases without a deprecation process.

4.25.2.0

2026-02-06

CHANGED

Routing: Deprecated `RoutingInterface.calculateCarRoute(...)`, `RoutingInterface.calculatePedestrianRoute(...)`, `RoutingInterface.calculateBicycleRoute(...)`, `RoutingInterface.calculateScooterRoute(...)`, `RoutingInterface.calculateTruckRoute(...)`, `RoutingInterface.calculateTaxiRoute(...)`, `RoutingInterface.calculateBusRoute(...)`, `RoutingInterface.calculatePrivateBusRoute(...)`, `RoutingInterface.calculateEVCarRoute(...)`, `RoutingInterface.calculateEVTruckRoute(...)` methods. Use the `RoutingInterface.calculateRouteWithRoutingOptions(...)` method instead. Note: The suggested methods are still marked as **beta**, but the APIs are already considered stable, and we plan to move them out of beta in the next release.

4.25.2.0

2026-02-06

CHANGED

Routing: Deprecated `RoutingEngine.refreshRoute(...)` method with `RefreshRouteOptions` as parameter. Use the `RoutingEngine.refreshRoute(...)` method with `RoutingOptions` parameter instead. Deprecated `RoutingEngine.refreshRouteWithTraveledDistance(...)` method. Use the `RoutingEngine.refreshRouteWithTraveledDistanceAndRoutingOptions(...)` method instead. Note: The suggested methods are still marked as **beta**, but the APIs are already considered stable, and we plan to move them out of beta in the next release.

4.25.2.0

2026-02-06

CHANGED

Offline routing: Deprecated `OfflineRoutingEngine.importFromHandle(...)` method. Use the `OfflineRoutingEngine.importFromHandleWithRoutingOptions(...)` method instead. Note: The suggested methods are still marked as **beta**, but the APIs are already considered stable, and we plan to move them out of beta in the next release.

4.25.2.0

2026-02-06

CHANGED

Navigation: Deprecated `DynamicRoutingEngine.startWithWaypoints(...)` method. Use the `DynamicRoutingEngine.startWithWaypointsAndRoutingOptions(...)` method instead. Note: The suggested methods are still marked as **beta**, but the APIs are already considered stable, and we plan to move them out of beta in the next release.

4.25.2.0

2026-02-06

CHANGED

Navigation: Deprecated `ManeuverNotificationOptions.enableDestinationReachedNotification` for generating arrival (stopover and destination) voice notification. Use the `ManeuverNotificationOptions.arrivalNotificationOption` attribute instead.

4.25.2.0

2026-02-06

ADDED

Navigation: Added `arrivalNotificationOption` to `ManeuverNotificationOption` for configuring arrival voice notifications with a new enum type `ArrivalNotificationOption`: `none`, `destinationOnly`, `stopoverOnly`, and `both`.

4.25.2.0

2026-02-06

CHANGED

Removed the previously deprecated `ExternalMapDataSource`. Please use the `ExternalMapDataSourceClient` and `ExternalMapDataSourceServer` classes instead.

4.25.2.0

2026-02-06

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.25.2.0

2026-02-06

KNOWN ISSUE

Navigation: When a `Route` contains a ferry `Section`, then false positive route deviations may be reported within that `Section`.

4.25.1.0

2026-01-20

ADDED

Map view: Added the following new classes and methods: `MapSceneLoadOptions`: Represents the complete configuration for loading a map scene, combining the scene source (`MapScheme` or `configurationFile`) and optional settings like `enabledFeatures`, `disabledFeatures`, `watermarkStyle`, and `overridingMapStyle`. Added `MapSceneLoadOptionsBuilder`: Builder class for creating `MapSceneLoadOptions` instances. The builder enforces that exactly one `mapScheme` or `configurationFile` is set. Added `MapScene.loadSceneWithOptions(MapSceneLoadOptions, MapSceneLoadSceneCallback)`: Asynchronously loads a map scene using `MapSceneLoadOptions`. This unified API supports loading from either a map scheme or configuration file, with optional feature and watermark configuration. This update introduces a new unified API to load scenes with a builder pattern that provides a cleaner, more type-safe way to load map scenes. The builder enforces mutual exclusivity between `mapScheme` and `configurationFile` at build time. Note: This is a **beta** release of this feature. There could be a few bugs and unexpected behaviors. Related APIs may change for new releases without a deprecation process.

4.25.1.0

2026-01-20

ADDED

Navigation: Added `FunctionalRoadClassZoomPolicyOptions`, a configuration used to instantiate a zoom policy based on functional road classes. Added `SpeedBasedZoomPolicyOptions`, a configuration used to instantiate a zoom policy driven by speed thresholds. Added `makeSpeedBasedZoomPolicy` to `ZoomPolicy`, enabling creation and use of the newly introduced speed-based zoom policy using `SpeedBasedZoomPolicyOptions`. Added `makeFunctionalRoadClassZoomPolicy` to `ZoomPolicy`, enabling creation and use of the newly introduced functional-road-class zoom policy using `FunctionalRoadClassZoomPolicyOptions`. Added `RoadClassification`, defining the driving environment as one of: `urban`, `rural`, or `highway`.

4.25.1.0

2026-01-20

ADDED

Search: Added support for `SearchOptions.distributedResults` in `SearchEngine`, that indicates if search along the route should produce well-distributed results.

4.25.1.0

2026-01-20

CHANGED

Removed unused dependency to the `url_launcher` plugin.

4.25.1.0

2026-01-20

CHANGED

Navigation: Moved `ZoomPolicy` to `TrackingCameraBehavior` as part of the `TrackingCameraBehavior`. Removed `FixedZoomPolicy` as a public type. Its functionality is now provided through the `ZoomPolicy.makeFixedZoomPolicy` static function.

4.25.1.0

2026-01-20

ADDED

Navigation: Added `isBuiltUpArea` flag in `RoadAttributes`, indicating if the navigable segment is inside a built-up area.

4.25.1.0

2026-01-20

ADDED

Added `PedestrianSpecification`, `ScooterSpecification`, `TaxiSpecification` classes, containing attributes for pedestrian, scooter and taxi profiles. Added `TransportSpecification` class which contains all attributes for a transport mode (vehicle, pedestrian, scooter and taxi).

4.25.1.0

2026-01-20

CHANGED

Removed `VehicleSpecification.allowDriveThroughTaxiRoads`. The property was moved to `TaxiSpecification.allowDriveThroughTaxiRoads`. Removed `VehicleSpecification.allowScooterOnHighway`. The property was moved to `ScooterSpecification.allowScooterOnHighway`.

4.25.1.0

2026-01-20

CHANGED

Routing: Removed `RoutingOptions.transportMode`. It is replaced with `RoutingOptions.transportSpecification.transportMode`. Removed `RoutingOptions.occupantsNumber`. It is replaced with `RoutingOptions.transportSpecification.vehicleSpecification.occupancy`. Removed `RoutingOptions.vehicle`. It is replaced with `RoutingOptions.transportSpecification.vehicleSpecification`. Removed `TransportedCargo` and `RoutingOptions.transportedCargo`. All the fields of `TransportedCargo` were moved to `VehicleSpecification`. Removed `RoutingOptions.walkSpeedInMetersPerSecond`. It is replaced with `RoutingOptions.transportSpecification.pedestrianSpecification.walkingSpeedInMetersPerSecond`.

4.25.1.0

2026-01-20

ADDED

Routing: Added `RoutingOptions.transportSpecification` which will include the transport mode and the vehicle, pedestrian, scooter and taxi specification.

4.25.1.0

2026-01-20

ADDED

Map view: Added `MapFeatures.trafficLights` and `MapFeatureModes.trafficLightsAll` to show traffic lights.

4.25.1.0

2026-01-20

CHANGED

Routing: Removed `RoutingOptions.commonRouteOptions`. All its members were moved to `RoutingOptions`. The class `RoutingOptions` is marked as **beta**, so no deprecation process is necessary. Removed `CommonRouteOptions` class. All its members were moved to the `RoutingOptions` class. The class `CommonRouteOptions` was marked as **beta**, so no deprecation process is necessary.

4.25.1.0

2026-01-20

ADDED

Routing: Added `RoutingOptions.routeOptions` which specifies the common route calculation options. This attribute was moved from `CommonRouteOptions` class, which was removed. Added `RoutingOptions.textOptions` which configures the textual content returned from the route calculation, such as localization, format, and unit system. This attribute was moved from `CommonRouteOptions` class, which was removed. Added `RoutingOptions.avoidanceOptions` which specifies the restrictions for route calculations. This attribute was moved from `CommonRouteOptions` class, which was removed. Added `RoutingOptions.allowOptions` which specifies the options explicitly allowed by user for route calculations. This attribute was moved from `CommonRouteOptions` class, which was removed. Added `RoutingOptions.tollOptions` which specifies how the tolls should be calculated, such as transponders, vehicle category, and emission type. This attribute was moved from `CommonRouteOptions` class, which was removed. Added `RoutingOptions.maxSpeedOnSegments` which specifies segments with restriction on maximum base speed expressed in meters per second. This attribute was moved from `CommonRouteOptions` class, which was removed.

4.25.1.0

2026-01-20

ADDED

Map view: Added `MapContentSettings.configureVehicleRestrictionFilterWithTransportSpecification(TransportSpecification)` method to filter restrictions shown on the map and to easily match the filtering to routing parameters.

4.25.1.0

2026-01-20

CHANGED

Map view: Deprecated `MapContentSettings.configureVehicleRestrictionFilter(TransportMode, TruckSpecifications, List?, TunnelCategory?)` method, use `MapContentSettings.configureVehicleRestrictionFilterWithTransportSpecification(TransportSpecification)` instead.

4.25.1.0

2026-01-20

ADDED

Added `SDKOptions.customOptions` property to set the maximum thread count for selected HERE SDK components. Note: This is a **beta** release of this feature. There could be a few bugs and unexpected behaviors. Related APIs may change for new releases without a deprecation process.

4.25.1.0

2026-01-20

FIXED

Navigation: Fixed GNSS accuracy detection logic to ensure tunnel extrapolation activates correctly when location signals are unreliable.

4.25.1.0

2026-01-20

CHANGED

Removed `ParameterSpecification.Pedestrian` class. The class was replaced by `PedestrianSpecification`. The class `ParameterSpecification` is marked as **beta**, so no deprecation process is necessary. Removed `ParameterSpecification.pedestrian`. The property was replaced with to `ParameterSpecification.transportSpecification.pedestrianSpecification`. The class `ParameterSpecification` is marked as **beta**, so no deprecation process is necessary. Removed `ParameterSpecification.vehicleProfile`. The property was replaced with to `ParameterSpecification.transportSpecification.vehicleSpecification`. The class `ParameterSpecification` is marked as **beta**, so no deprecation process is necessary.

4.25.1.0

2026-01-20

ADDED

Added `ParameterConfiguration.transportSpecification`, which contains the default attribute values for attributes for vehicle, pedestrian, scooter and taxi specification.

4.25.1.0

2026-01-20

FIXED

Navigation: Fixed unnecessary lane recommendation in voice notifications due to inclusion of bike lane(s).

4.25.1.0

2026-01-20

ADDED

Routing: Added `serialize()` and `deserialize()` in `Route` to allow storing and restoring of `Route` objects.

4.25.1.0

2026-01-20

ADDED

Added `diagnosticsOutputPath` field in `NetworkSettings` class to allow setting a file path that will be used to add verbose information in case network related issues occurred during use of the HERE SDK. Note: This is a **beta** release of this feature. There could be a few bugs and unexpected behaviors. Related APIs may change for new releases without a deprecation process.

4.25.1.0

2026-01-20

ADDED

This version of the HERE SDK is delivered with map data v204 for `CatalogType.optimizedClientMap` catalog and v90 for `CatalogType.optimizedClientMapJapan` catalog.

4.25.1.0

2026-01-20

FIXED

Positioning: In iOS fixed incorrect course when the device reported a course of 180° (due south).

4.25.1.0

2026-01-20

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.25.1.0

2026-01-20

KNOWN ISSUE

Navigation: When a `Route` contains a ferry `Section`, then false positive route deviations may be reported within that `Section`.

4.25.1.0

2026-01-20

KNOWN ISSUE

Map view: Any instances of tile data sources (`LineTileDataSource`, `PointTileDataSource`, `PolygonTileDataSource`) attached to the map must be removed before calling `SDKNativeEngine.dispose()`, otherwise a deadlock will occur.

4.25.1.0

2026-01-20

KNOWN ISSUE

Offline maps: Applying a feature configuration may cause the `MapDownloader` to display an inaccurate size for a `Region`. This is a size reporting issue only and does not impact the actual size of the data stored on disk.

4.25.0.0

2025-12-19

CHANGED

Routing: Replaced `VehicleProfile.truckType` with `VehicleProfile.truckCategory`. Replaced `VehicleSpecification.truckType` with `VehicleSpecification.truckCategory`. Note that this is still a **beta** API.

4.25.0.0

2025-12-19

CHANGED

Map view: Removed the previously deprecated `MapContentSettings.filterVehicleRestrictions(...)` method. Use `MapContentSettings.configureVehicleRestrictionFilter(...)` instead.

4.25.0.0

2025-12-19

CHANGED

Routing: Removed the previously deprecated `RoadType` type. Use `TimingProfile` instead. Removed the previously deprecated `Maneuver.roadType`, `Maneuver.nextRoadType`. Use the `Route.sections[Maneuver.sectionIndex].spans[Maneuver.spanIndex].streetAttributes` object to determine the type of road. `StreetAttributes.builtUpArea` indicates an urban road; `StreetAttributes.motorway`, `StreetAttributes.controlledAccessHighway`, or `StreetAttributes.ramp` indicate a highway; all others indicate a rural road type.

4.25.0.0

2025-12-19

CHANGED

Routing: Removed deprecated `EVMobilityServiceProviderPreferences.excluded`. Use other preference levels of `EVMobilityServiceProviderPreferences` instead.

4.25.0.0

2025-12-19

FIXED

Map data: Fixed a crash in `AdministrativeRulesLoader` that occurred when the data could not be found in the map.

4.25.0.0

2025-12-19

ADDED

Map view: Added ability to allow or disallow showing a `MapMarker` as an icon without text if the text collides with other markers. See `MapMarker.isTextOptional` for details.

4.25.0.0

2025-12-19

ADDED

Offline search: Added `LayerConfiguration.Feature.offlineSearchGlobal` which improves the performance and memory footprint when searching with the `OfflineSearchEngine`. It also extends the search range and allows to search for places beyond the search center. Once the layer is enabled via `SDKOptions`, the new improved algorithm will be used. It is recommended to also disable the `LayerConfiguration.Feature.offlineSearch` feature to avoid downloading layers that are not necessary by the new algorithm. Additionally, execute a map update for previously downloaded offline maps to avoid errors such as `SearchError.mapNotReady` or `SearchError.layersNotDownloaded`. As of now, only installed regions are supported. Cached or prefetched map data is not yet supported. Note that this is a **beta** release of this feature, so there could be a few bugs and unexpected behaviors.

4.25.0.0

2025-12-19

ADDED

Navigation: Added `TrackingCameraBehavior`, a new camera behavior class for use with the `VisualNavigator`. From any starting point, it smoothly animates towards the target and then follows subsequent position updates.

4.25.0.0

2025-12-19

ADDED

This version of the HERE SDK is delivered with map data v199 for `CatalogType.optimizedClientMap` catalog and v89 for `CatalogType.optimizedClientMapJapan` catalog.

4.25.0.0

2025-12-19

FIXED

Navigation: Reduced the severity of some logs that were mistakenly categorized as errors.

4.25.0.0

2025-12-19

ADDED

Navigation: Added `JunctionViewLaneAssistance.distanceToJunctionInMeters`, which provides the distance in meters to the junction for which the junction view lane assistance event is emitted. It will be 0 if the junction has already been passed.

4.25.0.0

2025-12-19

CHANGED

Removed the following deprecated country codes: `ALA`, `ATF`, `BVT`, `GGY`, `HMD`, `JEY`, `UMI`.

4.25.0.0

2025-12-19

ADDED

Search: Added `Place.details.evChargingLocation` and `EVChargingLocation` that contains detailed information about charging locations, such as operator, sub-operator and eMSPs info, facility types, parking type, energy mix, EVSEs, tariffs, connector groups, truck restrictions. Added `EVSearchEngine` that provides detailed information about charging locations. Added `EVSearchOptions` that encapsulates additional options that control the behavior of the `EVSearchEngine`. Added `SearchEngine.setEVInterface(...)` that allows attaching the `EVSearchEngine`. After the `EVSearchEngine` and the `SearchEngine` have been connected, subsequent search calls made with the `SearchEngine` will enrich results with additional EV information where applicable. Note that the `EVSearchEngine` requires an additional license, which can be obtained from us. More details can be found in the [HERE EV Charge Point API v3](https://www.here.com/docs/bundle/ev-charge-points-api-v3-developer-guide/page/topics/quick-start-platform.html).

4.25.0.0

2025-12-19

FIXED

Navigation: Fixed an issue where the `BorderCrossingWarningListener` could block the `Navigator` from processing `Location` updates during poor internet connectivity.

4.25.0.0

2025-12-19

ADDED

We have released a new version of the [HERE SDK Reference Application](https://github.com/heremaps/here-sdk-ref-app-flutter). With version [1.16.0](https://github.com/heremaps/here-sdk-ref-app-flutter/releases/tag/1.16.0), we added support for HERE SDK 4.24.0.0, updated applicable app dependencies and the icon set, along with minor fixes and other improvements.

4.25.0.0

2025-12-19

CHANGED

Offline maps: Removed the previously deprecated `mapUpdater.performFeatureUpdate(...)` method. Use the `mapUpdater.updateCatalog(...)` method instead.

4.25.0.0

2025-12-19

FIXED

Navigation: Fixed a potential race condition in `VisualNavigator` that could lead to undefined behavior due to concurrent access. Note that this issue was already introduced with HERE SDK 4.24.3.

4.25.0.0

2025-12-19

CHANGED

Map style update: All night map schemes have been consistently brightened. All map elements, including land use, water, transport, streets, and overlays such as icons, road shields, POIs, traffic, exits, trucks, and safety cameras, have been updated.

4.25.0.0

2025-12-19

CHANGED

Updated the latest supported Flutter version from 3.35.3 to 3.35.7. The latest supported Dart version remains unchanged with Dart 3.9.2. The minimum supported Flutter version was updated from Flutter version 3.29.3 to 3.35.7. The minimum supported Dart version was updated from Dart 3.7.2 to 3.9.2. Therefore, with this release only **Flutter 3.35.7** and **Dart 3.9.2** are supported. Other versions may also work, but are not guaranteed to work. The next Flutter update is planned with HERE SDK 4.26.0.0 and the anticipated version is Flutter 3.38.x.

4.25.0.0

2025-12-19

ADDED

Routing: Added `ViolatedRestriction.forbiddenTruckCategory`, which will replace the deprecated `ViolatedRestriction.forbiddenTruckType`.

4.25.0.0

2025-12-19

CHANGED

Routing: Deprecated the attribute `forbiddenTruckType` from `ViolatedRestriction`. Use `ViolatedRestriction.forbiddenTruckCategory` instead.

4.25.0.0

2025-12-19

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.25.0.0

2025-12-19

KNOWN ISSUE

Navigation: When a `Route` contains a ferry `Section`, then false positive route deviations may be reported within that `Section`.

4.25.0.0

2025-12-19

KNOWN ISSUE

Map view: Any instances of tile data sources (`LineTileDataSource`, `PointTileDataSource`, `PolygonTileDataSource`) attached to the map must be removed before calling `SDKNativeEngine.dispose()`, otherwise a deadlock will occur.

4.25.0.0

2025-12-19

KNOWN ISSUE

Offline maps: Applying a feature configuration may cause the `MapDownloader` to display an inaccurate size for a `Region`. This is a size reporting issue only and does not impact the actual size of the data stored on disk.

4.24.5.0

2025-11-27

FIXED

Map view: Fixed incorrect interpolation for animations created from updates built by `MapCameraUpdateFactory.lookAtPointWithGeoOrientationAndMeasure`, `MapCameraUpdateFactory.lookAtPointWithMeasure`, `MapCameraUpdateFactory.lookToMatchGeoPointToViewPointWithOrientationMapMeasure` and `MapCameraUpdateFactory.zoomTo` as well as animations created via `MapCameraAnimationFactory.flyToWithZoom`. Such animations did not interpolate correctly `MapMeasure` values for `MapMeasureKind.zoomLevel` and `MapMeasureKind.scale` but fell back to `MapMeasureKind.distanceInMeters`.

4.24.5.0

2025-11-27

ADDED

Navigation: Added `RouteMatchedLocation` to provide more information about the matched route location. The `RouteMatchedLocation` is included as part of the `RouteProgress` event.

4.24.5.0

2025-11-27

CHANGED

Navigation: Deprecated `RouteProgress.sectionIndex` and `RouteProgress.spanIndex`. Use `RouteProgress.routeMatchedLocation` instead.

4.24.5.0

2025-11-27

ADDED

Offline routing: Improved offline routing to exclude pedestrian-only links in Japan when using non-pedestrian and non-bicycle transport modes, resulting in more appropriate vehicle routes.

4.24.5.0

2025-11-27

CHANGED

Offline routing: Changed `RoutePrefetcher` and `PolygonPrefetcher` to use `LayerConfiguration.implicitlyPrefetchedFeatures` instead of `LayerConfiguration.enabledFeatures`. This provides more granular control over what gets prefetched versus what gets downloaded.

4.24.5.0

2025-11-27

ADDED

Map data: Added `etcGuidanceFile` to `sdk.mapdata.TollStructureManeuver`. It indicates an optional image that provides guidance through an electronic toll collection (ETC) point.

4.24.5.0

2025-11-27

ADDED

Map data: Added `downloadFile` to `sdk.mapdata.SegmentDataLoader`. It retrieves data for a list of electronic toll collection (ETC) points.

4.24.5.0

2025-11-27

FIXED

Navigation: Fixed deviation detection in multi-catalog setups after calling `SDKCache.clearCache()` when only one catalog with navigation data remains.

4.24.5.0

2025-11-27

ADDED

This version of the HERE SDK is delivered with map data v197 for `CatalogType.optimizedClientMap` catalog and v89 for `CatalogType.optimizedClientMapJapan` catalog.

4.24.5.0

2025-11-27

ADDED

Electronic horizon : Added property `route` to `ElectronicHorizon`.

4.24.5.0

2025-11-27

ADDED

Map data: Added `sdk.mapdata.SegmentSpanData.urban` in `SegmentDataLoader.loadDirectedSegmentData`. The `sdk.mapdata.SegmentSpanData.urban` provides descriptions of urban areas in a span of a directed segment.

4.24.5.0

2025-11-27

ADDED

Map data: Added `sdk.mapdata.SegmentSpanData.specialSpeedSituations` to `SegmentDataLoader.loadDirectedSegmentData`. The `sdk.mapdata.SegmentSpanData.specialSpeedSituations` provides descriptions of special speed situations within a span of a directed segment.

4.24.5.0

2025-11-27

ADDED

Indoor map: Added `VenueTransportMode.CAR` and `VenueTransportMode.SCOOTER` to synchronize Indoor transport mode with Outdoor transport mode.

4.24.5.0

2025-11-27

CHANGED

Indoor map: Deprecated `sdk.venue.routing.VenueTransportMode.AUTO`. Use `sdk.venue.routing.VenueTransportMode.CAR` instead. Deprecated `sdk.venue.routing.VenueTransportMode.EMERGENCY_VEHICLE`. Use `sdk.venue.routing.VenueTransportMode.CAR` instead. Deprecated `sdk.venue.routing.VenueTransportMode.MOTORCYCLE`. Use `sdk.venue.routing.VenueTransportMode.SCOOTER` instead.

4.24.5.0

2025-11-27

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.24.5.0

2025-11-27

KNOWN ISSUE

Navigation: When a `Route` contains a ferry `Section`, then false positive route deviations may be reported within that `Section`.

4.24.5.0

2025-11-27

KNOWN ISSUE

Offline maps: Applying a feature configuration may cause the `MapDownloader` to display an inaccurate size for a `Region`. This is a size reporting issue only and does not impact the actual size of the data stored on disk.

4.24.4.0

2025-11-12

FIXED

Offline routing: Fixed missing `StreetAttributes.builtUpArea` support in offline routing. The behavior of `Span.streetAttributes` is now more consistent between online and offline routing.

4.24.4.0

2025-11-12

FIXED

Navigation: Fixed a slight delay in the `DistanceType.reached` notification in `SafetyCameraWarning`. Previously, `DistanceType.reached` would trigger only after `safetyCameraWarning.distanceToCameraInMeters` reached 0 with `DistanceType.ahead`. Now, both notifications occur simultaneously.

4.24.4.0

2025-11-12

ADDED

This version of the HERE SDK is delivered with map data v195 for `CatalogType.optimizedClientMap` catalog and v87 for `CatalogType.optimizedClientMapJapan` catalog.

4.24.4.0

2025-11-12

FIXED

Navigation: Fixed a problem with missing map-matched locations caused by missing `NavigableLocation` updates that could occur during internet connectivity interruptions.

4.24.4.0

2025-11-12

ADDED

Offline maps: Added `NavigabilityType` to `Region` to indicate whether a region can be used for navigation purposes.

4.24.4.0

2025-11-12

FIXED

Offline routing: Fixed an issue in `Span.getNoticeIndexes()` where notices sharing the same `SectionNoticeCode` could be missed during route parsing in offline routing.

4.24.4.0

2025-11-12

ADDED

Offline maps: Added `LayerConfiguration.Feature.detailedTerrain`, enabling detailed terrain display starting from zoom level 13.

4.24.4.0

2025-11-12

ADDED

Navigation: Added a new camera behavior `AreaCameraBehavior` for the `VisualNavigator`. It allows configuring the camera so that a specified area is fully visible within the view.

4.24.4.0

2025-11-12

CHANGED

Map view: Updated `HereMapController.shadowQuality` property to use non-optional shadow quality. The default shadow quality is now set to `ShadowQuality.medium`. Note that this is a **beta** release of this feature.

4.24.4.0

2025-11-12

FIXED

Map view: Fixed altitude handling in `MapCameraKeyframeTrack.lookAtTargetWithEasing`: altitudes are now ignored, aligning the behavior with the documentation of `GeoCoordinatesKeyframe.value`.

4.24.4.0

2025-11-12

ADDED

Navigation: Added 'speedInMetersPerSecond` and `timestamp` to `MapMatchedLocation' to provide the speed and timestamp of the map matched position. Note that this is a **beta** release of this feature.

4.24.4.0

2025-11-12

FIXED

Fixed an issue where the `ElectronicHorizon` feature only worked in tracking mode without a `Route`. The feature now correctly generates events when a `Route` is set.

4.24.4.0

2025-11-12

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.24.4.0

2025-11-12

KNOWN ISSUE

Navigation: When a `Route` contains a ferry `Section`, then false positive route deviations may be reported within that `Section`.

4.24.4.0

2025-11-12

KNOWN ISSUE

Offline maps: Applying a feature configuration may cause the `MapDownloader` to display an inaccurate size for a `Region`. This is a size reporting issue only and does not impact the actual size of the data stored on disk.

4.24.3.0

2025-11-03

ADDED

Map data: Added `TollPoint` to represent the toll point attributes of a segment. Added boolean field `loadTollPoints` to `SegmentDataLoaderOptions`, which controls whether `TollPoint` objects are loaded. Added `tollPoints` to `SegmentData` to retrieve the `TollPoint` objects of a segment.

4.24.3.0

2025-11-03

ADDED

Map view: Added `lookAtDistanceWithKind(MapMeasureKind, List, Easing, KeyframeInterpolationMode)` method to `MapCameraKeyframeTrack` to support retrieving Kind measures such as distance, zoom, and scale level.

4.24.3.0

2025-11-03

CHANGED

Map view: Deprecated the `MapCameraKeyframeTrack.lookAtDistanceWithEasing(List, Easing, KeyframeInterpolationMode)`. Use `MapCameraKeyframeTrack.lookAtDistanceWithKind(MapMeasureKind, List, Easing, KeyframeInterpolationMode)` instead.

4.24.3.0

2025-11-03

ADDED

This version of the HERE SDK is delivered with map data v192 for `CatalogType.optimizedClientMap` catalog and v87 for `CatalogType.optimizedClientMapJapan` catalog.

4.24.3.0

2025-11-03

FIXED

Navigation: Fixed an issue with map matching that caused the vehicle to remain on the route when driving on a nearby parallel street.

4.24.3.0

2025-11-03

FIXED

Offline routing: Fixed an issue where `OfflineRoutingEngine` returned `RoutingError.routeCalculationFailed` for routes connecting two countries by ferry.

4.24.3.0

2025-11-03

FIXED

Map view: Fixed the filter order for tunnel category restrictions. A filter set to `TunnelCategory.categoryD` now correctly includes restrictions for `TunnelCategory.categoryE` as well.

4.24.3.0

2025-11-03

ADDED

Map data: Added `SegmentData.roadSigns` in `SegmentDataLoader.loadDirectedSegmentData`. The `SegmentData.roadSigns` provides descriptions of the road signs for a directed segment.

4.24.3.0

2025-11-03

ADDED

Map data: Added `SegmentData.tollPoints` in `SegmentDataLoader.loadDirectedSegmentData`. The `SegmentData.tollPoints` provides descriptions of toll structures present in a directed segment.

4.24.3.0

2025-11-03

FIXED

Fixed a crash that occurred when processing road sign data with an empty language code by returning a `null` `LocalizedText` instead of creating invalid `Locale` objects.

4.24.3.0

2025-11-03

FIXED

Map view: Fixed an issue where the `MapCamera.lookAt(...)` method did not work with the Vietnam map `MapFeatureModes.terrain3D` was enabled.

4.24.3.0

2025-11-03

ADDED

Added `LocationFeature.wifiPositioning3d` for WiFi network positioning with altitude support.

4.24.3.0

2025-11-03

ADDED

Map view: Added the method `setMarker3dModelWithRenderSizeUnit(MapMarker3DModel model, double scale, LocationIndicatorMarkerType type, RenderSizeUnit renderSizeUnit)` to `LocationIndicator` to specify how the vertex coordinates of 3D model are interpreted, either in world or screen coordinate space.

4.24.3.0

2025-11-03

CHANGED

Map view: Deprecated the `LocationIndicator.setMarker3dModel(MapMarker3DModel model, double scale, LocationIndicatorMarkerType type)` method. Use the new `LocationIndicator.setMarker3dModelWithRenderSizeUnit(MapMarker3DModel model, double scale, LocationIndicatorMarkerType type, RenderSizeUnit renderSizeUnit)` overloaded method instead.

4.24.3.0

2025-11-03

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.24.3.0

2025-11-03

KNOWN ISSUE

Navigation: When a `Route` contains a ferry `Section`, then false positive route deviations may be reported within that `Section`.

4.24.3.0

2025-11-03

KNOWN ISSUE

Navigation: The new `ElectronicHorizon` feature does not yet work as expected when a `route` is set. It currently functions only in tracking mode without a `route`. When a `route` is set, no events are generated by the electronic horizon APIs. This issue is expected to be resolved in HERE SDK 4.24.4.0, our next minor release.

4.24.3.0

2025-11-03

KNOWN ISSUE

Offline maps: Applying a feature configuration may cause the `MapDownloader` to display an inaccurate size for a `Region`. This is a size reporting issue only and does not impact the actual size of the data stored on disk.

4.24.2.0

2025-10-13

FIXED

Offline search: The `OfflineSearchEngine` no longer occasionally returns fewer results than requested, even when the expected results are available.

4.24.2.0

2025-10-13

FIXED

Navigation: The `RealisticViewWarningListener` no longer causes a crash when downloading Japan-specific raster images.

4.24.2.0

2025-10-13

ADDED

Electronic Horizon: The methods `electronicHorizon.update(...)` and `electronicHorizonDataLoader.loadData(...)` have been changed from synchronous to asynchronous to avoid blocking the main thread. Results are now delivered on the main thread. Added `ElectronicHorizonDataLoadedStatus` to indicate the loading status for a specific level, and `electronicHorizonDataLoader.addElectronicHorizonDataLoaderStatusListener(...)` / `removeElectronicHorizonDataLoaderStatusListener(...)` to register or unregister an `ElectronicHorizonDataLoaderStatusListener`. Note that this is a **beta** release of this feature.

4.24.2.0

2025-10-13

ADDED

Routing: Added `RoadFeature.seasonalClosure` as an avoidance option in isoline calculations to improve route accuracy by excluding roads that are seasonally closed.

4.24.2.0

2025-10-13

ADDED

Map data: Added `SegmentSpanData.specialSpeedSituations` to identify segment spans with speed limits that exist only under special circumstances.

4.24.2.0

2025-10-13

CHANGED

Map data: Removed the following members that have been released as **beta** previously: `segmentConnectivities`, `loadSegmentConnectivities`, `laneBlocks`, `adasAttributes`, and `loadAdasAttributes`.

4.24.2.0

2025-10-13

ADDED

This version of the HERE SDK is delivered with map data v191 for `CatalogType.optimizedClientMap` catalog and v87 for `CatalogType.optimizedClientMapJapan` catalog.

4.24.2.0

2025-10-13

FIXED

Navigation: Fixed `eventTextListener.onEventTextUpdated(...)` turn orientation announcements when switching between parallel roads. Announcements now use the correct orientation from the driver's point of view.

4.24.2.0

2025-10-13

FIXED

Navigation: Fixed `CurrentSituationLaneAssistanceViewListener`, `ManeuverViewLaneAssistanceListener`, and `JunctionViewLaneAssistanceListener` behavior on roads with special lanes (e.g., bike or parking lanes). Arrows now point in the correct direction and no longer guide the driver into the wrong street.

4.24.2.0

2025-10-13

ADDED

Updated the latest supported Flutter version from 3.32.5 to 3.35.4 and Dart from 3.8.1 to 3.9.2 for the HERE SDK. The minimum supported Flutter version remains unchanged (Flutter 3.29.3 and Dart 3.7.2). Other versions may also work, but are not guaranteed to be work.

4.24.2.0

2025-10-13

FIXED

Offline routing: `TaxiOptions.allowDriveThroughTaxiRoads` and `VehicleSpecification.allowDriveThroughTaxiRoads` are now also supported offline.

4.24.2.0

2025-10-13

FIXED

Electronic horizon: Fixed bugs in `ElectronicHorizonPathSegment.parentPathIndex` inside of `electronicHorizonUpdate.addedSegments(...)`.

4.24.2.0

2025-10-13

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.24.2.0

2025-10-13

KNOWN ISSUE

Navigation: When a `Route` contains a ferry `Section`, then false positive route deviations may be reported within that `Section`.

4.24.2.0

2025-10-13

KNOWN ISSUE

Offline maps: Applying a feature configuration may cause the `MapDownloader` to display an inaccurate size for a `Region`. This is a size reporting issue only and does not impact the actual size of the data stored on disk.

4.24.2.0

2025-10-13

KNOWN ISSUE

Map view: The MapCamera.lookAt API does not work with the Vietnam map when the 3D Terrain feature is enabled.

4.24.1.0

2025-10-01

FIXED

Fixed `AdministrativeRulesLoader.getStateCode()` by removing duplicate state codes from the result.

4.24.1.0

2025-10-01

FIXED

Fixed unexpected `MapDataLoaderErrorCode.INVALID_PARAMETERS` error when requesting administrative codes for valid GBR state codes using `AdministrativeRulesLoader.getAdministrativeRules()`.

4.24.1.0

2025-10-01

FIXED

Offline routing: Aligned offline route duration with online route duration. The `Route.duration` calculated with the `OfflineRoutingEngine` now includes pre and post action durations, such as charging and ferry waiting times.

4.24.1.0

2025-10-01

FIXED

Offline routing: Fixed `EmpiricalConsumptionModel.freeFlowSpeedTable` and `EmpiricalConsumptionModel.trafficSpeedTable` to support consumption values in deciwatts.

4.24.1.0

2025-10-01

ADDED

We are pleased to announce the release of a new version of the [HERE SDK Reference Application](https://github.com/heremaps/here-sdk-ref-app-flutter). Version [1.15.0](https://github.com/heremaps/here-sdk-ref-app-flutter/releases/tag/1.15.0) introduces support for HERE SDK 4.23.0.0, updates relevant application dependencies and the icon set, and includes minor bug fixes and other enhancements.

4.24.1.0

2025-10-01

FIXED

Offline routing: Fixed issue to provide charging station information for stops in offline routing.

4.24.1.0

2025-10-01

ADDED

Added routing support to the indoor module, enabling routing within venues.

4.24.1.0

2025-10-01

CHANGED

For iOS, upgraded build system Xcode version from 14.2 to 16.2. The new version will be used for release builds. Older Xcode versions may still work but are not guaranteed to be supported.

4.24.1.0

2025-10-01

ADDED

Added `loadDirectedSegmentData` to `SegmentDataLoader` to enable loading data for directed segments.

4.24.1.0

2025-10-01

ADDED

Added `SegmentConnectivities` data to `SegmentData` and introduced an option in `SegmentDataLoaderOptions` to enable it.

4.24.1.0

2025-10-01

CHANGED

Navigation: Changed the default value of `BorderCrossingWarningOptions.filterOutStateBorderWarnings` to `true`, meaning border crossing warnings for states are disabled by default.

4.24.1.0

2025-10-01

ADDED

This version of the HERE SDK is delivered with map data v189 for `CatalogType.optimizedClientMap` catalog and v87 for `CatalogType.optimizedClientMapJapan` catalog.

4.24.1.0

2025-10-01

ADDED

Map view: Added `MaterialReflectivity` class, and `LocationIndicator.getMaterialReflectivity` and `LocationIndicator.setMaterialReflectivity` functions to enable the Location Indicator to interact with scene lighting. The Location Indicator casts and receives shadows when the `MapFeatures.shadows` feature is enabled. Note: This feature is in **beta** state and may exhibit bugs or unexpected behavior. Related APIs are subject to change in future releases without a deprecation process.

4.24.1.0

2025-10-01

ADDED

Added `sdk.mapdata.SegmentSpanData.urban` to identify road or ferry segment spans located within a built-up area.

4.24.1.0

2025-10-01

CHANGED

Search: Removed `WebImage.date` and `WebImage.publicationDate`. The date information is no longer provided. Removed `WebImage` default constructor and `WebImage.withSourceAndPublicationDate`, use `WebImage.withSource` instead.

4.24.1.0

2025-10-01

CHANGED

Search: Removed `SearchError.invalidParameter` enum value. More descriptive error values are now provided, such as `SearchError.queryEmpty` and `SearchError.invalidArea`.

4.24.1.0

2025-10-01

FIXED

Routing: Added `ChargingConnectorType.GBT_DC`, representing the Guobiao GB/T 20234.3 DC connector, to specify charging connector types in EV routing calculations.

4.24.1.0

2025-10-01

ADDED

Added `ElectronicHorizon` class responsible for providing `ElectronicHorizonPaths`. Added `ElectronicHorizonPath` representing a path from `ElectronicHorizon` calculation. Added `ElectronicHorizonPaths`, a structure containing all paths provided by `ElectronicHorizon`. Added `ElectronicHorizonListener` and `ElectronicHorizonPositionListener` to subscribe and receive notifications from `ElectronicHorizon` updates. Added `ElectronicHorizonPathSegmentId` indicating the ID of a segment added to `ElectronicHorizonPath`. Added `ElectronicHorizonPathSegment` representing a segment of the path. Added `ElectronicHorizonUpdate` containing information about updates from `ElectronicHorizon`. Added `ElectronicHorizonPathPosition` representing the current position on `ElectronicHorizonPaths`. Added `ElectronicHorizonOptions` to configure the logic of `ElectronicHorizon`. Added `ElectronicHorizonDataLoader` which loads data based on updates from `ElectronicHorizon`. Added `ElectronicHorizonDataLoaderResult` providing results of requested data from `ElectronicHorizonDataLoader`.

4.24.1.0

2025-10-01

CHANGED

Indoor map: Removed deprecated method `Property.toString_`, use the default dart `toString()` method.

4.24.1.0

2025-10-01

CHANGED

Indoor map: Removed deprecated `VenueModel.identifier(String value)`.

4.24.1.0

2025-10-01

CHANGED

Indoor map: Removed deprecated method `VenueTopology.center`.

4.24.1.0

2025-10-01

ADDED

Added `GeoPolyline.coordinatesAtOffsetInMeters()` to convert offsets along the polyline to coordinates.

4.24.1.0

2025-10-01

ADDED

Added `GeoCoordinates.interpolate()` to interpolate between two coordinates.

4.24.1.0

2025-10-01

CHANGED

Offline routing: Deprecated: `sdk.prefetcher.RoutePrefetcher.prefetchAroundLocationWithRadius`, use `sdk.prefetcher.PolygonPrefetcher.prefetch` instead.

4.24.1.0

2025-10-01

ADDED

Map style update: Enabled display of traffic lights at zoom levels >= 18. Data available in `hrn:here:data::olp-here:ocm` with version >= 182.

4.24.1.0

2025-10-01

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.24.1.0

2025-10-01

KNOWN ISSUE

Navigation: When a `Route` contains a ferry `Section`, then false positive route deviations may be reported within that `Section`.

4.24.1.0

2025-10-01

KNOWN ISSUE

Offline maps: Applying a feature configuration may cause the `MapDownloader` to display an inaccurate size for a `Region`. This is a size reporting issue only and does not impact the actual size of the data stored on disk.

4.24.1.0

2025-10-01

KNOWN ISSUE

Map view: The MapCamera.lookAt API does not work with the Vietnam map when the 3D Terrain feature is enabled.

4.24.1.0

2025-10-01

KNOWN ISSUE

Offline search: The `OfflineSearchEngine` may occasionally return fewer results than requested, even when the expected results are available.

4.24.1.0

2025-10-01

KNOWN ISSUE

Navigation: The `RealisticViewWarningListener` might cause a crash when downloading Japan-specific raster images.

4.24.0.0

2025-09-17

ADDED

`SegmentDataLoader`: Added `getRailwayCrossings()` to `SegmentData`. It retrieves the `RailwayCrossing` instances of a segment.

4.24.0.0

2025-09-17

ADDED

`SegmentDataLoader`: Added `loadRailwayCrossings` to `SegmentDataLoaderOptions`. This option determines whether `RailwayCrossing` should be loaded.

4.24.0.0

2025-09-17

ADDED

`SegmentDataLoader`: Added `getAdministrativeRules()` to `SegmentSpanData`. It retrieves the `AdministrativeRules` of a segment. The loading of `AdministrativeRules` for a segment is configured via `SegmentDataLoaderOptions.loadAdministrativeRules`.

4.24.0.0

2025-09-17

CHANGED

Map view: Changed the type of `PickMapContentResult.VehicleRestrictionResult.countryCode` from `String` to `CountryCode` enum.

4.24.0.0

2025-09-17

CHANGED

Map view: Removed the previously deprecated `VehicleRestrictionIconAttributesFactory.createVehicleRestrictionIconAttributes(VehicleRestriction, String)`. Use `VehicleRestrictionIconAttributesFactory.createVehicleRestrictionIconAttributes(VehicleRestriction, CountryCode)` instead.

4.24.0.0

2025-09-17

CHANGED

Map view: Changed type of `PickVehicleRestrictionsResult.vehicleRestriction` from `VehicleRestriction?` to `VehicleRestriction`.

4.24.0.0

2025-09-17

CHANGED

Routing: Removed the previously deprecated `maxGrossWeightInKilograms`. Use `maxWeight` instead.

4.24.0.0

2025-09-17

ADDED

This version of the HERE SDK is delivered with map data v187 for `CatalogType.optimizedClientMap` catalog and v87 for `CatalogType.optimizedClientMapJapan` catalog.

4.24.0.0

2025-09-17

ADDED

`SegmentDataLoader`: Added `getTrafficSignals()` to `SegmentData` to retrieve the `TrafficSignal` objects of a segment.

4.24.0.0

2025-09-17

ADDED

`SegmentDataLoader`: Added `loadTrafficSignals` to `SegmentData` to retrieve the `SegmentDataLoaderOptions`. This option defines whether `TrafficSignal` should be loaded.

4.24.0.0

2025-09-17

ADDED

`SegmentDataLoader`: Added `TrafficSignal` to identify traffic signal attributes of a segment.

4.24.0.0

2025-09-17

FIXED

Navigation: Fixed invalid memory access when failing to fetch Japan-specific raster images in RealisticViewWarner.

4.24.0.0

2025-09-17

ADDED

`SegmentDataLoader`: Added `SegmentData.roadSigns` to describe road signs of a segment.

4.24.0.0

2025-09-17

CHANGED

Routing: Removed `evDetails` from `Route`. Use `consumptionInKilowattHours` instead.

4.24.0.0

2025-09-17

CHANGED

Routing: Removed `evDetails` from `Section`. Use `consumptionInKilowattHours` instead.

4.24.0.0

2025-09-17

CHANGED

Routing: Removed the deprecated `BusSpecifications.lastCharacterOfLicensePlate`. Use `BusOptions.lastCharacterOfLicensePlate` instead.

4.24.0.0

2025-09-17

CHANGED

The minimum supported iOS version for HERE SDK has been decreased from version 16.0 to 15.2. Though iOS 16.0 and newer remains fully supported.

4.24.0.0

2025-09-17

CHANGED

Xcode version used for building releases will be updated from version 14.2 to version 16.2 in HERE SDK release 4.24.1.0.

4.24.0.0

2025-09-17

CHANGED

Android only: Removed the previously deprecated ConsentEngine API. Use `LocationEngineBase.confirmHEREPrivacyNoticeInclusion()` or `LocationEngineBase.confirmHEREPrivacyNoticeException()` instead.

4.24.0.0

2025-09-17

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.24.0.0

2025-09-17

KNOWN ISSUE

Navigation: When a `Route` contains a ferry `Section`, then false positive route deviations may be reported within that `Section`.

4.24.0.0

2025-09-17

KNOWN ISSUE

Offline maps: Applying a feature configuration may cause the `MapDownloader` to display an inaccurate size for a `Region`. This is a size reporting issue only and does not impact the actual size of the data stored on disk.

4.24.0.0

2025-09-17

KNOWN ISSUE

Map view: The MapCamera.lookAt API does not work with the Vietnam map when the 3D Terrain feature is enabled.

4.24.0.0

2025-09-17

KNOWN ISSUE

Offline search: The `OfflineSearchEngine` may occasionally return fewer results than requested, even when the expected results are available.

4.24.0.0

2025-09-17

KNOWN ISSUE

Navigation: The `RealisticViewWarningListener` might cause a crash when downloading Japan-specific raster images.

4.23.5.0

2025-09-03

ADDED

Navigation: Added `Maneuver.spanIndex` to retrieve the span index from the `Section.spans` list where the maneuver is located.

4.23.5.0

2025-09-03

CHANGED

Map view: The `defaultMode` for `MapFeature.landmarks` has been changed from `MapFeatureModes.landmarksTextured` to `MapFeatureModes.landmarksGrayscale` to display landmark textures in grayscale instead of colored textures.

4.23.5.0

2025-09-03

ADDED

Segment map data: The `SegmentData` class was extended by adding a `LaneBlock` field to store the lane data of a segment. Lane data will be loaded with segment data if the `SegmentDataLoaderOptions.loadLaneBlocks` flag is set to `true`.

4.23.5.0

2025-09-03

FIXED

Navigation: Fixed a crash during navigation that occurred when certain regions were missing from the map data and a `CountryCode` from those regions was requested.

4.23.5.0

2025-09-03

ADDED

Lane assistance: Added `directions` field to the `LaneMarkings` class which contains a list of all available `LaneDirections`.

4.23.5.0

2025-09-03

ADDED

This version of the HERE SDK is delivered with map data v185 for `CatalogType.optimizedClientMap` catalog and v87 for `CatalogType.optimizedClientMapJapan` catalog.

4.23.5.0

2025-09-03

CHANGED

Lane assistance: Removed `directions` field from `LaneAttribute` class. The field has been moved to the `LaneMarkings` class.

4.23.5.0

2025-09-03

ADDED

Segment map data: Added `adasAttributes` to `SegmentData`. It retrieves the `AdasAttributes` of a segment when `LayersConfiguration.ADAS` is enabled.

4.23.5.0

2025-09-03

ADDED

Segment map data: Added `loadAdasAttributes()` to `SegmentDataLoaderOptions`. It defines whether `AdasAttributes` should be loaded when `LayersConfiguration.ADAS` is enabled.

4.23.5.0

2025-09-03

ADDED

Added `AdasAttributes` to identify the ADAS attributes, such as slope and elevation, of a segment if `LayersConfiguration.ADAS` is enabled.

4.23.5.0

2025-09-03

ADDED

Segment map data: Added `RoadUsages.isPriorityRoad` to indicate whether a segment span has signs indicating priority on the road.

4.23.5.0

2025-09-03

FIXED

Navigation: Fixed `MapMatcher` module behavior introduced in 4.23.4, where matching a `Location` with the time field not set was incorrectly succeeding, which could lead to potentially incorrect results. The field `Location.time` is mandatory for the `MapMatcher` to work properly. When no time is provided, `null` will be returned by the `match` method and an error message will be logged.

4.23.5.0

2025-09-03

ADDED

Navigation: The `RealisticViewWarning` images now contain visualizations for service areas and parking areas along highways in Japan.

4.23.5.0

2025-09-03

ADDED

Navigation: The `RealisticViewWarning` images now contain visualizations for ETC (Electronic Toll Collection System) locations in Japan.

4.23.5.0

2025-09-03

FIXED

Map view: Fixed an ANR during `MapView` shutdown. Starting with HERE SDK 4.22.5, a deadlock was possible when the `MapView` shut down while user callbacks were in progress, particularly when a custom raster tile source was being rendered.

4.23.5.0

2025-09-03

FIXED

Positioning: On Android fixed possible crash in HERE Positioning when starting navigation.

4.23.5.0

2025-09-03

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.23.5.0

2025-09-03

KNOWN ISSUE

Navigation: When a `Route` contains a ferry `Section`, then false positive route deviations may be reported within that `Section`.

4.23.5.0

2025-09-03

KNOWN ISSUE

Offline maps: Applying a feature configuration may cause the `MapDownloader` to display an inaccurate size for a `Region`. This is a size reporting issue only and does not impact the actual size of the data stored on disk.

4.23.5.0

2025-09-03

KNOWN ISSUE

Offline search: The `OfflineSearchEngine` may occasionally return fewer results than requested, even when the expected results are available.

4.23.5.0

2025-09-03

KNOWN ISSUE

Navigation: The `RealisticViewWarningListener` might cause a crash when downloading Japan-specific raster images.

4.23.4.0

2025-08-21

ADDED

Map view: Added `MapFeatureModes.landmarksGrayscale` for `MapFeatures.landmarks` to display landmark textures in grayscale.

4.23.4.0

2025-08-21

CHANGED

Map view: **Upcoming change:** The `default` map feature mode for `MapFeature.landmarks` will be changed from `MapFeatureModes.landmarksTextured` to `MapFeatureModes.landmarksGrayscale` to display landmark textures in grayscale instead of colored textures. This change is planned for one of the next HERE SDK releases.

4.23.4.0

2025-08-21

ADDED

Map view: Added `MapFeatures.truckPreferredRoads` feature with `MapFeatureModes.truckPreferredRoadsAll` mode. When enabled, the `MapFeatureModes.truckPreferredRoadsAll` mode displays a purple translucent outline highlighting roads marked as truck-preferred. By default, the feature is disabled.

4.23.4.0

2025-08-21

ADDED

Navigation: Added `Route.routeLabels` for retrieving route labels for a route. Added the `RouteLabelType` enum specifying the type of route label (street name or route number) and the `RouteLabel` class containing information about a route label. Enabling or disabling route labels in the route response is controlled via the `RouteOptions.enableRouteLabels` property.

4.23.4.0

2025-08-21

CHANGED

Map view: Deprecated `MapContentSettings.filterVehicleRestrictions(...)`, use `MapContentSettings.configureVehicleRestrictionFilter(...)` instead.

4.23.4.0

2025-08-21

ADDED

Map view: Added `MapContentSettings.configureVehicleRestrictionFilter(...)` as a replacement for `MapContentSettings.filterVehicleRestrictions(...)`. The new method includes an additional parameter, `TransportMode`, to distinguish between different modes of transportation. This ensures that the generic truck restriction icon is not displayed on the map when the transport mode is not `TransportMode.truck`.

4.23.4.0

2025-08-21

CHANGED

`SegmentSpanData`: Deprecated `PhysicalAttributes.isDividedRoad`. Instead use `PhysicalAttributes.divider` to obtain a `RoadDivider`, and `PhysicalAttributes.isMultiplyDigitized`.

4.23.4.0

2025-08-21

FIXED

Offline routing: Fixed missing road shield icons when calculating an offline route.

4.23.4.0

2025-08-21

ADDED

This version of the HERE SDK is delivered with map data v183 for `CatalogType.optimizedClientMap` catalog and v87 for `CatalogType.optimizedClientMapJapan` catalog.

4.23.4.0

2025-08-21

FIXED

Navigation: Fixed map-matching to handle location data lacking timestamps, preventing exceptions and application crashes.

4.23.4.0

2025-08-21

FIXED

Map view: Fixed unexpected high CPU usage when enabling `MapFeatures.trafficFlow` on devices with a single core, regardless of the number of available cores. Note that this issue started to appear in HERE SDK 4.22.5.0.

4.23.4.0

2025-08-21

FIXED

Offline routing: Fixed a defect where the `OfflineRoutingEngine` would ignore highway sections when using `VehicleSpecification` in offline mode. This behavior occurred only when `VehicleSpecification` was not `null`. Highway sections are now considered in the same way as with the online `RoutingEngine`.

4.23.4.0

2025-08-21

ADDED

`SegmentSpanData`: Added `PhysicalAttributes.isBoatFerry` and `PhysicalAttributes.isRailFerry` to indicate if a segment is part of a ferry route.

4.23.4.0

2025-08-21

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.23.4.0

2025-08-21

KNOWN ISSUE

Navigation: When a `Route` contains a ferry `Section`, then false positive route deviations may be reported within that `Section`.

4.23.4.0

2025-08-21

KNOWN ISSUE

Offline maps: Applying a feature configuration may cause the `MapDownloader` to display an inaccurate size for a `Region`. This is a size reporting issue only and does not impact the actual size of the data stored on disk.

4.23.4.0

2025-08-21

KNOWN ISSUE

Offline search: The `OfflineSearchEngine` may occasionally return fewer results than requested, even when the expected results are available.

4.23.3.0

2025-08-05

CHANGED

EV Routing: Set the default value of `ElectricVehicleOptions.batterySpecifications` was changed to `null`. The field is now nullable. Note that this is a **beta** release of this feature.

4.23.3.0

2025-08-05

ADDED

Routing: Added `RoutingOptions` to `IsolineOptions`. `RoutingOptions` can now be used with the `IsolineRoutingEngine`.

4.23.3.0

2025-08-05

CHANGED

Navigation: Deprecated `BorderCrossingWarning.countryCode`, `BorderCrossingWarning.stateCode`, and `BorderCrossingWarning.speedLimits`. All these attributes can now be retrieved from `BorderCrossingWarning.administrativeRules`.

4.23.3.0

2025-08-05

ADDED

MapMatcher: Added `MapMatcher(SDKNativeEngine sdkEngine, boolean useRenderingLayers)` constructor. When `useRenderingLayers` is set to `true`, `LayerConfiguration.Feature.RENDERING` will be used. If set to `false`, `LayerConfiguration.Feature.EHORIZON` will be used instead to retrieve data from the OCM map.

4.23.3.0

2025-08-05

ADDED

Map view: Starting with HERE Style Editor v1.13.0, only zipped archives (`.tar.gz`) are exported. These archives include POI categories and the JSON style files. When loading a custom style using `MapScene.loadScene(...)`, the HERE SDK supports specifying a path to a JSON file, as before, but it also allows to set a `configurationFile` pointing to the zipped archive.

4.23.3.0

2025-08-05

ADDED

This version of the HERE SDK is delivered with map data v180 for `CatalogType.optimizedClientMap` catalog and v86 for `CatalogType.optimizedClientMapJapan` catalog.

4.23.3.0

2025-08-05

FIXED

Routing: Fixed `TaskHandle` to correctly return `finished` when route calculation completes and `cancelled` when it’s cancelled for routing, isoline, and traffic.

4.23.3.0

2025-08-05

FIXED

Android: Fixed a regression in data usage statistics for positioning introduced in HERE SDK 4.22.5. Previously, positioning subcategories were combined into a single value; now, `positioning` and `serviceImprovement` subcategories are correctly reported separately again.

4.23.3.0

2025-08-05

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.23.3.0

2025-08-05

KNOWN ISSUE

Navigation: When a `Route` contains a ferry `Section`, then false positive route deviations may be reported within that `Section`.

4.23.3.0

2025-08-05

KNOWN ISSUE

Offline maps: Applying a feature configuration may cause the `MapDownloader` to display an inaccurate size for a `Region`. This is a size reporting issue only and does not impact the actual size of the data stored on disk.

4.23.3.0

2025-08-05

KNOWN ISSUE

Offline search: The `OfflineSearchEngine` may occasionally return fewer results than requested, even when the expected results are available.

4.23.2.0

2025-07-23

ADDED

Added `TruckSpecifications.currentWeightInKilograms` field to indicate the current weight of the vehicle.

4.23.2.0

2025-07-23

ADDED

Navigation: Added the fields `isTollStickerRequired`, `turnOnRedRegulations`, `parkingSideRegulations`, `isCleanAirStickerRequired`, `bloodAlcoholContentLimit`, `tollSystems`, and `preTripPlanning` to `AdministrativeRules`. Also added the class `BloodAlcoholContentLimit` to retrieve information on acceptable blood alcohol limits, class `PreTripPlanning` to define required vehicle equipment before entering a country or state (e.g., warning triangle, first-aid kit, safety vest), and the class `TollSystem` to provide toll regulation details and applicable vehicle types.

4.23.2.0

2025-07-23

ADDED

Navigation: Updated default colors for `VisualNavigatorColors` (in 0xRRGGBBAA format): for `dayColors()`, car route: `0x0D5ED9FF` to `0x0D61DEFF`, car route outline: `0x1257B8FF` to `0x002693FF`, car route progress outline: `0x8F9BAAFF` to `0x929FB2FF`, And for `nightColors()`, car route: `0x1A5CBDFF` to `0x3168FFFF`, car route outline: `0x083C8AFF` to `0x5096FFFF`, car route progress: `0xB9C5D4FF` to `0x304866FF`, car route progress outline: `0x8F9BAAFF` to `0x677685FF`.

4.23.2.0

2025-07-23

CHANGED

Map view: Deprecated `PickMapContentResult.VehicleRestrictionResult.countryCode`. With HERE SDK 4.24.0 we plan to change the type from `String` to `CountryCode`. You can continue to use the deprecated code, but be aware that its type is expected to change.

4.23.2.0

2025-07-23

CHANGED

Map view: Deprecated `VehicleRestrictionIconAttributesFactory.createVehicleRestrictionIconAttributesWithCountryCodeString(VehicleRestriction, String)`. Please use `VehicleRestrictionIconAttributesFactory.createVehicleRestrictionIconAttributes(VehicleRestriction, CountryCode?)` instead.

4.23.2.0

2025-07-23

CHANGED

Map view: Deprecated `PickMapContentResult.VehicleRestrictionResult.vehicleRestriction`. With HERE SDK 4.24.0.0 we plan to change the type from being optional to non-optional. You can continue to use the deprecated code, but try to avoid setting it to `null`.

4.23.2.0

2025-07-23

ADDED

Routing: Added `AvoidanceOptions.zoneCategories`, `AvoidanceOptions.zoneIds` and `AvoidanceOptions.exceptZoneIds` options for isoline calculation.

4.23.2.0

2025-07-23

ADDED

Positioning: Added support for positioning on Android based on native 5G cellular networks. This applies to mobile devices that are connected to 5G Standalone (SA) cellular networks, also called NR or New Radio networks. Note that positioning based on 5G Non-Standalone (NSA) cellular networks has been supported already earlier.

4.23.2.0

2025-07-23

ADDED

This version of the HERE SDK is delivered with map data v180 for `CatalogType.optimizedClientMap` catalog and v84 for `CatalogType.optimizedClientMapJapan` catalog.

4.23.2.0

2025-07-23

ADDED

The latest supported Flutter version was raised from 3.29.3 to 3.32.5. The latest supported Dart version was updated accordingly from 3.7.2 to 3.8.1. The minimum supported Flutter version remains unchanged (Flutter 3.29.3 and Dart 3.7.2). Other versions may also work, but are not guaranteed to be supported.

4.23.2.0

2025-07-23

FIXED

Navigation: Fixed an out of range exception crash in `VisualNavigator` when visualizing traffic on the route.

4.23.2.0

2025-07-23

ADDED

Routing: Added `ViolatedRestriction.Details.maxNumberOfTires`, added `VehicleSpecification.tiresCount` to store maximum permitted number of tires. Note that this feature is also supported by the `OfflineRoutingEngine`, if available for your edition.

4.23.2.0

2025-07-23

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.23.2.0

2025-07-23

KNOWN ISSUE

Navigation: When a `Route` contains a ferry `Section`, then false positive route deviations may be reported within that `Section`.

4.23.2.0

2025-07-23

KNOWN ISSUE

Offline maps: Applying a feature configuration may cause the `MapDownloader` to display an inaccurate size for a `Region`. This is a size reporting issue only and does not impact the actual size of the data stored on disk.

4.23.2.0

2025-07-23

KNOWN ISSUE

Offline search: The `OfflineSearchEngine` may occasionally return fewer results than requested, even when the expected results are available.

4.23.1.0

2025-07-15

ADDED

Map view: Improved support for transparent custom line layers to avoid darker colors when objects overlap. Added `TranslucentMapLayerGroup` class and `MapLayerPriorityBuilder.inGroup()` function to support placing custom line layers into a translucent layer group. Custom line layers within a translucent group are rendered in an offscreen translucent pass, preventing self-overlapping translucent geometry from being alpha blended. Note that this is a **beta** release of this feature.

4.23.1.0

2025-07-15

ADDED

The minimum supported Flutter version for HERE SDK has been raised from version 3.27.4 to 3.29.3. The corresponding Dart version was raised from 3.6.2 to 3.7.2. The internally used `intl` plugin dependency was changed from version '0.19' to '>=0.19.0 <0.21.0'.

4.23.1.0

2025-07-15

ADDED

`OfflineSearchEngine`: Improved searching for places along the route via `GeoCorridor`. The results are now more equally distributed along the entire route. Enable this feature with the new `SearchOptions.distributedResults` flag, which will use internally a parallel search algorithm. Note that this flag impacts only offline search.

4.23.1.0

2025-07-15

CHANGED

Removed the previously deprecated `LayerConfiguration.Feature.TRAFFIC`. Please use `LayerConfiguration.Feature.RDS_TRAFFIC` instead.

4.23.1.0

2025-07-15

ADDED

Map style update: Enriched the POI display on the map by implementing new icons for various POI categories which previously used generic iconography.

4.23.1.0

2025-07-15

ADDED

This version of the HERE SDK is delivered with map data v178 for `CatalogType.optimizedClientMap` catalog and v84 for `CatalogType.optimizedClientMapJapan` catalog.

4.23.1.0

2025-07-15

CHANGED

The minimum supported iOS version for HERE SDK has been raised from version 15.0 to 16.0.

4.23.1.0

2025-07-15

ADDED

Navigation: Added `GeneralVehicleSpeedLimits.maxSpeedRainingInMetersPerSecond`, `GeneralVehicleSpeedLimits.maxSpeedSnowingInMetersPerSecond`, `GeneralVehicleSpeedLimits.maxSpeedNightInMetersPerSecond`, `GeneralVehicleSpeedLimits.minSpeedHighwaysInMetersPerSecond`. Added `AdministrativeRules` class which will be used when retrieving administrative rules for a state or a country. Added `AdministrativeRulesLoader` class with the methods `AdministrativeRulesLoader.getStateCodes` for getting all the states in a country and `AdministrativeRulesLoader.getAdministrativeRules` for getting the administrative rules for a specific state or for the whole country.

4.23.1.0

2025-07-15

CHANGED

Removed the previously deprecated `SDKOptions.accessKeyId` and `SDKOptions.accessKeySecret`. Please use `SDKOptions.authenticationMode` instead.

4.23.1.0

2025-07-15

CHANGED

Map view: The default zoom-level to storage-level mapping has changed: the offset is now -3 instead of -1 for all layer types, except for raster layers, which can be created using the `MapLayerBuilder` API. `MapPolyline.DashImageRepresentation` map measure support has been updated to a new range of [3–19], replacing the previous range of [1–20].

4.23.1.0

2025-07-15

ADDED

Search: Added `PlaceCategory.sightsLandmarkAttraction` to use instead of `PlaceCategory.sightsLandmarkAttaction` that contains a typo. Note that this is also supported for the `OfflineSearchEngine` (if available for your license).

4.23.1.0

2025-07-15

CHANGED

Search: Deprecated `PlaceCategory.sightsLandmarkAttaction` that contains a typo. Please use `PlaceCategory.sightsLandmarkAttraction` instead.

4.23.1.0

2025-07-15

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.23.1.0

2025-07-15

KNOWN ISSUE

Navigation: When a `Route` contains a ferry `Section`, then false positive route deviations may be reported within that `Section`.

4.23.1.0

2025-07-15

KNOWN ISSUE

Support for Flutter 3.32 and later is not yet available. This release of the HERE SDK is compatible only with Flutter 3.27.4.

4.23.1.0

2025-07-15

KNOWN ISSUE

Offline maps: Applying a feature configuration may cause the `MapDownloader` to display an inaccurate size for a `Region`. This is a size reporting issue only and does not impact the actual size of the data stored on disk.

4.23.1.0

2025-07-15

KNOWN ISSUE

Offline search: The `OfflineSearchEngine` may occasionally return fewer results than requested, even when the expected results are available.

4.23.0.0

2025-07-08

CHANGED

Search: Removed deprecated APIs: `EVChargingPoolDetails.paymentIsRequired`, `EVChargingPoolDetails.subscriptionIsRequired`, and `EVChargingStation` constructor with 12 parameters. Please use the default constructor instead.

4.23.0.0

2025-07-08

CHANGED

Search: Removed deprecated APIs in `SearchEngine` and `OfflineSearchEngine`: `searchPickedPlace` - please use `searchByPickedPlace` instead; `searchByPlaceIdWithLanguageCode` - please use `searchByPlaceId` instead; `suggest` - please use `suggestByText` instead.

4.23.0.0

2025-07-08

ADDED

Navigation: The `DynamicRoutingEngine` has been extended to use `RoutingOptions` for route calculation.

4.23.0.0

2025-07-08

CHANGED

Map data: Renamed `SegmentDataLoaderException` to `MapDataLoaderException` and `SegmentDataLoaderErrorCode` to `MapDataLoaderErrorCode`.

4.23.0.0

2025-07-08

CHANGED

Routing: Deprecated `EVMobilityServiceProviderPreferences.excluded`. Please use other pereferences levels of `EVMobilityServiceProviderPreferences`.

4.23.0.0

2025-07-08

ADDED

Search: Added `EVChargingPool.access` that represents the accessibility level of the charging pool. Also available offline for Navigate users.

4.23.0.0

2025-07-08

CHANGED

Routing: Removed deprecated `sdk.routing.Toll.tollSystem`. Please use `sdk.routing.Toll.tollSystems` instead.

4.23.0.0

2025-07-08

CHANGED

Map view: Removed deprecated enum value `MapMeasureKind.distance`. Please use `MapMeasureKind.distanceInMeters` instead.

4.23.0.0

2025-07-08

CHANGED

Navigation: Removed the previously deprecated `Lane.directionCategory`. Please use instead `Lane.directions`.

4.23.0.0

2025-07-08

CHANGED

Navigation: Removed `NavigatorInterface.getManeuverNotificationTimingOptionsWithTimingProfile()` and `NavigatorInterface.setManeuverNotificationTimingOptionsWithTimingProfile()` with parameter of type RoadType. Please use `NavigatorInterface.getManeuverNotificationTimingOptionsWithTimingProfile()` and `NavigatorInterface.setManeuverNotificationTimingOptionsWithTimingProfile()` instead with parameter of type `TimingProfile`.

4.23.0.0

2025-07-08

CHANGED

Map view: Renamed `building3dModels` to `advancedBuildings` in the `MapFeatures` class. Also renamed `building3dModelsGrayscale` to `advancedBuildingsGrayscale`, `building3dModelsTextured` to `advancedBuildingsTextured`, and `building3dModelTextureless` to `advancedBuildingsTextureless` in the `MapFeatureModes` class.

4.23.0.0

2025-07-08

ADDED

We have released a new version of the [HERE SDK Reference Application](https://github.com/heremaps/here-sdk-ref-app-flutter ). With version [1.14.0](https://github.com/heremaps/here-sdk-ref-app-flutter/releases/tag/1.14.0 ), we added support for HERE SDK 4.22.0.0, upgrade to Flutter 3.27.4 (previously 3.27.2) and Dart 3.6.2 (previously 3.6.1), along with other minor fixes and improvements.

4.23.0.0

2025-07-08

ADDED

This version of the HERE SDK is delivered with map data v176 for `CatalogType.optimizedClientMap` catalog and v84 for `CatalogType.optimizedClientMapJapan` catalog.

4.23.0.0

2025-07-08

FIXED

Routing: Fixed an issue with `returnToRoute()` that may happen when using `AvoidanceOptions` options to avoid corridors, bounding boxes or polygons.

4.23.0.0

2025-07-08

CHANGED

Navigation: Removed `BorderCrossingWarningOptions.highwayWarningDistanceInMeters`, `BorderCrossingWarningOptions.ruralWarningDistanceInMeters`, `BorderCrossingWarningOptions.urbanWarningDistanceInMeters`. Removed `RealisticViewWarningOptions.highwayWarningDistanceInMeters`, `RealisticViewWarningOptions.ruralWarningDistanceInMeters`, `RealisticViewWarningOptions.urbanWarningDistanceInMeters`. Removed `RoadSignWarningOptions.highwayWarningDistanceInMeters`, `RoadSignWarningOptions.ruralWarningDistanceInMeters`, `RoadSignWarningOptions.urbanWarningDistanceInMeters`. Removed `SafetyCameraWarningOptions.highwayWarningDistanceInMeters`, `SafetyCameraWarningOptions.ruralWarningDistanceInMeters`, `SafetyCameraWarningOptions.urbanWarningDistanceInMeters`. Removed `TruckRestrictionsWarningOptions.highwayWarningDistanceInMeters`, `TruckRestrictionsWarningOptions.ruralWarningDistanceInMeters`, `TruckRestrictionsWarningOptions.urbanWarningDistanceInMeters`. Removed `DangerZoneWarningOptions` class, as it only contained properties related to warning notification distances, which have been deprecated and removed. Removed `EnvironmentalZoneWarningOptions` class, as it only contained properties related to warning notification distances, which have been deprecated and removed. Removed `LowSpeedZoneWarningOptions` class, as it only contained properties related to warning notification distances, which have been deprecated and removed. Removed `RailwayCrossingWarningOptions` class, as it only contained properties related to warning notification distances, which have been deprecated and removed. Removed `TollStopWarningOptions` class, as it only contained properties related to warning notification distances, which have been deprecated and removed. Removed `NavigatorInterface.environmentalZoneWarningOptions`, `NavigatorInterface.dangerZoneWarningOptions`, `NavigatorInterface.tollStopWarningOptions`, `NavigatorInterface.railwayCrossingWarningOptions`, `NavigatorInterface.lowSpeedZoneWarningOptions`. Please use the methods `NavigatorInterface.getWarningNotificationDistances` and `NavigatorInterface.setWarningNotificationDistances` instead to retrieve or configure the warning notification distances..

4.23.0.0

2025-07-08

ADDED

Search: Added `EVAccessRestrictionReason` that represents the restriction reason of an `EVChargingPool`. Added `EVChargingPool.accessRestrictionReasons` that contains the list of reasons for restriction, accessible by offline search when `access` is `EVAccessType.restrictedAccess`.

4.23.0.0

2025-07-08

FIXED

Navigation: Fixed a crash in `VisualNavigator` that occurred when a route segment had an unexpected length of 0 meters.

4.23.0.0

2025-07-08

FIXED

Navigation: Improved missed waypoint detection logic to reduce the impact of random errors and deviations. A waypoint is considered missed only if it is missed in two consecutive location updates.

4.23.0.0

2025-07-08

CHANGED

Routing: Removed the previously deprecated `RouteOptions.occupantsNumber` property. Please use `occupantsNumber` in corresponding transport mode options instead.

4.23.0.0

2025-07-08

CHANGED

Routing: Removed the previously deprecated `Waypoint.isChargingStation` property. Please use `chargingStop` property instead.

4.23.0.0

2025-07-08

FIXED

Navigation: When GPS precision is low, map-matched locations are used instead of raw positions all for vehicles except bicycles.

4.23.0.0

2025-07-08

CHANGED

The following countries have been deprecated from the CountryCode enum: `ala`, `atf`, `bvt`, `ggy`, `hmd`, `jey`, `umi`. Please use `fin`, `fra`, `nor`, `gbr`, `aus`, `gbr`, and `usa` respectively instead.

4.23.0.0

2025-07-08

ADDED

Positioning: On Android added altitude estimate with vertical accuracy into location estimates based on Wi-Fi signal observations.

4.23.0.0

2025-07-08

CHANGED

`Maneuver.roadType`, `Maneuver.nextRoadType` are deprecated. Instead, the road attributes determining the type of the road can be taken from `Span.streetAttributes` or from `SegmentSpanData.roadUsages`. These attributes can help determine whether a road is highway (if it has `StreetAttributes.ramp` or `StreetAttributes.motorway` attribute), urban (if it has the `StreetAttributes.builtUpArea` attribute) or rural otherwise. Additionally, the `Span.functionalRoadClass` can be used to determine the road type.

4.23.0.0

2025-07-08

ADDED

Map view: Removed the **beta** label for `MapPolyline.setRepresentaion()`. The API is now considered to be stable.

4.23.0.0

2025-07-08

ADDED

Documentation: Since the _Explore Edition_ is a subset of the _Navigate Edition_, we plan to merge the developer guides for both into a single developer guide. Features such as HERE Positioning, Navigation, Indoor Maps, and offline capabilities will remain exclusive to Navigate users. Editions will be referenced to as "licenses". Your existing Explore and Navigate credentials will continue to work as before, and we will continue to maintain support for both licenses through dedicated frameworks and API references. This change is planned for an upcoming release and will only affect the documentation.

4.23.0.0

2025-07-08

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.23.0.0

2025-07-08

KNOWN ISSUE

Navigation: When a `Route` contains a ferry `Section`, then false positive route deviations may be reported within that `Section`.

4.23.0.0

2025-07-08

KNOWN ISSUE

Support for Flutter 3.32 and later is not yet available. This release of the HERE SDK is compatible only with Flutter 3.27.4.

4.23.0.0

2025-07-08

KNOWN ISSUE

Offline maps: Applying a feature configuration may cause the `MapDownloader` to display an inaccurate size for a `Region`. This is a size reporting issue only and does not impact the actual size of the data stored on disk.

4.23.0.0

2025-07-08

KNOWN ISSUE

Offline search: The `OfflineSearchEngine` may occasionally return fewer results than requested, even when the expected results are available.

4.22.5.0

2025-06-10

ADDED

Offline routing: Added offline routing support for `Waypoint.chargingStop` to include additional charging stops. Previously, if a route was too long, the estimated charge at the destination could be negative, meaning the destination was not reachable without recharging. Now, the HERE SDK checks battery usage using `Span.consumptionInKilowattHours` and the remaining charge at each section using `Section.getArrivalPlace().getChargeInKilowattHours` to identify when and where to stop for charging. The `OfflineRoutingEngine` can now provide a route that leads to the destination with enough charge.

4.22.5.0

2025-06-10

FIXED

Navigation: Fixed a crash in the `OfflineRoutingEngine` during offline bicycle route calculation caused by an issue in maneuver generation for certain routes.

4.22.5.0

2025-06-10

ADDED

This version of the HERE SDK is delivered with map data v174 for `CatalogType.optimizedClientMap` catalog and v84 for `CatalogType.optimizedClientMapJapan` catalog.

4.22.5.0

2025-06-10

ADDED

Navigation: Added `routeDrawOrder` and `routeDrawOrderType` to the `VisualNavigator` to allow the user control over the draw order of the polylines representing the route.

4.22.5.0

2025-06-10

ADDED

Maploader: Added `ExternalMapDataSourceServer` and `ExternalMapDataSourceClient` classes to provide non-blocking gRPC functionality. These classes enable starting the service and configuring the connection asynchronously.

4.22.5.0

2025-06-10

CHANGED

Deprecated `ExternalMapDataSource` class. Please use `ExternalMapDataSourceServer` and `ExternalMapDataSourceClient` instead.

4.22.5.0

2025-06-10

FIXED

Positioning: Fixed a rare crash that could occur when `LocationEngine` requested an `Authentication` token.

4.22.5.0

2025-06-10

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.22.5.0

2025-06-10

KNOWN ISSUE

Navigation: When a `Route` contains a ferry `Section`, then false positive route deviations may be reported within that `Section`.

4.22.5.0

2025-06-10

KNOWN ISSUE

Offline maps: Applying a feature configuration may cause the `MapDownloader` to display an inaccurate size for a `Region`. This is a size reporting issue only and does not impact the actual size of the data stored on disk.

4.22.5.0

2025-06-10

KNOWN ISSUE

Offline search: The `OfflineSearchEngine` may occasionally return fewer results than requested, even when the expected results are available.

4.22.4.0

2025-05-28

ADDED

Maploader: Added `SslServerCredentialsOptions` and `SslClientCredentialsOptions` to allow configuration of certificate settings for more secure gRPC communication. This can be used only with `ExternalMapDataSource`. Don't use it when map content is used within a single process.

4.22.4.0

2025-05-28

ADDED

Routing: Added support for `Waypoint.currentWeightChangeInKilograms` for changing the current weight of the vehicle at waypoints. For example, this can be used when the vehicle takes additional cargo or unloads its cargo along the route. Note that this is also supported offline for the users of _Navigate Edition_.

4.22.4.0

2025-05-28

ADDED

Added new `MapMatcher` class for matching `Location` to `MapMatchedLocation`.

4.22.4.0

2025-05-28

ADDED

Navigation: Added `guidanceFrameRate` property to the `VisualNavigator`. It is now possible to optimize CPU/GPU usage by adjusting the rendering frame rate during navigation.

4.22.4.0

2025-05-28

FIXED

Navigation: Fixed a memory leak of about 10 MB per hour in the `VisualNavigator` that occurred when rendering was not started, i.e., when `startRendering()` was not called.

4.22.4.0

2025-05-28

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.22.4.0

2025-05-28

KNOWN ISSUE

Navigation: When a `Route` contains a ferry `Section`, then false positive route deviations may be reported within that `Section`.

4.22.4.0

2025-05-28

KNOWN ISSUE

Offline maps: Applying a feature configuration may cause the `MapDownloader` to display an inaccurate size for a `Region`. This is a size reporting issue only and does not impact the actual size of the data stored on disk.

4.22.4.0

2025-05-28

KNOWN ISSUE

Offline search: The `OfflineSearchEngine` may occasionally return fewer results than requested, even when the expected results are available.

4.22.3.0

2025-05-13

ADDED

Map style update: Added improved pedestrian and walkway path styling by adjusting color and width to enhance visual clarity. Note that this feature was already introduced with HERE SDK 4.21.4.0.

4.22.3.0

2025-05-13

ADDED

Map style update: Updated walkway and pedestrian road styles to ensure appropriate visibility at zoomed-out levels. Note that this feature was already introduced with HERE SDK 4.22.2.0.

4.22.3.0

2025-05-13

ADDED

Routing: Added new APIs to better support Electric Light Commercial Vehicles (eLCVs) and various types of trucks, such as light trucks under 7.5 tons. Extended the `RoutingEngine` and `OfflineRoutingEngine` to accept the new `RoutingOptions` class, which consolidates several existing option classes - including `CarOptions`, `TaxiOptions`, `TruckOptions`, and `RefreshRouteOptions` - into a unified configuration model. While the existing `RouteOptions` class can still be used as before, `RoutingOptions` provides the same capabilities in a more generic structure suitable for all supported transport modes. When creating a new route, make sure to specify `RoutingOptions.transportMode`. The new class also introduces extended routing configurations via the new classes `CommonRouteOptions`, `VehicleSpecification`, `ElectricVehicleOptions` with the new `EmpiricalConsumptionModel` and `PhysicalConsumptionModel`, and `TransportedCargo`. For example, it is now possible to specify whether a car is carrying cargo. Previously, this was only available for trucks. The existing `RouteOptions` can now be set under `CommonRouteOptions`. Note that this is a **beta** release of the new feature. Also, the `OfflineRoutingEngine` is only available in the _Navigate Edition_.

4.22.3.0

2025-05-13

FIXED

Navigation: Fixed the `RouteProgressListener` so that it is only called with `RouteProgress` from the active route. This resolves an issue where some events contained data from a previous route.

4.22.3.0

2025-05-13

ADDED

This version of the HERE SDK is delivered with map data v170 for `CatalogType.optimizedClientMap` catalog and v84 for `CatalogType.optimizedClientMapJapan` catalog.

4.22.3.0

2025-05-13

FIXED

Offline maps: While performing map operations, data is now compared across multiple translations.

4.22.3.0

2025-05-13

ADDED

Search for EV charging stations: The APIs `EVChargingPool`, `Details.evChargingPool`, `EVChargingStation`, `EMobilityServiceProvider`, `EVChargingPool.eMobilityServiceProviders`, `EVChargingPool.cpoId`, and `EVChargingPool.evseInfo` are now available to all customers and work with your standard credentials. Previously, these APIs were available only to our closed alpha group. Note that these APIs are also supported for the `OfflineRoutingEngine`, if available for your edition.

4.22.3.0

2025-05-13

FIXED

Navigation: Fixed an issue with `TrafficOnRoute`. Now, the `TrafficOnRoute` polylines remain unchanged after navigation starts using `VisualNavigator`.

4.22.3.0

2025-05-13

ADDED

Removed the **beta** label from the `horizontalAccuracyInMeters` field of `MapMatchedLocation`. The API is now considered to be stable.

4.22.3.0

2025-05-13

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.22.3.0

2025-05-13

KNOWN ISSUE

Navigation: When a `Route` contains ferry `Section`, false positive route deviations may be reported within that `Section`.

4.22.3.0

2025-05-13

KNOWN ISSUE

Offline maps: When a feature configuration is applied, then the `MapDownloader` does not accurately shows the updated size of a `Region`. However, this does not affect the actual size on disk.

4.22.3.0

2025-05-13

KNOWN ISSUE

Offline search: `OfflineSearchEngine` sometimes fails to return the requested number of results, even when the expected results are available.

4.22.2.0

2025-04-30

ADDED

Map view: Added support for changing font in `MapMarker`. Added constructor `MapMarkerTextStyle.withFont()` and a read-only `fontName` property.

4.22.2.0

2025-04-30

ADDED

Navigation: Added `EventText.distanceInMeters`, representing the distance to the event for which the `EventText` object is generated.

4.22.2.0

2025-04-30

ADDED

Map style update: Added new vehicle restriction icons for through-vehicles. The new add-on highlights restricted road segments which can be accessed if a delivery takes place on that segment.

4.22.2.0

2025-04-30

FIXED

Fixed the mapping between certain HTTP client status codes and the corresponding SDK error messages.

4.22.2.0

2025-04-30

ADDED

Added pedestrian path styling by removing dash patterns and improving visual clarity. Reviewed unpaved walkway relevance within driving-related use cases to ensure appropriate representation. Note that this feature was already introduced with the HERE SDK 4.21.4.0.

4.22.2.0

2025-04-30

ADDED

Offline routing: Added `SectionNoticeCode.noThroughRestriction` enum and use it during parsing of `SectionNotice` in `OfflineRoutingEngine`.

4.22.2.0

2025-04-30

FIXED

Navigation: Fixed `SpeedCameraWarning` template in ko-KR (Korean) voice package.

4.22.2.0

2025-04-30

ADDED

Routing: Added `BatterySpecifications.maxPowerAtLowVoltageInKilowatts` to allow vehicles which support 800V to use lower voltage charging stations.

4.22.2.0

2025-04-30

ADDED

Search: Added `PassThroughFeature` enum with `ONLINE_SEARCH` value. Enabling of this passthrough feature allows usage of online search in offline mode.

4.22.2.0

2025-04-30

CHANGED

Deprecated `SegmentSpanData.positiveDirectionAllowedTransportModes`, `SegmentSpanData.negativeDirectionAllowedTransportModes`, and `SegmentDataLoaderOptions.loadAllowedTransportModes`. Instead, please use `SegmentSpanData.allowedTransportModes` along with `SegmentDataLoaderOptions.loadTransportModesAccess`.

4.22.2.0

2025-04-30

FIXED

Positioning: Fixed a crash for Android platform that could occur when a nearby Wi-Fi network name (SSID) contained certain special characters.

4.22.2.0

2025-04-30

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.22.2.0

2025-04-30

KNOWN ISSUE

Navigation: When a `Route` contains ferry `Section`, false positive route deviations may be reported within that `Section`.

4.22.2.0

2025-04-30

KNOWN ISSUE

Offline maps: When a feature configuration is applied, then the `MapDownloader` does not accurately shows the updated size of a `Region`. However, this does not affect the actual size on disk.

4.22.2.0

2025-04-30

KNOWN ISSUE

Offline search: `OfflineSearchEngine` sometimes fails to return the requested number of results, even when the expected results are available.

4.22.1.0

2025-04-16

ADDED

Map view: Added gradient support for `MapPolyline` with adjustable length progress. Transition between `MapPolyline.lineColor` and `MapPolyline.progressColor` now renders gradually. The length of that transition can be specified with `MapPolyline.progressGradientLength` property specified in zoom-level dependent pixels.

4.22.1.0

2025-04-16

FIXED

Map view: Fixed the behavior of `MapLayer.setPriority()` to correctly remove any previously applied priorities before applying new ones. Fixed internal behaviour of `MapLayerPriorityBuilder` and the resulting `MapLayerPriority` when a layer (category) is defined more than once with `MapLayerPriorityBuilder`.
Previously, when chaining priorities, only in the case of two consecutive priority definitions for the same layer (category), the first one was overriden. Now, any previously defined priority in the chain for the same layer (category) is overriden.

4.22.1.0

2025-04-16

FIXED

Navigation: Fixed templates for the `zh-TW` voice package (Taiwanese) to correctly use traditional Pinyin characters.

4.22.1.0

2025-04-16

ADDED

Offline maps: This version of the HERE SDK is delivered with map data version v166 for `CatalogType.optimizedClientMap` catalog and v84 for `CatalogType.optimizedClientMapJapan` catalog.

4.22.1.0

2025-04-16

ADDED

Navigation: Removed deprecation of the `SafetyCameraWarningOptions` class, as the `enableTextNotification` option was added to enable or disable text notifications.

4.22.1.0

2025-04-16

FIXED

Navigation: Fixed `head to` template in zh-TW (Taiwanese Mandarin) voice package to avoid repetition.

4.22.1.0

2025-04-16

FIXED

Search: Fixed the behavior of `Place.deserialize` to handle missing enum `PlaceType`. If the `PlaceType` is missing in the serialized data, it is now set to `PlaceType.unknown` in the deserialized object. These features are also supported for the `OfflineSearchEngine`, if available for your edition.

4.22.1.0

2025-04-16

FIXED

Navigation: Fixed a null pointer access crash in `VisualNavigator` by adding a check for the map view object.

4.22.1.0

2025-04-16

CHANGED

Map style update: Removed the Microhood city labels from the map display because they cluttered the map and exist in just a few countries.

4.22.1.0

2025-04-16

FIXED

Fixed an Android platform issue with the Wi-Fi model cache that sometimes prevented calculating a network-based position estimate when the HERE SDK was in offline mode.

4.22.1.0

2025-04-16

KNOWN ISSUE

Map view: Flutter's _hot restart_ feature does not work when the map view is moved by performing a touch gesture. This results in an application freeze. More details can be found [here](https://github.com/flutter/flutter/issues/58987).

4.22.1.0

2025-04-16

KNOWN ISSUE

Navigation: When a `Route` contains ferry `Section`, false positive route deviations may be reported within that `Section`.

4.22.1.0

2025-04-16

KNOWN ISSUE

Offline maps: When a feature configuration is applied, then the `MapDownloader` does not accurately shows the updated size of a `Region`. However, this does not affect the actual size on disk.

4.22.1.0

2025-04-16

KNOWN ISSUE

Offline search: `OfflineSearchEngine` sometimes fails to return the requested number of results, even when the expected results are available.

Changelog

HERE SDK for Flutter (Navigate)

HERE SDK for Flutter (Explore)

HERE SDK for iOS (Navigate)

HERE SDK for iOS (Explore)

HERE SDK for Android (Navigate)

HERE SDK for Android (Explore)