GuidesAPI referencesChangelogs
Guides
  1. HERE SDK for Android Developer Guide
  2. Introduction

Licenses explained

The HERE SDK for Android is available in two different licenses (formerly known as editions):

  1. Explore license: A subset of the Navigate license with features such as online search and routing for multiple transport modes including car, bus, truck and electric vehicles.
  2. Navigate license: The most feature-rich license that includes online / offline turn-by-turn navigation and other advanced features.

A few of the features that are available exclusively as part of the Navigate license:

  • Turn-by-turn-navigation
  • Offline map data as downloadable countries or regions, offline search and offline routing
  • HERE Positioning

While each license provides a tailored map experience, both licenses feature the integration of the HERE Rendering Engine:

  • The HERE Rendering Engine offers visually appealing true 3D maps that provide a smooth map experience and highly performant map.
  • Benefit from features such as multiple map view instances, an integrated tool chain for map customization, full 3D camera control and seamless map scheme switches.

Internally, each license of the HERE SDK 4.x shares a set of common modules. For example, the SearchEngine is part of a module that is used by all licenses. Therefore, such functionality and the related APIs are the same for both licenses. On top, all features of the Explore license are also available for the Navigate license. However, the HERE SDK (Explore) uses a more light-weighted map data format.

If you are still unsure what license you should choose, try to answer the following questions:

  • Do you want to offer the best and most advanced map experience, but you do not need any of the advanced features such as navigation? Then you might want to choose the Explore license.
  • Does your app rely on any of the available advanced features? Choose the Navigate license.
  • The Navigate license is only available for customers who have signed a contract with HERE Technologies. Are you waiting for your license? Consider starting with the Explore license, which offers a subset of the same APIs available with the Navigate license.

A more detailed overview of the available features can be found in the feature list.

In addition, the 4.x version of the HERE SDK is available for Flutter to build apps for iOS and Android from a single codebase written in Dart. You can learn more about all available HERE SDKs here.

Version
Date
Change
Description
4.27.3.0
2026-09-02
CHANGED
Routing: Deprecated non-default constructors for Waypoint and Waypoint.transitRadiusInMeters, please use Waypoint.radiusInMeters instead.
4.27.3.0
2026-09-02
ADDED
Routing: Added Waypoint.radiusInMeters as distance for candidates of a road to be used as a waypoint for the route calculation. It replaces the deprecated Waypoint.transitRadiusInMeters.
4.27.3.0
2026-09-02
CHANGED
To ensure application stability and reliable map rendering, certain graphics features and the rendering of semi-transparent map content are automatically adjusted or restricted on devices using PowerVR Rogue GPUs, Adreno 730-740 GPUs, or ARM Mali-g series GPU drivers version 32-38. On affected devices, enabling these features or rendering semi-transparent map content may increase memory usage and lead to application freezes or map view instability. The MapFeatures.AMBIENT_OCCLUSION and MapFeatures.SHADOWS will be prohibited, even if there is a request to enable them. MapFeatures.CONGESTION_ZONES, MapFeatures.ENVIRONMENTAL_ZONES, MapFeatures.LOW_SPEED_ZONES and roads in MapScheme.HYBRID_DAY, MapScheme.HYBRID_NIGHT, MapScheme.LITE_HYBRID_DAY, MapScheme.LITE_HYBRID_NIGHT, MapScheme.LOGISTICS_HYBRID_DAY, MapScheme.LOGISTICS_HYBRID_NIGHT display visible darkening due to overlapping rendering. Roads show this darkening at the road segment junctions. For semi-transparent MapPolyline, the polylines will lose their transparency. Furthermore, MapFeatures.TERRAIN with MapFeatureModes.TERRAIN_3D will be automatically switched to MapFeatureModes.TERRAIN_HILLSHADE if the GPU is PowerVR Rogue.
4.27.3.0
2026-09-02
FIXED
Routing: Fixed RoutingError.INVALID_PARAMETER on EV routes that use RouteHandle based route calculations that happens when calling RoutingEngine.setCustomOption(String, String) with options that are not supported by the backend. The options are ignored.
4.27.3.0
2026-09-02
FIXED
Map view: Improved MapPolyline rendering when offscreen rendering is disabled. Semi-transparent polylines now maintain transparency and blend colors as expected. As a result, overlapping regions may be visible depending on the LineCap type used.
4.27.3.0
2026-09-02
ADDED
This release is a Long-Term Support (LTS) release. LTS releases provide a supported production baseline for customers. Each LTS release is supported for six months, from its release date until the next LTS release becomes available. Hotfixes are provided only for currently supported LTS releases and are limited to critical issues.
4.27.2.0
2026-08-06
CHANGED
Map view: Changed MapPolyline.SolidMultiColorRepresentation so that 1.0 must be the last color stop. Note that this is a beta release of this feature.
4.27.2.0
2026-08-06
ADDED
Map view: Added TileKey.fromGeoCoordinates(GeoCoordinates coordinates, int storageLevel, TilingScheme tilingScheme) factory method for creating TileKey objects containing specific geo-coordinates.
4.27.2.0
2026-08-06
CHANGED
Map view: Moved HereMap.getStyle() to MapScene.getStyle(). Note that this is a beta release of this feature.
4.27.2.0
2026-08-06
FIXED
Map view: Fixed bridge rendering in MapScene to hide bridge building geometries (extruded buildings, footprints, and labels) when they overlap with road geometry.
4.27.2.0
2026-08-06
ADDED
Map view: Added support to render a MapMarker icon above overlapping marker icons while still allowing its text label to participate in collision detection and be hidden. See MapMarker.isIconOverlapAllowed() and MapMarker.setIconOverlapAllowed() for details. This setting has no effect when MapMarker.isOverlapAllowed() is true.
4.27.2.0
2026-08-06
FIXED
Routing: Fixed RoutingError.INVALID_PARAMETER that occurred when BatterySpecifications.connectorTypes contained both ChargingConnectorType.TESLA and ChargingConnectorType.SAE_J3400. Route calculation now continues with ChargingConnectorType.SAE_J3400.
4.27.2.0
2026-08-06
CHANGED
Release process: Changed the HERE SDK release cadence from a bi-weekly schedule to a structured monthly cycle with 12 planned releases per year: 6 Minor releases, 4 Major releases, and 2 LTS (Long-Term Support) releases. Designated LTS releases serve as the supported production baseline for customers and are supported for 6 months from their release date, until the next LTS release. Hotfixes are provided only for supported LTS releases and are limited to critical issues. This process takes effect with 4.27.3_LTS, currently planned for September 2, 2026.
4.27.2.0
2026-08-06
KNOWN ISSUE
Map view: To ensure application stability and reliable map rendering, certain graphics features and the rendering of semi-transparent map content are automatically adjusted or restricted on devices using PowerVR Rogue GPUs, Adreno 730-740 GPUs, or ARM Mali GPU drivers version 32-38. On affected devices, enabling these features or rendering semi-transparent map content may increase memory usage and lead to application freezes or map view instability. The MapFeatures.AMBIENT_OCCLUSION and MapFeatures.SHADOWS will be prohibited, even if there is a request to enable them. MapFeatures.CONGESTION_ZONES, MapFeatures.ENVIRONMENTAL_ZONES, MapFeatures.LOW_SPEED_ZONES and roads in MapScheme.HYBRID_DAY, MapScheme.HYBRID_NIGHT, MapScheme.LITE_HYBRID_DAY, MapScheme.LITE_HYBRID_NIGHT, MapScheme.LOGISTICS_HYBRID_DAY, MapScheme.LOGISTICS_HYBRID_NIGHT display visible darkening due to overlapping rendering. Roads show this darkening at the road segment junctions. For semi-transparent MapPolyline, the polylines will lose their transparency. Furthermore, MapFeatures.TERRAIN with MapFeatureModes.TERRAIN_3D will be automatically switched to MapFeatureModes.TERRAIN_HILLSHADE if the GPU is PowerVR Rogue.
4.27.1.0
2026-07-27
ADDED
Map view: Added MapScene.addMapPolylineLayer(String, MapLayerPriority) to create a named polyline layer at a specific render priority. Added MapScene.addMapPolyline(MapPolyline, String) and MapScene.addMapPolylines(List<MapPolyline>, String) to add polylines to a named layer. Added MapScene.removeMapPolylineLayer(String) to remove a named polyline layer and all polylines it contains.
4.27.1.0
2026-07-27
ADDED
Map view: Added MapContext.SceneLoadCacheOptions and MapContext.MemoryManagementOptions.sceneLoadCacheOptions for scene load cache customization. Note that this is a beta release of this feature.
4.27.1.0
2026-07-27
CHANGED
Removed HazardousMaterialRestriction.hazardousMaterial. Use HazardousMaterialRestriction.hazardousMaterials instead.
4.27.1.0
2026-07-27
ADDED
Added support for distributing all-in-one bundles via an Artifactory Maven repository. The following bundles are available via Gradle dependency resolution: here-sdk-explore, here-sdk-navigate. Refer to the integration guide (https://docs.here.com/here-sdk/docs/android-integrate-here-sdk) for details. Note that this is a beta release of this feature.
4.27.1.0
2026-07-27
ADDED
Added support for modularization and for distributing required components via an Artifactory Maven repository. The following components are available via an Artifactory Maven repository: here-sdk-core, here-sdk-electronic-horizon, here-sdk-map-advanced, here-sdk-map-data, here-sdk-map-loader-remote-connection, here-sdk-map-loader, here-sdk-map-matcher, here-sdk-navigation-core, here-sdk-navigation, here-sdk-positioning, here-sdk-routing-core, here-sdk-routing-dynamic, here-sdk-routing-isoline, here-sdk-routing-offline, here-sdk-routing-online, here-sdk-routing-transit, here-sdk-search-offline, here-sdk-search-online, here-sdk-traffic-broadcast, here-sdk-traffic, here-sdk-visual-navigation. The following components require the Navigate license: here-sdk-electronic-horizon, here-sdk-map-advanced, here-sdk-map-data, here-sdk-map-loader-remote-connection, here-sdk-map-loader, here-sdk-map-matcher, here-sdk-navigation-core, here-sdk-navigation, here-sdk-positioning, here-sdk-routing-dynamic, here-sdk-routing-offline, here-sdk-search-offline, here-sdk-traffic-broadcast, here-sdk-visual-navigation. Refer to the integration guide (https://docs.here.com/here-sdk/docs/android-integrate-here-sdk) for details. Note that this is a beta release of this feature.
4.27.1.0
2026-07-27
KNOWN ISSUE
To ensure application stability and reliable map rendering, certain graphics features and the rendering of semi-transparent map content are automatically adjusted or restricted on devices using PowerVR Rogue GPUs, Adreno 730-740 GPUs, or ARM Mali GPU drivers version 32-38. On affected devices, enabling these features or rendering semi-transparent map content may increase memory usage and lead to application freezes or map view instability. The MapFeatures.AMBIENT_OCCLUSION and MapFeatures.SHADOWS will be prohibited, even if there is a request to enable them. MapFeatures.CONGESTION_ZONES, MapFeatures.ENVIRONMENTAL_ZONES, MapFeatures.LOW_SPEED_ZONES and roads in MapScheme.HYBRID_DAY, MapScheme.HYBRID_NIGHT, MapScheme.LITE_HYBRID_DAY, MapScheme.LITE_HYBRID_NIGHT, MapScheme.LOGISTICS_HYBRID_DAY, MapScheme.LOGISTICS_HYBRID_NIGHT display visible darkening due to overlapping rendering. Roads show this darkening at the road segment junctions. For semi-transparent MapPolyline, the polylines will lose their transparency. Furthermore, MapFeatures.TERRAIN with MapFeatureModes.TERRAIN_3D will be automatically switched to MapFeatureModes.TERRAIN_HILLSHADE if the GPU is PowerVR Rogue.
4.27.0.0
2026-07-10
CHANGED
Map view: Removed deprecated LocationIndicator.setMarker3dModel(MapMarker3DModel, double, LocationIndicator.MarkerType). Use LocationIndicator.setMarker3dModel(MapMarker3DModel, double, LocationIndicator.MarkerType, RenderSize.Unit) instead.
4.27.0.0
2026-07-10
CHANGED
Map view: Removed deprecated MapCameraKeyframeTrack.lookAtDistance(List<ScalarKeyframe>, Easing, KeyframeInterpolationMode) method. Use MapCameraKeyframeTrack.lookAtDistance(MapMeasure.Kind, List<ScalarKeyframe>, Easing, KeyframeInterpolationMode) instead.
4.27.0.0
2026-07-10
CHANGED
Routing: Removed the previously deprecated ViolatedRestriction.forbiddenTruckType. Use ViolatedRestriction.Details.forbiddenTruckCategory instead.
4.27.0.0
2026-07-10
CHANGED
Core: Removed the previously deprecated VehicleSpecification.truckType. Use VehicleSpecification.truckCategory instead.
4.27.0.0
2026-07-10
CHANGED
Core: Removed deprecated LockingProcess.getLockingProcessId(SDKOptions) and LockingProcess.destroyLockingProcess(SDKOptions, long). Use LockingProcess.getLockingProcessId(Context, SDKOptions) and LockingProcess.destroyLockingProcess(Context, SDKOptions, long) instead.
4.26.5.0
2026-06-30
ADDED
Map view: Added RoadShieldIconProperties.isoCountryCode and Span.getIsoCountryCode() to provide a type-safe country code value, aligned with other HERE SDK APIs.
4.26.5.0
2026-06-30
CHANGED
Map view: Deprecated RoadShieldIconProperties.countryCode. Use RoadShieldIconProperties.isoCountryCode instead.
4.26.5.0
2026-06-30
FIXED
Routing: Fixed an issue where ManeuverAction.LEFT_FORK and ManeuverAction.RIGHT_FORK were returned instead of ManeuverAction.LEFT_RAMP and ManeuverAction.RIGHT_RAMP for road bifurcations, resulting in an inaccurate maneuver icon.
4.26.5.0
2026-06-30
ADDED
Map view: Added MapView.onStop() and MapView.onRestart() to be called on matching Activity lifecycle events.
4.26.5.0
2026-06-30
ADDED
Routing: Added Span.getIsoCountryCode() to be used with RoadShieldIconProperties.isoCountryCode.
4.26.4.0
2026-07-10
ADDED
Map view: Added the following common Anchor2D instances for top, left, right, bottom, center and the 4 corners Anchor2D.center(), Anchor2D.top(), Anchor2D.topRight(), Anchor2D.right(), Anchor2D.bottomRight(), Anchor2D.bottom(), Anchor2D.bottomLeft(), Anchor2D.left() and Anchor2D.topLeft().
4.26.4.0
2026-07-10
ADDED
Added OFFLINE_SEARCH value to SDKNativeEngine.PurgeMemoryStrategy enum. Calling purgeMemoryCaches(OFFLINE_SEARCH) clears only offline search caches, leaving map tile and routing caches intact.
4.26.4.0
2026-07-10
ADDED
Map view: Added MapImage.getSize() that returns the pixel size of the image as a Size2D.
4.26.4.0
2026-07-10
ADDED
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. Performance improvements. Note that this is a beta release of this feature.
4.26.4.0
2026-07-10
ADDED
Map view: Added interface MapInteractionListener to support receiving notifications from map interactions. Added enum MapInteractionState to describe the supported states of a map interaction. Added Gestures.setMapInteractionListener(@Nullable final MapInteractionListener) to register the MapInteractionListener. Added @Nullable MapInteractionListener Gestures.getMapInteractionListener() to get the current MapInteractionListener.
4.26.4.0
2026-07-10
ADDED
Map view: Added new method Color DataAttributes.getColor() to get an attribute of type Color and DataAttributeBuilder.with(String, Color) to add an attribute of type Color.
4.26.4.0
2026-07-10
ADDED
Map view: Added MapArrow.getProgress(), MapArrow.setProgress(final double value), MapArrow.getProgressColor() and MapArrow.setProgressColor(@NonNull final Color value) methods to style two parts of a map arrow with different colors.
4.26.4.0
2026-07-10
ADDED
Search: Added EVChargingLocation.nearbyPlaces that represents the list of Places within walking distance from the EV charging location and EVChargingLocation.hasMoreNearbyPlaces that represents the boolean flag indicating whether there are additional nearby places beyond those included in the EVChargingLocation.nearbyPlaces list.
4.26.4.0
2026-07-10
CHANGED
Map view: Modified a beta API by replacing field 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
ADDED
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
CHANGED
Starting with the next release, HERE SDK 4.26.5.0, we plan to remove documentation assets from the release packages, since the same content is available online on our documentation pages. 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
ADDED
Following the release of HERE SDK 4.26.0.0, HERE SDK 4.26.4.0 is the next regular version we are publishing. HERE SDK versions 4.26.1.0, 4.26.2.0, and 4.26.3.0 were internal releases and will not be published, as we decided to focus our efforts on further stabilizing the major release. Therefore, HERE SDK 4.26.4.0 marks the next regular release in the 4.26 release line.
4.26.0.0
2026-05-19
ADDED
Search: Introduced the new EVSearchEngine which provides detailed information about EV charging locations. For information on how to obtain the required license, see HERE EV Charge Points API v3 - Developer Guide. Introduced the new EVChargingLocation type, which exposes charging location details such as operator, suboperator and eMSPs info, facility types, parking type, energy mix, EVSEs, tariffs, connector groups, truck restrictions and support phone number. EVChargingLocation is accessible via Place.getDetails().evChargingLocation. Introduced EVSearchOptions to control the behavior of EVSearchEngine. Use SearchEngine.setEVInterface(EVSearchInterface) to attach an EVSearchEngine instance so that subsequent search calls automatically enrich results with additional EV information where applicable. Note that this is a beta release of this feature.
4.26.0.0
2026-05-19
ADDED
We’re refreshing the documentation with a modernized design, improved search, and enhanced AI capabilities for a better overall experience. The online API Reference aligns now with the version included in the HERE SDK package. During the transition, you may notice temporary inconsistencies. We apologize for any inconvenience and recommend consulting the documentation assets included in the HERE SDK package if you encounter any issues. We value your feedback and would love to hear what you think of the new experience.
4.26.0.0
2026-05-19
ADDED
Map view: Added MapScene.removeAllMapItems() to remove all map items from a scene.
4.26.0.0
2026-05-19
CHANGED
Map view: Removed deprecated MapSurface.setSurface(Context context, Surface surface, int width, int height). Use MapSurface.attachSurface(Context context, Surface surface, int width, int height) instead.
4.26.0.0
2026-05-19
CHANGED
Deprecated VehicleProfile. Use TransportSpecification instead. Deprecated VehicleType. Use TransportMode instead. Deprecated PedestrianProfile. Use TransportSpecification instead.
4.26.0.0
2026-05-19
CHANGED
Search: Removed SearchError.LAYERS_NOT_ENABLED error code as it is no longer applicable. Use LayerConfiguration.Feature.OFFLINE_SEARCH_GLOBAL instead to enable the new offline search algorithm (beta).
4.26.0.0
2026-05-19
ADDED
Routing: Added class IndoorSectionDetails describing details of sections related to indoor routing. Added class IndoorManeuverActions containing supported types of actions for indoor routing. Added class IndoorRoutePlace representing a place for indoor routing.
4.26.0.0
2026-05-19
CHANGED
Routing: Removed IndoorFeatures (previously in venue routing). Use IndoorLevelChangeFeatures instead. Removed IndoorLevelChangeAction. Use IndoorLevelChangeData instead. Removed IndoorManeuver (from venue routing). Use IndoorManeuver (in routing) instead. Removed IndoorSpaceAction. Use IndoorSpaceData instead.
4.26.0.0
2026-05-19
CHANGED
Search: Removed the previously deprecated PlaceCategory.SIGHTS_LANDMARK_ATTACTION. Use PlaceCategory.SIGHTS_LANDMARK_ATTRACTION instead.
4.26.0.0
2026-05-19
ADDED
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
ADDED
Routing: Added RoutingEngine.refreshRoute(...) method with a RefreshRouteParameters parameter to make parameters consistent.
4.26.0.0
2026-05-19
CHANGED
Routing: Deprecated RoutingEngine.refreshRoute(...) with explicit waypoint, last section and distance arguments. Please use RoutingEngine.refreshRoute(...) method with a RefreshRouteParameters parameter.
4.25.5.0
2026-04-14
ADDED
Routing: Added VehicleSpecification.emptyWeightInKilograms to calculate routes based on the vehicle's empty weight. If no route can be found, VehicleRestrictionMaxWeightType.EMPTY is set, and VehicleRestrictionMaxWeight.valueInKilograms contains the maximum allowed empty weight.
4.25.5.0
2026-04-14
ADDED
Map view: Added MapCamera.setFarPlaneConfiguration() and MapCamera.FarPlaneConfiguration to override the far-plane distance per zoom level, with linear interpolation between zoom levels.
4.25.5.0
2026-04-14
CHANGED
Map view: Renamed MapContext.setMemoryManagementOptions(MemoryManagementOptions, onSetVideoMemoryLimit) and the callback MapContext.onSetVideoMemoryLimit(int). Use MapContext.setMemoryManagementOptions(MemoryManagementOptions, onSetMemoryManagementOptions) and the callback MapContext.onSetMemoryManagementOptions(MemoryManagementResult) instead. Added the new enum MapContext.MemoryManagementResultCode and the new struct MapContext.MemoryManagementResult. Note that this feature is released as beta and may contain bugs or unexpected behavior. Related APIs may change in future releases without a deprecation process.
4.25.5.0
2026-04-14
ADDED
Routing: Added ChargingConnectorType.SAE_J3400 to support the SAE J3400 connector type for the North American Charging Standard (NACS).
4.25.5.0
2026-04-14
CHANGED
Routing: Deprecated ChargingConnectorType.TESLA. Use ChargingConnectorType.SAE_J3400 instead.
4.25.5.0
2026-04-14
ADDED
Map view: Added MapScene.addMapPolygons(...), MapScene.removeMapPolygons(...), and MapScene.removeAllMapPolygons(...) to add and remove collections of map polygons.
4.25.5.0
2026-04-14
ADDED
Map view: Added MapScene.addMapMarkers3d(...), MapScene.removeMapMarkers3d(...), and MapScene.removeAllMapMarkers3d(...) to add and remove collections of 3D map markers.
4.25.5.0
2026-04-14
ADDED
Map view: Added MapScene.removeAllMapPolylines(...) to remove all map polylines from the scene.
4.25.5.0
2026-04-14
CHANGED
Deprecated BusSpecifications, CarSpecifications, and TruckSpecifications. Use TransportSpecification instead.
4.25.5.0
2026-04-14
ADDED
Map view: Added MapScene.removeAllMapMarkers(...) to remove all map markers from the scene.
4.25.5.0
2026-04-14
CHANGED
Deprecated the TransportProfile class. Use TransportSpecification instead.
4.25.4.0
2026-03-10
ADDED
Routing: Added VehicleSpecification.kingpinToRearAxleDistanceInCentimeters to calculate routes that support this kingpin to rear axle distance. In case no route can be found the ViolatedRestriction.details.maxKingpinToRearAxleDistanceInCentimeters contains the max distance.
4.25.4.0
2026-03-10
CHANGED
Routing: Deprecated BicycleOptions class. Use the RoutingOptions class instead. Deprecated BusOptions class. Use the RoutingOptions class instead. Deprecated CarOptions class. Use the RoutingOptions class instead. Deprecated EVCarOptions class. Use the RoutingOptions class instead. Deprecated EVTruckOptions class. Use the RoutingOptions class instead. Deprecated PedestrianOptions class. Use the RoutingOptions class instead. Deprecated PrivateBusOptions class. Use the RoutingOptions class instead. Deprecated ScooterOptions class. Use the RoutingOptions class instead. Deprecated TaxiOptions class. Use the RoutingOptions class instead. Deprecated TruckOptions class. Use the RoutingOptions class instead.
4.25.4.0
2026-03-10
CHANGED
Routing: Deprecated IsolineOptions 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
CHANGED
Map view: Improved the default map feature mode for road exit labels: The MapFeatures.ROAD_EXIT_LABELS default enabled mode changed from ROAD_EXIT_LABELS_NUMBERS_ONLY to MapFeatureModes.ROAD_EXIT_LABELS_ALL mode for MapScheme.LOGISTICS_DAY, MapScheme.LOGISTICS_NIGHT, MapScheme.LOGISTICS_HYBRID_DAY, MapScheme.LOGISTICS_HYBRID_NIGHT map schemes. For other map schemes, ROAD_EXIT_LABELS_NUMBERS_ONLY will stay as the default feature mode. An overview of the new default map features and map feature modes per map scheme can be seen in the HERE Style Editor documentation.
4.25.4.0
2026-03-10
ADDED
Search: Added EVChargingLocation.supportPhoneNumber for the phone number that EV drivers should call when they need assistance at the charge location.
4.25.4.0
2026-03-10
CHANGED
Routing: Deprecated TruckType class. Use the TruckCategory class instead. Deprecated VehicleSpecification.truckType. Use the VehicleSpecification.truckCategory instead.
4.25.4.0
2026-03-10
ADDED
Search: Added EVChargingLocation.timeZone for the time zone of the charging location and EVChargingConnector.tariffIndexes for the tariff indexes of the charging location.
4.25.3.0
2026-02-19
ADDED
Map view: Added following functions to MapContext, MapContext.getMemoryManagementOptions(), MapContext.setMemoryManagementOptions(MemoryManagementOptions,SetVideoMemoryLimitCallback), and lambda MapContext.SetVideoMemoryLimitCallback(int). Added struct MapContext.MemoryManagementOptions. Added the enum MapContext.MemoryManagementStrategy.
Note: This is a beta release of this feature, so there could be a few bugs and unexpected behaviors. Related APIs may change for new releases without a deprecation process.
4.25.3.0
2026-02-19
CHANGED
Deprecated method LockingProcess.getLockingProcessId(SDKOptions). Use LockingProcess.getLlockingProcessId(AndroidContext, SDKOptions) instead. Deprecated method LockingProcess.destroyLockingProcess(SDKOptions, Long). Use LockingProcess.destroyLockingProcess(AndroidContext, SDKOptions, Long) instead.
4.25.3.0
2026-02-19
CHANGED
Routing: Deprecated route.calculationOptions(...). Use RoutingOptions instead. Deprecated RefreshRouteOptions and RefreshRouteOptionsData use the RoutingOptions class from the route object instead.
4.25.3.0
2026-02-19
ADDED
Routing: Removed beta status for RoutingOptions, RoutingInterface.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.2.0
2026-08-26
ADDED
Routing: Added information about multi-travel pass characteristics to TollFare interface for online-routing.
4.25.2.0
2026-08-26
CHANGED
Removed VehicleSpecification.CarBuilder.withTruckCategory(), VehicleSpecification.CarBuilder.withIsTruckLight(), VehicleSpecification.CarBuilder.withWeightPerAxleGroup(), VehicleSpecification.CarBuilder.withHazardousMaterials(). Removed VehicleSpecification.TaxiBuilder.withTruckCategory(), VehicleSpecification.TaxiBuilder.withIsTruckLight(), VehicleSpecification.TaxiBuilder.withWeightPerAxleGroup(), VehicleSpecification.TaxiBuilder.withHazardousMaterials(). Removed VehicleSpecification.BusBuilder.withTruckCategory(), VehicleSpecification.BusBuilder.withIsTruckLight(), VehicleSpecification.BusBuilder.withHazardousMaterials(). Removed VehicleSpecification.PrivateBusBuilder.withTruckCategory(), VehicleSpecification.PrivateBusBuilder.withIsTruckLight(), VehicleSpecification.PrivateBusBuilder.withHazardousMaterials(). The class VehicleSpecification is marked as beta, so no deprecation process is necessary.
4.25.2.0
2026-08-26
ADDED
Routing: Added fromDefaultParameterConfiguration() static function to RoutingOptions, which constructs a RoutingOptions object with the transport specifications taken from SDKNativeEngine.parameterConfig.transportSpecification. Note: This is a beta release of this feature. There could be a few bugs and unexpected behaviors. Related APIs may change for new releases without a deprecation process.
4.25.2.0
2026-08-26
CHANGED
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-08-26
CHANGED
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-08-26
CHANGED
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.1.0
2026-01-20
ADDED
Map view: Added the following new classes and methods: MapSceneLoadOptions: Represents the complete configuration for loading a map scene, combining the scene source (MapScheme or configurationFile) and optional settings like enabledFeatures, disabledFeatures, watermarkStyle, and overridingMapStyle. Added MapSceneLoadOptionsBuilder: Builder class for creating MapSceneLoadOptions instances. The builder enforces that exactly one mapScheme or configurationFile is set. Added MapScene.loadScene(MapSceneLoadOptions, MapScene.LoadSceneCallback): Asynchronously loads a map scene using MapSceneLoadOptions. This unified API supports loading from either a map scheme or configuration file, with optional feature and watermark configuration. This update introduces a new unified API to load scenes with a builder pattern that provides a cleaner, more type-safe way to load map scenes. The builder enforces mutual exclusivity between mapScheme and configurationFile at build time. Note: This is a beta release of this feature. There could be a few bugs and unexpected behaviors. Related APIs may change for new releases without a deprecation process.
4.25.1.0
2026-01-20
ADDED
Map view: Added MapView.setFixedSize(int width, int height, double factor) method for reducing render target size by a factor. Note: This feature is in beta state and thus there can be bugs and unexpected behavior. Related APIs may change for new releases without a deprecation process.
4.25.1.0
2026-01-20
ADDED
Search: Added support for SearchOptions.distributedResults in SearchEngine, that indicates if search along the route should produce well-distributed results.
4.25.1.0
2026-01-20
ADDED
Added PedestrianSpecification, ScooterSpecification, TaxiSpecification classes, containing attributes for pedestrian, scooter and taxi profiles. Added TransportSpecification class which contains all attributes for a transport mode (vehicle, pedestrian, scooter and taxi).
4.25.1.0
2026-01-20
CHANGED
Removed VehicleSpecification.allowDriveThroughTaxiRoads. The property was moved to TaxiSpecification.allowDriveThroughTaxiRoads. Removed VehicleSpecification.allowScooterOnHighway. The property was moved to ScooterSpecification.allowScooterOnHighway.
4.25.1.0
2026-01-20
CHANGED
Routing: Removed RoutingOptions.transportMode. It is replaced with RoutingOptions.transportSpecification.transportMode. Removed RoutingOptions.occupantsNumber. It is replaced with RoutingOptions.transportSpecification.vehicleSpecification.occupancy. Removed RoutingOptions.vehicle. It is replaced with RoutingOptions.transportSpecification.vehicleSpecification. Removed TransportedCargo and RoutingOptions.transportedCargo. All the fields of TransportedCargo were moved to VehicleSpecification. Removed RoutingOptions.walkSpeedInMetersPerSecond. It is replaced with RoutingOptions.transportSpecification.pedestrianSpecification.walkingSpeedInMetersPerSecond.
4.25.1.0
2026-01-20
ADDED
Routing: Added RoutingOptions.transportSpecification which will include the transport mode and the vehicle, pedestrian, scooter and taxi specification.
4.25.1.0
2026-01-20
ADDED
Map view: Added MapFeatures.TRAFFIC_LIGHTS and MapFeatureModes.TRAFFIC_LIGHTS_ALL to show traffic lights.
4.25.1.0
2026-01-20
CHANGED
Routing: Removed RoutingOptions.commonRouteOptions. All its members were moved to RoutingOptions. The class RoutingOptions is marked as beta, so no deprecation process is necessary. Removed CommonRouteOptions class. All its members were moved to the RoutingOptions class. The class CommonRouteOptions was marked as beta, so no deprecation process is necessary.
4.25.1.0
2026-01-20
ADDED
Routing: Added RoutingOptions.routeOptions which specifies the common route calculation options. This attribute was moved from CommonRouteOptions class, which was removed. Added RoutingOptions.textOptions which configures the textual content returned from the route calculation, such as localization, format, and unit system. This attribute was moved from CommonRouteOptions class, which was removed. Added RoutingOptions.avoidanceOptions which specifies the restrictions for route calculations. This attribute was moved from CommonRouteOptions class, which was removed. Added RoutingOptions.allowOptions which specifies the options explicitly allowed by user for route calculations. This attribute was moved from CommonRouteOptions class, which was removed. Added RoutingOptions.tollOptions which specifies how the tolls should be calculated, such as transponders, vehicle category, and emission type. This attribute was moved from CommonRouteOptions class, which was removed. Added RoutingOptions.maxSpeedOnSegments which specifies segments with restriction on maximum base speed expressed in meters per second. This attribute was moved from CommonRouteOptions class, which was removed.
4.25.1.0
2026-01-20
ADDED
Map view: Added MapContentSettings.configureVehicleRestrictionFilter(TransportSpecification) method to filter restrictions shown on the map and to easily match the filtering to routing parameters.
4.25.1.0
2026-01-20
CHANGED
Map view: Deprecated MapContentSettings.configureVehicleRestrictionFilter(TransportMode, TruckSpecifications, List<HazardousMaterial>, TunnelCategory) method, use MapContentSettings.configureVehicleRestrictionFilter(TransportSpecification) instead.
4.25.1.0
2026-01-20
ADDED
Added SDKOptions.customOptions member to set the maximum thread count for selected HERE SDK components. Note: This is a beta release of this feature. There could be a few bugs and unexpected behaviors. Related APIs may change for new releases without a deprecation process.
4.25.1.0
2026-01-20
CHANGED
Removed ParameterSpecification.Pedestrian class. The class was replaced by PedestrianSpecification. The class ParameterSpecification is marked as beta, so no deprecation process is necessary. Removed ParameterSpecification.pedestrian. The property was replaced with to ParameterSpecification.transportSpecification.pedestrianSpecification. The class ParameterSpecification is marked as beta, so no deprecation process is necessary. Removed ParameterSpecification.vehicleProfile. The property was replaced with to ParameterSpecification.transportSpecification.vehicleSpecification. The class ParameterSpecification is marked as beta, so no deprecation process is necessary.
4.25.1.0
2026-01-20
ADDED
Added ParameterConfiguration.transportSpecification, which contains the default attribute values for attributes for vehicle, pedestrian, scooter and taxi specification.
4.25.1.0
2026-01-20
ADDED
Routing: Added serialize() and deserialize() in Route to allow storing and restoring of Route objects.
4.25.1.0
2026-01-20
FIXED
Map view: MapView: The MapView no longer stops responding when the system detaches the MapView from its render target during screen changes, for example, in a dual‑screen setup.
4.25.1.0
2026-01-20
ADDED
Added diagnosticsOutputPath field in NetworkSettings class to allow setting a file path that will be used to add verbose information in case network related issues occurred during use of the HERE SDK. Note: This is a beta release of this feature. There could be a few bugs and unexpected behaviors. Related APIs may change for new releases without a deprecation process.
4.25.1.0
2026-01-20
KNOWN ISSUE
Map view: Modifying rendering features like ambient occlusion or shadows can trigger an OpenGL driver crash on emulators with Android 13 or later.
4.25.0.0
2025-12-19
CHANGED
Routing: Replaced VehicleProfile.truckType with VehicleProfile.truckCategory. Replaced VehicleSpecification.truckType with VehicleSpecification.truckCategory. Note that this is still a beta API.
4.25.0.0
2025-12-19
CHANGED
Routing: Removed the previously deprecated RoadType type. Use TimingProfile instead. Removed the previously deprecated Maneuver.getRoadType() and Maneuver.getNextRoadType(). Use the Route.sections[Maneuver.sectionIndex].spans[Maneuver.spanIndex].streetAttributes object to determine the type of road. StreetAttributes.BUILT_UP_AREA indicates an urban road; StreetAttributes.MOTORWAY, StreetAttributes.CONTROLLED_ACCESS_HIGHWAY, or StreetAttributes.RAMP indicate a highway; all others indicate a rural road type.
4.25.0.0
2025-12-19
CHANGED
Routing: Removed deprecated EVMobilityServiceProviderPreferences.excluded. Use other preference levels of EVMobilityServiceProviderPreferences instead.
4.25.0.0
2025-12-19
ADDED
Map view: Added ability to allow or disallow showing a MapMarker as an icon without text if the text collides with other markers. See MapMarker.isTextOptional()/MapMarker.setTextOptional() for details.
4.25.0.0
2025-12-19
CHANGED
Removed the following deprecated country codes: ALA, ATF, BVT, GGY, HMD, JEY, UMI.
4.25.0.0
2025-12-19
CHANGED
Map style update: All night map schemes have been consistently brightened. All map elements, including land use, water, transport, streets, and overlays such as icons, road shields, POIs, traffic, exits, trucks, and safety cameras, have been updated.
4.25.0.0
2025-12-19
ADDED
Routing: Added ViolatedRestriction.forbiddenTruckCategory, which will replace the deprecated ViolatedRestriction.forbiddenTruckType.
4.25.0.0
2025-12-19
CHANGED
Routing: Deprecated the attribute forbiddenTruckType from ViolatedRestriction. Use ViolatedRestriction.forbiddenTruckCategory instead.
4.25.0.0
2025-12-19
KNOWN ISSUE
Map view: Modifying rendering features like ambient occlusion or shadows can trigger an OpenGL driver crash on emulators with Android 13 or later.
4.25.0.0
2025-12-19
KNOWN ISSUE
MapView: MapView can stop responding when the system detaches the MapView from its render target during screen changes, for example, in a dual‑screen setup.
4.24.5.0
2025-11-27
FIXED
Map view: Fixed incorrect interpolation for animations created from updates built by MapCameraUpdateFactory.lookAt(GeoCoordinatesUpdate, GeoOrientationUpdate, MapMeasure), MapCameraUpdateFactory.lookAt(GeoCoordinatesUpdate,MapMeasure), MapCameraUpdateFactory.lookToMatch(GeoCoordinates, Point2D, GeoOrientationUpdate, MapMeasure) and MapCameraUpdateFactory.zoomTo(double) as well as animations created via MapCameraAnimationFactory.flyTo(GeoCoordinatesUpdate, MapMeasure, double, Duration). Such animations did not interpolate correctly MapMeasure values for MapMeasure.Kind.ZOOM_LEVEL and MapMeasure.Kind.SCALE but fell back to MapMeasure.Kind.DISTANCE_IN_METERS.
4.24.5.0
2025-11-27
KNOWN ISSUE
Map view: Modifying rendering features like ambient occlusion or shadows can trigger an OpenGL driver crash on emulators with Android 13 or later.
4.24.4.0
2025-11-12
ADDED
Added digital signing to HERE SDK Android archives (AAR files) to allow developers to verify archive authenticity and integrity.
4.24.4.0
2025-11-12
CHANGED
Map view: Updated MapView.setShadowQuality(@Nullable ShadowQuality) and MapView.getShadowQuality() to use non-nullable shadow quality values. Updated MapSurface.setShadowQuality(@Nullable ShadowQuality) and MapSurface.getShadowQuality() to use non-nullable shadow quality values. The default shadow quality is now set to ShadowQuality.MEDIUM. Note that this is a beta release of this feature.
4.24.4.0
2025-11-12
FIXED
Map view: Fixed altitude handling in MapCameraKeyframeTrack.lookAtTarget: altitudes are now ignored, aligning the behavior with the documentation of GeoCoordinatesKeyframe.value.
4.24.4.0
2025-11-12
FIXED
Fixed an issue where SDK could request a large number of traffic tiles, resulting in increased mobile data consumption.
4.24.4.0
2025-11-12
KNOWN ISSUE
Map view: Modifying rendering features like ambient occlusion or shadows can trigger an OpenGL driver crash on emulators with Android 13 or later.
4.24.3.0
2025-11-03
ADDED
Map view: Added lookAtDistance(MapMeasure.Kind, List<ScalarKeyframe>, Easing, KeyframeInterpolationMode) method to MapCameraKeyframeTrack to support retrieving Kind measures such as distance, zoom, and scale level.
4.24.3.0
2025-11-03
CHANGED
Map view: Deprecated the MapCameraKeyframeTrack.lookAtDistance(List<ScalarKeyframe>, Easing, KeyframeInterpolationMode) method. Use MapCameraKeyframeTrack.lookAtDistance(MapMeasure.Kind, List<ScalarKeyframe>, Easing, KeyframeInterpolationMode) instead.
4.24.3.0
2025-11-03
ADDED
Map view: Added the method setMarker3dModel​(MapMarker3DModel model, double scale, LocationIndicator.MarkerType type, RenderSize.Unit renderSizeUnit) to LocationIndicator to specify how the vertex coordinates of 3D model are interpreted, either in world or screen coordinate space.
4.24.3.0
2025-11-03
CHANGED
Map view: Deprecated the LocationIndicator.setMarker3dModel​(MapMarker3DModel model, double scale, LocationIndicator.MarkerType type) method. Use the new LocationIndicator.setMarker3dModel​(MapMarker3DModel model, double scale, LocationIndicator.MarkerType type, RenderSize.Unit renderSizeUnit) overloaded method instead.
4.24.3.0
2025-11-03
KNOWN ISSUE
Map view: Modifying rendering features like ambient occlusion or shadows can trigger an OpenGL driver crash on emulators with Android 13 or later.
4.24.2.0
2025-10-13
ADDED
Routing: Added RoadFeature.SEASONAL_CLOSURE 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
KNOWN ISSUE
Map view: Modifying rendering features like ambient occlusion or shadows can trigger an OpenGL driver crash on emulators with Android 13 or later.
4.24.1.0
2025-10-01
ADDED
Map view: Introduced MapSurface.attachSurface(Context context, Surface surface, int width, int height) and MapSurface.attachSurface(Context context, Surface surface, int width, int height, @NonNull RenderListener renderListener), which throw an exception if the provided surface is unusable. In such cases, the MapSurface remains unmodified.
4.24.1.0
2025-10-01
CHANGED
Map view: Deprecated MapSurface.setSurface(Context context, Surface surface, int width, int height), use MapSurface.attachSurface(Context context, Surface surface, int width, int height) instead. Similarly, deprecated MapSurface.setSurface(Context context, Surface surface, int width, int height, @NonNull RenderListener renderListener), use MapSurface.attachSurface(Context context, Surface surface, int width, int height, @NonNull RenderListener renderListener) instead.
4.24.1.0
2025-10-01
ADDED
Map view: Added MaterialReflectivity class, and LocationIndicator.getMaterialReflectivity and LocationIndicator.setMaterialReflectivity functions to enable the Location Indicator to interact with scene lighting. The Location Indicator casts and receives shadows when the MapFeatures.shadows feature is enabled. Note: This feature is in beta state and may exhibit bugs or unexpected behavior. Related APIs are subject to change in future releases without a deprecation process.
4.24.1.0
2025-10-01
CHANGED
Search: Removed WebImage.date and WebImage.publicationDate. The date information is no longer provided. Removed WebImage constructors that accept Date, use the constructor that accepts only WebSource instead.
4.24.1.0
2025-10-01
CHANGED
Search: Removed SearchError.INVALID_PARAMETER enum value. More descriptive error values are now provided, such as SearchError.QUERY_EMPTY and SearchError.INVALID_AREA.
4.24.1.0
2025-10-01
FIXED
Routing: Added ChargingConnectorType.GBT_DC, representing the Guobiao GB/T 20234.3 DC connector, to specify charging connector types in EV routing calculations.
4.24.1.0
2025-10-01
ADDED
Added GeoPolyline.coordinatesAtOffsetInMeters() to convert offsets along the polyline to coordinates.
4.24.1.0
2025-10-01
ADDED
Added GeoCoordinates.interpolate() to interpolate between two coordinates.
4.24.1.0
2025-10-01
KNOWN ISSUE
Map view: Modifying rendering features like ambient occlusion or shadows can trigger an OpenGL driver crash on emulators with Android 13 or later.
4.24.0.0
2025-09-17
CHANGED
Routing: Removed the previously deprecated maxGrossWeightInKilograms. Use maxWeight instead.
4.24.0.0
2025-09-17
CHANGED
Routing: Removed getEvDetails() from Route. Use getConsumptionInKilowattHours() instead.
4.24.0.0
2025-09-17
CHANGED
Routing: Removed getEvDetails() from Section. Use getConsumptionInKilowattHours() instead.
4.24.0.0
2025-09-17
CHANGED
Routing: Removed the deprecated BusSpecifications.lastCharacterOfLicensePlate. Use BusOptions.lastCharacterOfLicensePlate instead.
4.24.0.0
2025-09-17
CHANGED
Removed the previously deprecated ConsentEngine API. Use LocationEngineBase.confirmHEREPrivacyNoticeInclusion() or LocationEngineBase.confirmHEREPrivacyNoticeException() instead.
4.24.0.0
2025-09-17
KNOWN ISSUE
Map view: Modifying rendering features like ambient occlusion or shadows can trigger an OpenGL driver crash on emulators with Android 13 or later.
4.23.5.0
2025-09-03
KNOWN ISSUE
Map view: Modifying rendering features like ambient occlusion or shadows can trigger an OpenGL driver crash on emulators with Android 13 or later.
4.23.4.0
2025-08-21
FIXED
Offline routing: Fixed missing road shield icons when calculating an offline route.
4.23.4.0
2025-08-21
FIXED
Map view: Fixed unexpected high CPU usage when enabling MapFeatures.TRAFFIC_FLOW on devices with a single core, regardless of the number of available cores. Note that this issue started to appear in HERE SDK 4.22.5.0.
4.23.4.0
2025-08-21
FIXED
Offline routing: Fixed a defect where the OfflineRoutingEngine would ignore highway sections when using VehicleSpecification in offline mode. This behavior occurred only when VehicleSpecification was not null. Highway sections are now considered in the same way as with the online RoutingEngine.
4.23.4.0
2025-08-21
KNOWN ISSUE
Map view: Modifying rendering features like ambient occlusion or shadows can trigger an OpenGL driver crash on emulators with Android 13 or later.
4.23.3.0
2025-08-05
CHANGED
EV Routing: The default value of ElectricVehicleOptions.batterySpecifications was changed to null. The field is now nullable. Note that this is a beta release of this feature.
4.23.3.0
2025-08-05
ADDED
Routing: Added RoutingOptions to IsolineOptions. RoutingOptions can now be used with the IsolineRoutingEngine.
4.23.3.0
2025-08-05
ADDED
Map view: Starting with HERE Style Editor v1.13.0, only zipped archives (.tar.gz) are exported. These archives include POI categories and the JSON style files. When loading a custom style using MapScene.loadScene(...), the HERE SDK supports specifying a path to a JSON file, as before, but it also allows to set a configurationFile pointing to the zipped archive.
4.23.3.0
2025-08-05
FIXED
Routing: Fixed TaskHandle to correctly return FINISHED when route calculation completes and CANCELLED when it’s cancelled for routing, isoline, and traffic.
4.23.3.0
2025-08-05
FIXED
Fixed a regression in data usage statistics for positioning introduced in HERE SDK 4.22.5. Previously, positioning subcategories were combined into a single value; now, positioning and serviceImprovement subcategories are correctly reported separately again.
4.23.3.0
2025-08-05
KNOWN ISSUE
Map view: Modifying rendering features like ambient occlusion or shadows can trigger an OpenGL driver crash on emulators with Android 13 or later.
4.23.3.0
2025-08-05
KNOWN ISSUE
Map view: Enabling MapFeatures.TRAFFIC_FLOW may cause unexpected high CPU usage on devices with a single core, regardless of the number of available cores.
4.23.2.0
2025-07-23
ADDED
Added TruckSpecifications.currentWeightInKilograms field to indicate the current weight of the vehicle.
4.23.2.0
2025-07-23
ADDED
Routing: Added AvoidanceOptions.zoneCategories, AvoidanceOptions.zoneIds and AvoidanceOptions.exceptZoneIds options for isoline calculation.
4.23.2.0
2025-07-23
ADDED
Routing: Added ViolatedRestriction.Details.maxNumberOfTires, and VehicleSpecification.tiresCount to store maximum permitted number of tires. Note that this feature is also supported by the OfflineRoutingEngine, if available for your edition.
4.23.2.0
2025-07-23
KNOWN ISSUE
Map view: Modifying rendering features like ambient occlusion or shadows can trigger an OpenGL driver crash on emulators with Android 13 or later.
4.23.1.0
2025-07-15
ADDED
Map view: Improved support for transparent custom line layers to avoid darker colors when objects overlap. Added TranslucentMapLayerGroup class and MapLayerPriorityBuilder.inGroup() function to support placing custom line layers into a translucent layer group. Custom line layers within a translucent group are rendered in an offscreen translucent pass, preventing self-overlapping translucent geometry from being alpha blended. Note that this is a beta release of this feature.
4.23.1.0
2025-07-15
CHANGED
Removed the previously deprecated LayerConfiguration.Feature.TRAFFIC. Please use LayerConfiguration.Feature.RDS_TRAFFIC instead.
4.23.1.0
2025-07-15
ADDED
Map style update: Enriched the POI display on the map by implementing new icons for various POI categories which previously used generic iconography.
4.23.1.0
2025-07-15
CHANGED
Removed the previously deprecated SDKOptions.accessKeyId and SDKOptions.accessKeySecret. Please use SDKOptions.authenticationMode instead.
4.23.1.0
2025-07-15
CHANGED
Map view: The default zoom-level to storage-level mapping has changed: the offset is now -3 instead of -1 for all layer types, except for raster layers, which can be created using the MapLayerBuilder API. MapPolyline.DashImageRepresentation map measure support has been updated to a new range of [3–19], replacing the previous range of [1–20].
4.23.1.0
2025-07-15
ADDED
Search: Added PlaceCategory.SIGHTS_LANDMARK_ATTRACTION to use instead of PlaceCategory.SIGHTS_LANDMARK_ATTACTION that contains a typo. Note that this is also supported for the OfflineSearchEngine (if available for your license).
4.23.1.0
2025-07-15
CHANGED
Search: Deprecated PlaceCategory.SIGHTS_LANDMARK_ATTACTION that contains a typo. Please use PlaceCategory.SIGHTS_LANDMARK_ATTRACTION instead.
4.23.1.0
2025-07-15
KNOWN ISSUE
Map view: Modifying rendering features like ambient occlusion or shadows can trigger an OpenGL driver crash on emulators with Android 13 or later.
4.23.0.0
2025-07-08
CHANGED
Search: Removed deprecated APIs: EVChargingPoolDetails.paymentIsRequired, EVChargingPoolDetails.subscriptionIsRequired, and EVChargingStation constructor with 12 parameters. Please use the default constructor instead.
4.23.0.0
2025-07-08
CHANGED
Search: Removed deprecated APIs in SearchEngine and OfflineSearchEngine: 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
CHANGED
Routing: Deprecated EVMobilityServiceProviderPreferences.excluded. Please use other pereferences levels of EVMobilityServiceProviderPreferences.
4.23.0.0
2025-07-08
ADDED
Search: Added EVChargingPool.access that represents the accessibility level of the charging pool. Also available offline for Navigate users.
4.23.0.0
2025-07-08
CHANGED
Routing: Removed deprecated sdk.routing.Toll.tollSystem. Please use sdk.routing.Toll.tollSystems instead.
4.23.0.0
2025-07-08
CHANGED
Map view: Removed deprecated enum value MapMeasure.Kind.DISTANCE. Please use MapMeasure.Kind.DISTANCE_IN_METERS instead.
4.23.0.0
2025-07-08
CHANGED
Map view: Renamed BUILDING_3D_MODELS to ADVANCED_BUILDINGS in the MapFeatures class. Renamed BUILDING_3D_MODELS_GRAYSCALE to ADVANCED_BUILDINGS_GRAYSCALE, BUILDING_3D_MODELS_TEXTURED to ADVANCED_BUILDINGS_TEXTURED, and BUILDING_3D_MODELS_TEXTURELESS to ADVANCED_BUILDINGS_TEXTURELESS in the MapFeatureModes class.
4.23.0.0
2025-07-08
FIXED
Routing: Fixed an issue with returnToRoute() that may happen when using AvoidanceOptions options to avoid corridors, bounding boxes or polygons.
4.23.0.0
2025-07-08
ADDED
Search: Added EVAccessRestrictionReason that represents the restriction reason of an EVChargingPool. Added EVChargingPool.accessRestrictionReasons that contains the list of reasons for restriction, accessible by offline search when access is EVAccessType.RESTRICTED_ACCESS.
4.23.0.0
2025-07-08
CHANGED
Routing: Removed the previously deprecated com.here.sdk.routing.RouteOptions.occupantsNumber field. Please use occupantsNumber in corresponding transport mode options instead.
4.23.0.0
2025-07-08
CHANGED
Routing: Removed the previously deprecated com.here.sdk.routing.Waypoint.isChargingStation field. Please use chargingStop field instead.
4.23.0.0
2025-07-08
CHANGED
The following countries have been deprecated from the CountryCode enum: ALA, ATF, BVT, GGY, HMD, JEY, UMI. Please use FIN, FRA, NOR, GBR, AUS, GBR, and USA respectively instead.
4.23.0.0
2025-07-08
ADDED
Map view: Removed the beta label for MapPolyline.setRepresentaion(). The API is now considered to be stable.
4.23.0.0
2025-07-08
ADDED
Documentation: Since the Explore Edition is a subset of the Navigate Edition, we plan to merge the developer guides for both into a single developer guide. Features such as HERE Positioning, Navigation, Indoor Maps, and offline capabilities will remain exclusive to Navigate users. Editions will be referenced to as "licenses". Your existing Explore and Navigate credentials will continue to work as before, and we will continue to maintain support for both licenses through dedicated frameworks and API references. This change is planned for an upcoming release and will only affect the documentation.
4.23.0.0
2025-07-08
KNOWN ISSUE
Map view: Modifying rendering features like ambient occlusion or shadows can trigger an OpenGL driver crash on emulators with Android 13 or later.
4.22.5.0
2025-06-10
ADDED
Routing: Added dispose() method to RoutingInterface and TransitRoutingEngine to allow proper resources cleanup, including canceling pending requests and shutting down the background worker thread, helping to avoid potential (though unlikely) crashes due to deadlocks.
4.22.5.0
2025-06-10
KNOWN ISSUE
Map view: Modifying rendering features like ambient occlusion or shadows can trigger an OpenGL driver crash on emulators with Android 13 or later.
4.22.4.0
2025-05-28
ADDED
Routing: Added support for Waypoint.currentWeightChangeInKilograms for changing the current weight of the vehicle at waypoints. For example, this can be used when the vehicle takes additional cargo or unloads its cargo along the route. Note that this is also supported offline for the users of Navigate Edition.
4.22.4.0
2025-05-28
KNOWN ISSUE
Map view: Modifying rendering features like ambient occlusion or shadows can trigger an OpenGL driver crash on emulators with Android 13 or later.
4.22.3.0
2025-05-13
ADDED
Map style update: Added improved pedestrian and walkway path styling by adjusting color and width to enhance visual clarity. Note that this feature was already introduced with HERE SDK 4.21.4.0.
4.22.3.0
2025-05-13
ADDED
Map style update: Updated walkway and pedestrian road styles to ensure appropriate visibility at zoomed-out levels. Note that this feature was already introduced with HERE SDK 4.22.2.0.
4.22.3.0
2025-05-13
ADDED
Routing: Added new APIs to better support Electric Light Commercial Vehicles (eLCVs) and various types of trucks, such as light trucks under 7.5 tons. Extended the RoutingEngine and OfflineRoutingEngine to accept the new RoutingOptions class, which consolidates several existing option classes - including CarOptions, TaxiOptions, TruckOptions, and RefreshRouteOptions - into a unified configuration model. While the existing RouteOptions class can still be used as before, RoutingOptions provides the same capabilities in a more generic structure suitable for all supported transport modes. When creating a new route, make sure to specify RoutingOptions.transportMode. The new class also introduces extended routing configurations via the new classes CommonRouteOptions, VehicleSpecification, ElectricVehicleOptions with the new EmpiricalConsumptionModel and PhysicalConsumptionModel, and TransportedCargo. For example, it is now possible to specify whether a car is carrying cargo. Previously, this was only available for trucks. The existing RouteOptions can now be set under CommonRouteOptions. Note that this is a beta release of the new feature. Also, the OfflineRoutingEngine is only available in the Navigate Edition.
4.22.3.0
2025-05-13
ADDED
Search for EV charging stations: The APIs EVChargingPool, Details.evChargingPool, EVChargingStation, EMobilityServiceProvider, EVChargingPool.eMobilityServiceProviders, EVChargingPool.cpoId, and EVChargingPool.evseInfo are now available to all customers and work with your standard credentials. Previously, these APIs were available only to our closed alpha group. Note that these APIs are also supported for the OfflineRoutingEngine, if available for your edition.
4.22.3.0
2025-05-13
ADDED
Removed the beta label from the horizontalAccuracyInMeters field of MapMatchedLocation. The API is now considered to be stable.
4.22.3.0
2025-05-13
KNOWN ISSUE
Map view: While changing rendering related map features like ambient occlusion and shadows, a crash in OpenGL driver happens on emulator running Android 13 or newer.
4.22.2.0
2025-04-30
ADDED
Map view: Added support for changing font in MapMarker. Added constructor to MapMarker.TextStyle with font name parameter and a new getFontName() method.
4.22.2.0
2025-04-30
FIXED
Fixed the mapping between certain HTTP client status codes and the corresponding SDK error messages.
4.22.2.0
2025-04-30
ADDED
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
ADDED
Routing: Added BatterySpecifications.maxPowerAtLowVoltageInKilowatts to allow vehicles which support 800V to use lower voltage charging stations.
4.22.2.0
2025-04-30
ADDED
Search: Added PassThroughFeature enum with ONLINE_SEARCH value. Enabling of this passthrough feature allows usage of online search in offline mode.
4.22.2.0
2025-04-30
KNOWN ISSUE
Map view: While changing rendering related map features like ambient occlusion and shadows, a crash in OpenGL driver happens on emulator running Android 13 or newer.
4.22.1.0
2025-04-16
ADDED
Map view: Added gradient support for MapPolyline with adjustable length progress. Transition between MapPolyline.lineColor and MapPolyline.progressColor now renders gradually. The length of that transition can be specified and queried with MapPolyline.setProgressGradientLength and MapPolyline.getProgressGradientLength specified in zoom-level dependent pixels.
4.22.1.0
2025-04-16
FIXED
Map view: Fixed the behavior of MapLayer.setPriority() to correctly remove any previously applied priorities before applying new ones. Fixed internal behaviour of MapLayerPriorityBuilder and the resulting MapLayerPriority when a layer (category) is defined more than once with MapLayerPriorityBuilder.
Previously, when chaining priorities, only in the case of two consecutive priority definitions for the same layer (category), the first one was overriden. Now, any previously defined priority in the chain for the same layer (category) is overriden.
4.22.1.0
2025-04-16
FIXED
Search: Fixed the behavior of Place.deserialize to handle missing enum PlaceType. If the PlaceType is missing in the serialized data, it is now set to PlaceType.UNKNOWN in the deserialized object. These features are also supported for the OfflineSearchEngine, if available for your edition.
4.22.1.0
2025-04-16
CHANGED
Map style update: Removed the Microhood city labels from the map display because they cluttered the map and exist in just a few countries.
4.22.1.0
2025-04-16
KNOWN ISSUE
Map view: While changing rendering related map features like ambient occlusion and shadows, a crash in OpenGL driver happens on emulator running Android 13 or newer.
4.21.4.0
2025-10-01
FIXED
Map view: After losing internet connection and then reconnecting, some roads on the map now render correctly and no parts of the map will appear incomplete.
4.21.4.0
2025-10-01
ADDED
If an application runs in a memory-constrained environment, enable SDKOptions.lowMemoryMode to reduce the HERE SDK's memory footprint. When set to true this configures the internal memory caches to consume less memory. Note that enabling the low memory mode may also reduce the performance of the HERE SDK.
4.21.4.0
2025-10-01
ADDED
When the application detects increased memory pressure, you can call the SDKNativeEngine.purgeMemoryCaches(...) method to clear the HERE SDK's in-memory caches and reduce its memory footprint. Note that calling this method may temporarily impact performance. Currently, only PurgeMemoryStrategy.FULL is supported, which clears all cached content without preserving any data.
4.21.4.0
2025-10-01
KNOWN ISSUE
Map view: While changing rendering related map features like ambient occlusion and shadows, a crash in OpenGL driver happens on emulator running Android 13 or newer.

Updated 3 days ago

Did this page help you?