HERE SDK for iOS (Navigate)

Version

Date

Change

Description

4.27.0.0

2026-07-10

Map view: Removed deprecated LocationIndicator.setMarker3dModel(_ model: MapMarker3DModel, scale: Double, type: LocationIndicator.MarkerType). Use the overload with the additional renderSizeUnit: RenderSize.Unit parameter instead.

4.27.0.0

2026-07-10

Map view: Removed deprecated MapCameraKeyframeTrack.lookAtDistance(keyframes: Array<ScalarKeyframe>, easing: Easing, interpolationMode: KeyframeInterpolationMode) method. Use MapCameraKeyframeTrack.lookAtDistance(ofKind: MapMeasure.Kind, keyframes: Array<ScalarKeyframe>, easing: Easing, interpolationMode: KeyframeInterpolationMode) instead.

4.27.0.0

2026-07-10

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

4.27.0.0

2026-07-10

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

4.27.0.0

2026-07-10

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

4.27.0.0

2026-07-10

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

4.27.0.0

2026-07-10

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

4.27.0.0

2026-07-10

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

4.27.0.0

2026-07-10

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

4.27.0.0

2026-07-10

Navigation: Removed the previously deprecated constructors for ManeuverNotificationOptions. Use the default constructor instead.

4.27.0.0

2026-07-10

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

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

4.27.0.0

2026-07-10

Navigation: Deprecated in NavigatorInterface: environmentalZoneWarningListenerDelegate, safetyCameraWarningDelegate, safetyCameraWarningOptions, dangerZoneWarningListenerDelegate, truckRestrictionsWarningDelegate, truckRestrictionsWarningOptions, roadSignWarningDelegate, roadSignWarningOptions, schoolZoneWarningDelegate, schoolZoneWarningOptions, realisticViewWarningDelegate, realisticViewWarningOptions, borderCrossingWarningDelegate, borderCrossingWarningOptions, tollStopWarningDelegate, railwayCrossingWarningDelegate, lowSpeedZoneWarningDelegate, trafficMergeWarningDelegate, trafficMergeWarningOptions, getWarningNotificationDistances, setWarningNotificationDistances. Deprecated structures/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

Warner: Introduced a unified warning model delivered through WarningDelegate.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

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

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

4.27.0.0

2026-07-10

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

4.27.0.0

2026-07-10

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

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

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

4.27.0.0

2026-07-10

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

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

4.26.5.0

2026-06-30

Navigation: Changed the return type of WarnerEngine.setWarningNotificationDistances(...) and WarnerEngine.setCustomWarningNotificationDistances(...) from Bool to Void.

4.26.5.0

2026-06-30

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

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

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

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

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

4.26.5.0

2026-06-30

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

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

4.26.5.0

2026-06-30

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

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

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

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

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

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

4.26.4.0

2026-07-10

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

4.26.4.0

2026-07-10

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

4.26.4.0

2026-07-10

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

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

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

Routing: Added support for section level notice in IndoorSectionDetails.

4.26.4.0

2026-07-10

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

4.26.4.0

2026-07-10

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

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

4.26.4.0

2026-07-10

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

4.26.4.0

2026-07-10

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

4.26.4.0

2026-07-10

Map view: Added MapView.setOwningScene(UIScene?) to allow setting owning scene in CarPlay use cases for proper handling of scene activation events.

4.26.4.0

2026-07-10

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

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

4.26.4.0

2026-07-10

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

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

4.26.4.0

2026-07-10

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

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

4.26.4.0

2026-07-10

Map view: Added new method UIColor DataAttributes.getColor() to get an attribute of type UIColor and DataAttributeBuilder.with(name: String, value: UIColor) to add an attribute of type UIColor.

4.26.4.0

2026-07-10

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

4.26.4.0

2026-07-10

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

4.26.4.0

2026-07-10

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

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

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

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

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

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

Map view: Modified a beta API by replacing property MapContext.MemoryManagementResult.resultCode by a boolean MapContext.MemoryManagementResult.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 MapContext.MemoryManagementResultCode.

4.26.4.0

2026-07-10

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

4.26.4.0

2026-07-10

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. For now, this includes only the Developer Guide. 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-07-10

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

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

4.26.4.0

2026-07-10

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

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

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

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

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

4.26.0.0

2026-05-19

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

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

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

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

4.26.0.0

2026-05-19

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

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

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

4.26.0.0

2026-05-19

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

4.26.0.0

2026-05-19

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

Renamed ElectronicHorizonEngine.addElectronicHorizonListener(electronicHorizonListener:) to ElectronicHorizonEngine.addElectronicHorizonDelegate(_:), ElectronicHorizonDataLoader.addElectronicHorizonDataLoaderStatusListener(electronicHorizonListener:) to ElectronicHorizonDataLoader.addElectronicHorizonDataLoaderStatusDelegate(_:), ElectronicHorizon.removeElectronicHorizonListener(electronicHorizonListener:) to ElectronicHorizon.removeElectronicHorizonDelegate(_:), and ElectronicHorizonDataLoader.removeElectronicHorizonDataLoaderStatusListener(electronicHorizonListener:) to ElectronicHorizonDataLoader.removeElectronicHorizonDataLoaderStatusDelegate(_:).

4.26.0.0

2026-05-19

Offline maps: Changed the default layer configuration by removing LayerConfiguration.Feature.truck from SDKOptions.layerConfiguration.enabledFeatures. By default, 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

Offline maps: Changed the default layer configuration by removing LayerConfiguration.Feature.detailRendering, LayerConfiguration.Feature.offlineSearch, LayerConfiguration.Feature.offlineRouting, LayerConfiguration.Feature.rendering and LayerConfiguration.Feature.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

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

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

Navigation: Added locationManager to NavigatorProtocol 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

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

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

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

4.26.0.0

2026-05-19

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

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

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

Map view: Added MapPolyline.SolidMultiColorRepresentation 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

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

4.26.0.0

2026-05-19

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

4.26.0.0

2026-05-19

Routing: Deprecated RoutingEngine.refreshRoute(...) with explicit waypoint, last section and distance arguments. Please use RoutingEngine.refreshRoute(...) method with a RefreshRouteParameters parameter.

4.26.0.0

2026-05-19

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

4.26.0.0

2026-05-19

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

Offline routing: Added OfflineRoutingEngine.refreshRoute(...) method.

4.26.0.0

2026-05-19

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

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

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

4.26.0.0

2026-05-19

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

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

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

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

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

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

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

Map view: Renamed MapContext.setMemoryManagementOptions(MemoryManagementOptions, SetVideoMemoryLimitCompletionHandler) and the completion handler MapContext.SetVideoMemoryLimitCompletionHandler(Int32). Use MapContext.setMemoryManagementOptions(MemoryManagementOptions, SetMemoryManagementOptionsCompletionHandler) and the completion handler MapContext.SetMemoryManagementOptionsCompletionHandler(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

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

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

4.25.5.0

2026-04-14

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

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

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

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

4.25.5.0

2026-04-14

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

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

4.25.5.0

2026-04-14

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

4.25.5.0

2026-04-14

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

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

4.25.5.0

2026-04-14

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

4.25.5.0

2026-04-14

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

4.25.5.0

2026-04-14

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

Deprecated the TransportProfile class. Use TransportSpecification instead.

4.25.5.0

2026-04-14

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

4.25.5.0

2026-04-14

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

4.25.5.0

2026-04-14

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

4.25.5.0

2026-04-14

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

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

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

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

4.25.4.0

2026-03-10

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

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

4.25.4.0

2026-03-10

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

4.25.4.0

2026-03-10

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

4.25.4.0

2026-03-10

Removed ElectronicHorizonPositionDelegate interface. Position updates are now delivered through the unified ElectronicHorizonDelegate.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

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

Routing: Deprecated IsolineOptions constructor with CarOptions parameter. Use the IsolineOptions constructor with RoutingOptions parameter instead. Deprecated IsolineOptions constructor with TruckOptions parameter. Use the IsolineOptions constructor with RoutingOptions parameter instead. Deprecated IsolineOptions constructor with EVCarOptions parameter. Use the IsolineOptions constructor with RoutingOptions parameter instead. Deprecated IsolineOptions constructor with EVTruckOptions parameter. Use the IsolineOptions constructor with RoutingOptions parameter 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

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

Map view: Added LayerConfiguration.Feature.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

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

4.25.4.0

2026-03-10

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

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

4.25.4.0

2026-03-10

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

4.25.4.0

2026-03-10

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

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

4.25.4.0

2026-03-10

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

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

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

4.25.4.0

2026-03-10

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

4.25.4.0

2026-03-10

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

Map view: Added following functions to MapContext, MapContext.getMemoryManagementOptions(), MapContext.setMemoryManagementOptions(MemoryManagementOptions,SetVideoMemoryLimitCompletionHandler), and lambda MapContext.SetVideoMemoryLimitCompletionHandler(Int32). 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

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

Navigation: ZoomPolicy of TrackingCameraBehavior converted from protocol to class to allow easy calling of its static methods. The API is still in beta status.

4.25.3.0

2026-02-19

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

Navigation: Corrected implementation of setting fixed bearing in TrackingCameraBehavior.

4.25.3.0

2026-02-19

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

4.25.3.0

2026-02-19

Routing: Removed beta status for RoutingOptions, RoutingInterface.calculateRoute(...), Route.routingOptions and RoutingEngine.refreshRoute(...) with RoutingOptions parameter types, RoutingEngine.importRoute(...) with RoutingOptions parameter types. The APIs are considered to be stable.

4.25.3.0

2026-02-19

Offline routing: Removed beta status for OfflineRoutingEngine.importRoute(...) with RoutingOptions parameter type. The API is now considered to be stable.

4.25.3.0

2026-02-19

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

4.25.3.0

2026-02-19

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

4.25.3.0

2026-02-19

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

4.25.3.0

2026-02-19

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

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

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

4.25.2.0

2026-02-06

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

4.25.2.0

2026-02-06

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

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

4.25.2.0

2026-02-06

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

4.25.2.0

2026-02-06

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

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

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

Routing: Deprecated RoutingEngine.importRoute(...) methods that accept profile-specific option types (CarOptions, PedestrianOptions, BicycleOptions, ScooterOptions, TruckOptions, TaxiOptions, BusOptions, PrivateBusOptions, EVCarOptions, EVTruckOptions, RefreshRouteOptions). Use the RoutingEngine.importRoute(...) methods with RoutingOptions 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

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

Routing: Deprecated RoutingInterface.calculateRoute(...) methods that accept profile-specific option types (CarOptions, PedestrianOptions, TruckOptions, ScooterOptions, BicycleOptions, TaxiOptions, EVCarOptions, EVTruckOptions, BusOptions, PrivateBusOptions). Use the RoutingInterface.calculateRoute(...) method with RoutingOptions 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

Routing: Deprecated RoutingEngine.refreshRoute(...) methods with RefreshRouteOptions as parameter. Use the RoutingEngine.refreshRoute(...) methods with RoutingOptions parameter 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

Offline routing: Deprecated OfflineRoutingEngine.importRoute(...) method with RefreshRouteOptions as parameter. Use the OfflineRoutingEngine.importRoute(...) method with RoutingOptions parameter 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

Navigation: Deprecated DynamicRoutingEngine.start(...) method with RefreshRouteOptions as parameter. Use the DynamicRoutingEngine.start(...) method with RoutingOptions parameter 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

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

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

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

4.25.2.0

2026-02-06

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

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.loadScene(_:completion:): 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

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

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

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

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

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

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

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

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

4.25.1.0

2026-01-20

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

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

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

4.25.1.0

2026-01-20

Map view: Deprecated MapContentSettings.configureVehicleRestrictionFilter(transportMode:truckSpecifications:hazardousMaterials:tunnelCategory:) method, use MapContentSettings.configureVehicleRestrictionFilter(transportSpecs:) instead.

4.25.1.0

2026-01-20

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

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

4.25.1.0

2026-01-20

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 ParameterConfiguration.transportSpecification, which contains the default attribute values for attributes for vehicle, pedestrian, scooter and taxi specification.

4.25.1.0

2026-01-20

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

4.25.1.0

2026-01-20

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

4.25.1.0

2026-01-20

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

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

4.25.1.0

2026-01-20

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

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

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

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

4.25.0.0

2025-12-19

Routing: Removed the previously deprecated RoadType type. Use TimingProfile instead. Removed the previously deprecated Maneuver.roadType and 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

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

4.25.0.0

2025-12-19

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

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

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

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

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

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

4.25.0.0

2025-12-19

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

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

4.25.0.0

2025-12-19

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.

4.25.0.0

2025-12-19

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

4.25.0.0

2025-12-19

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

4.25.0.0

2025-12-19

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

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

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

4.25.0.0

2025-12-19

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

4.25.0.0

2025-12-19

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

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

Map view: Fixed incorrect interpolation for animations created from updates built by MapCameraUpdateFactory.lookAt(target: GeoCoordinatesUpdate, orientation: GeoOrientationUpdate, measure: MapMeasure), MapCameraUpdateFactory.lookAt(target: GeoCoordinatesUpdate, measure: MapMeasure), MapCameraUpdateFactory.lookToMatch(geoPoint: GeoCoordinates, viewPoint: Point2D, orientation: GeoOrientationUpdate, measure: MapMeasure) and MapCameraUpdateFactory.zoomTo(zoomLevel: Double) as well as animations created via MapCameraAnimationFactory.flyTo(target: GeoCoordinatesUpdate, zoom: MapMeasure, bowFactor: Double, duration: TimeInterval). Such animations did not interpolate correctly MapMeasure values for MapMeasure.Kind.zoomLevel and MapMeasure.Kind.scale but fell back to MapMeasure.Kind.distanceInMeters.

4.24.5.0

2025-11-27

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

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

4.24.5.0

2025-11-27

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

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

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

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

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

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

Electronic horizon : Added property route to ElectronicHorizon.

4.24.5.0

2025-11-27

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

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

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

4.24.5.0

2025-11-27

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

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

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

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

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

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

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

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

4.24.4.0

2025-11-12

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

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

4.24.4.0

2025-11-12

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

Map view: Updated MapView.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

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

4.24.4.0

2025-11-12

Navigation: Added 'speedInMetersPerSecondandtimestamptoMapMatchedLocation' 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 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

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

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

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

Map view: Added lookAtDistance(ofKind: MapMeasure.Kind, keyframes: [ScalarKeyframe], easing: Easing, interpolationMode: KeyframeInterpolationMode) method to MapCameraKeyframeTrack to support retrieving Kind measures such as distance, zoom, and scale level.

4.24.3.0

2025-11-03

Map view: Deprecated the MapCameraKeyframeTrack.lookAtDistance(keyframes: [ScalarKeyframe], easing: Easing, interpolationMode: KeyframeInterpolationMode). Use MapCameraKeyframeTrack.lookAtDistance(ofKind: MapMeasure.Kind, keyframes: [ScalarKeyframe], easing: Easing, interpolationMode: KeyframeInterpolationMode) instead.

4.24.3.0

2025-11-03

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

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

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

4.24.3.0

2025-11-03

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

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

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

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

4.24.3.0

2025-11-03

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

4.24.3.0

2025-11-03

Map view: Added the method setMarker3dModel(_:scale:type: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

Map view: Deprecated the LocationIndicator.setMarker3dModel(_:scale:type:) method. Use the new LocationIndicator.setMarker3dModel(_:scale:type:renderSizeUnit:) overloaded method instead.

4.24.3.0

2025-11-03

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

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

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

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

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

4.24.2.0

2025-10-13

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

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

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

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

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

Navigation: Fixed eventTextDelegate.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

Navigation: Fixed CurrentSituationLaneAssistanceViewDelegate, ManeuverViewLaneAssistanceDelegate, and JunctionViewLaneAssistanceDelegate 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

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

4.24.2.0

2025-10-13

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

4.24.2.0

2025-10-13

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

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

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 AdministrativeRulesLoader.getStateCode() by removing duplicate state codes from the result.

4.24.1.0

2025-10-01

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

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

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

4.24.1.0

2025-10-01

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

4.24.1.0

2025-10-01

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

4.24.1.0

2025-10-01

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 loadDirectedSegmentData to SegmentDataLoader to enable loading data for directed segments.

4.24.1.0

2025-10-01

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

4.24.1.0

2025-10-01

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

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

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 sdk.mapdata.SegmentSpanData.urban to identify road or ferry segment spans located within a built-up area.

4.24.1.0

2025-10-01

Search: Removed WebImage.date and WebImage.publicationDate. The date information is no longer provided. Removed WebImage constructors that accept Date, use the constructor that accepts only WebSource instead.

4.24.1.0

2025-10-01

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

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

Indoor map: Removed deprecated method Property.toString(), use the default swift provided method.

4.24.1.0

2025-10-01

Indoor map: Removed deprecated method VenueModel.identifier: String.

4.24.1.0

2025-10-01

Indoor map: Removed deprecated method VenueTopology.center.

4.24.1.0

2025-10-01

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

4.24.1.0

2025-10-01

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

4.24.1.0

2025-10-01

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

4.24.1.0

2025-10-01

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

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

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

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

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

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

4.24.0.0

2025-09-17

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

4.24.0.0

2025-09-17

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

4.24.0.0

2025-09-17

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

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

4.24.0.0

2025-09-17

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

4.24.0.0

2025-09-17

Map view: Changed type of PickMapContentResult.VehicleRestrictionResult.vehicleRestriction from VehicleRestriction? to VehicleRestriction.

4.24.0.0

2025-09-17

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

4.24.0.0

2025-09-17

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

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

4.24.0.0

2025-09-17

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

4.24.0.0

2025-09-17

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

4.24.0.0

2025-09-17

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

4.24.0.0

2025-09-17

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

4.24.0.0

2025-09-17

Routing: Removed evDetails from Route. Use consumptionInKilowattHours instead.

4.24.0.0

2025-09-17

Routing: Removed evDetails from Section. Use consumptionInKilowattHours instead.

4.24.0.0

2025-09-17

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

4.24.0.0

2025-09-17

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

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

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

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

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

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

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

4.23.5.0

2025-09-03

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

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

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

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

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

4.23.5.0

2025-09-03

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

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

4.23.5.0

2025-09-03

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

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

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

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

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

4.23.5.0

2025-09-03

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

4.23.5.0

2025-09-03

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

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

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

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

4.23.4.0

2025-08-21

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

4.23.4.0

2025-08-21

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

Map view: Added MapFeatures.truckPreferredRoads feature with MapFeatureModes.truckPreferredRoadsAll mode. When enabled, the .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

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

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

4.23.4.0

2025-08-21

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

4.23.4.0

2025-08-21

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

4.23.4.0

2025-08-21

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

4.23.4.0

2025-08-21

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

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

4.23.4.0

2025-08-21

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

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 nil. Highway sections are now considered in the same way as with the online RoutingEngine.

4.23.4.0

2025-08-21

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

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

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

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

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

4.23.3.0

2025-08-05

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

4.23.3.0

2025-08-05

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

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

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

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

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

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

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

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 TruckSpecifications.currentWeightInKilograms field to indicate the current weight of the vehicle.

4.23.2.0

2025-07-23

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

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

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

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

4.23.2.0

2025-07-23

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

4.23.2.0

2025-07-23

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

4.23.2.0

2025-07-23

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

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

4.23.2.0

2025-07-23

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

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

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

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

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

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

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

4.23.1.0

2025-07-15

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

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

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

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

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

4.23.1.0

2025-07-15

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

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

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

4.23.1.0

2025-07-15

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

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

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

Search: Removed deprecated APIs: EVChargingPoolDetails.paymentIsRequired, and EVChargingPoolDetails.subscriptionIsRequired.

4.23.0.0

2025-07-08

Search: Removed deprecated APIs in SearchEngine and OfflineSearchEngine: search(TextQuery, SearchOptions, SearchCallback) – please use searchByText instead; search(AddressQuery, SearchOptions, SearchCallback) – please use searchByAddress instead; search(CategoryQuery, SearchOptions, SearchCallback) – please use searchByCategory instead; search(GeoCoordinates, SearchOptions, SearchCallback) – please use searchByCoordinates instead; searchPickedPlace(PickedPlace, LanguageCode, PlaceIdSearchCallback) – please use searchByPickedPlace instead; search(PlaceIdQuery, LanguageCode, PlaceIdSearchCallback) – please use searchByPlaceId instead; suggest(TextQuery, SearchOptions, SuggestCallback) – please use suggestByText instead.

4.23.0.0

2025-07-08

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

4.23.0.0

2025-07-08

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

4.23.0.0

2025-07-08

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

4.23.0.0

2025-07-08

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

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

4.23.0.0

2025-07-08

Map view: Removed deprecated enum value MapMeasure.Kind.distance. Please use MapMeasure.Kind.distanceInMeters instead.

4.23.0.0

2025-07-08

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

4.23.0.0

2025-07-08

Navigation: Removed NavigatorProtocol.getManeuverNotificationTimingOptions() and NavigatorProtocol.setManeuverNotificationTimingOptions() with parameter of type RoadType. Please use NavigatorProtocol.getManeuverNotificationTimingOptions() and NavigatorProtocol.setManeuverNotificationTimingOptions() instead with parameter of type TimingProfile.

4.23.0.0

2025-07-08

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

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

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

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

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

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

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

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

4.23.0.0

2025-07-08

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

4.23.0.0

2025-07-08

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

4.23.0.0

2025-07-08

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

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

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

4.23.0.0

2025-07-08

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

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

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

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

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

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

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

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

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

Deprecated ExternalMapDataSource class. Please use ExternalMapDataSourceServer and ExternalMapDataSourceClient instead.

4.22.5.0

2025-06-10

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

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

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

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

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 new MapMatcher class for matching Location to MapMatchedLocation.

4.22.4.0

2025-05-28

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

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

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

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

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

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

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

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

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

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

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

4.22.3.0

2025-05-13

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

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

4.22.3.0

2025-05-13

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

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

4.22.3.0

2025-05-13

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

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

Map view: Added support for changing font in MapMarker. Added initializer to MapMarker.TextStyle with font name parameter and a read-only fontName property.

4.22.2.0

2025-04-30

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

4.22.2.0

2025-04-30

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 the mapping between certain HTTP client status codes and the corresponding SDK error messages.

4.22.2.0

2025-04-30

Map style update: 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

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

4.22.2.0

2025-04-30

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

4.22.2.0

2025-04-30

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

4.22.2.0

2025-04-30

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

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

4.22.2.0

2025-04-30

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

4.22.2.0

2025-04-30

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

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

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

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

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

4.22.1.0

2025-04-16

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

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

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

4.22.1.0

2025-04-16

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

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

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

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

4.22.1.0

2025-04-16

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

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