GuidesChangelogHERE SDK ChangelogsHERE SDK API references
Changelog

HERE SDK for Flutter (Explore)

Version

Date

Change

Description

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

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

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

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. With version 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

ADDED

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

4.25.5.0

2026-04-14

CHANGED

Deprecated the TransportProfile class. Use TransportSpecification instead.

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.

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

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 can be seen in the HERE Style Editor documentation.

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

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.

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

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

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.

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

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 theRoutingEngine.importRouteWithStopsAndRoutingOptions(...)method instead. DeprecatedRoutingEngine.importRouteFromHandle(...)method. Use theRoutingEngine.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

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

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.

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

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

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<HazardousMaterial>?, 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

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

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

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.

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.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

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

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

CHANGED

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

4.25.0.0

2025-12-19

ADDED

We have released a new version of the HERE SDK Reference Application. With version 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

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.

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.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

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.

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

FIXED

Fixed an issue where SDK could request a large number of traffic tiles, resulting in increased mobile data consumption.

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.

4.24.3.0

2025-11-03

ADDED

Map view: Added lookAtDistanceWithKind(MapMeasureKind, List<ScalarKeyframe>, 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<ScalarKeyframe>, Easing, KeyframeInterpolationMode). Use MapCameraKeyframeTrack.lookAtDistanceWithKind(MapMeasureKind, List<ScalarKeyframe>, Easing, KeyframeInterpolationMode) instead.

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.

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

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

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.

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. Version 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

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

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

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 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

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.

4.24.0.0

2025-09-17

CHANGED

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

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.

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

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.

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

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

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.

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

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

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.

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

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

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

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.

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

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

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

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.

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.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

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

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. With version 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

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

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

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

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

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.

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.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.

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

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.

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

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

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.

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

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

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

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.

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

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

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

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.