HERE SDK for iOS (Explore)

Version

Date

Change

Description

4.26.1.0

2026-04-09

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()
Jira-Ticket: HERESDK-11735.

4.26.1.0

2026-04-09

Only part of ALPHA RELEASE builds: Alpha: Added MapCamera.lookAtWithAltitude() and MapCameraUpdateFactory.lookAtWithAltitude() methods to position the map camera to look at a given target. Unlike lookAt(), the altitude of the target point is not ignored. If the altitude is finite, it will be used as-is and subsequent camera updates and animations will consider the target point as being located at the given altitude above mean sea level.
Jira-Ticket: HERESDK-7718.

4.26.1.0

2026-04-09

Added 'offlineSearch' value to 'SDKNativeEngine.PurgeMemoryStrategy' enum. Calling 'purgeMemoryCaches(offlineSearch)' clears only offline search caches, leaving map tile and routing caches intact.
Jira-Ticket: HNAVNAT-654.

4.26.1.0

2026-04-09

Only part of ALPHA RELEASE builds: Added TileKeyFactory.createTileKey(coordinates: GeoCoordinates, storageLevel: Int32, tilingScheme: TilingScheme) factory method for creating TileKey objects containing specific geo coordinates.
Jira-Ticket: HERESDK-11266.

4.26.0.0

2026-04-14

Introduced the new EVSearchEngine which provides detailed information about EV charging locations (a licence is required; 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, and is accessible via
Place.details.evChargingLocation. Introduced EVSearchOptions to control the behavior of
EVSearchEngine. Use SearchEngine.setEVInterface to attach an EVSearchEngine so that
subsequent search calls automatically enrich results with additional EV information where
applicable.
Jira-Ticket: HERESDK-10755.

4.26.0.0

2026-04-14

Added MapScene.removeAllMapItems to remove all map items from a scene.
Jira-Ticket: HERESDK-11444.

4.26.0.0

2026-04-14

Deprecated VehicleProfile. Use TransportSpecification instead.
Deprecated VehicleType. Use TransportMode instead.
Deprecated PedestrianProfile. Use TransportSpecification instead.
Jira-Ticket: HERESDK-8741.

4.26.0.0

2026-04-14

Added class IndoorSectionDetails describing details of sections related to indoor routing. Added class IndoorManeuverActions containing supported type of actions for indoor routing. Added class IndoorRoutePlace representing a place for indoor routing.
Jira-Ticket: INDR-3172.

4.26.0.0

2026-04-14

Removed the previously deprecated PlaceCategory.sightsLandmarkAttaction. Use instead PlaceCategory.sightsLandmarkAttraction.
Jira-Ticket: HERESDK-10699.

4.26.0.0

2026-04-14

Added MapPolyline.SolidMultiColorRepresentation API allowing users to create multi-colored polylines.
DataAttributesAccessor and DataAttributeValue now support values of Color type.

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.
Jira-Ticket: HERESDK-11488.

4.26.0.0

2026-04-14

Added RoutingEngine.refreshRoute method with an RefreshRouteParameters parameter to make parameters consistent.
Jira-Ticket: HERESDK-11336.

4.26.0.0

2026-04-14

Deprecated RoutingEngine.refreshRoute with explicit waypoint, last section and distance agroments. Please use RoutingEngine.refreshRoute method with an RefreshRouteParameters parameter.
Jira-Ticket: HERESDK-11336.

4.25.5.0

2026-03-25

Added VehicleSpecification.emptyWeightInKilograms to calculate routes using the vehicle empty weight. If no route can be found, VehicleRestrictionMaxWeightType.EMPTY is set and VehicleRestrictionMaxWeight.valueInKilograms contains the maximum allowed empty weight.
Jira-Ticket: HERESDK-11532.

4.25.5.0

2026-03-25

Added MapCamera.setFarPlaneConfiguration() and MapCamera.FarPlaneConfiguration to override far plane distance per zoom level with linear interpolation between zoom levels.
Jira-Ticket: HERESDK-7994.

4.25.5.0

2026-03-25

Renamed MapContext.setMemoryManagementOptions(MemoryManagementOptions,SetVideoMemoryLimitCompletionHandler) and lambda MapContext.SetVideoMemoryLimitCompletionHandler(Int32). Use MapContext.setMemoryManagementOptions(MemoryManagementOptions,SetMemoryManagementOptionsCompletionHandler) and lambda MapContext.SetMemoryManagementOptionsCompletionHandler(MemoryManagementResult) instead. Added new enum MapContext.MemoryManagementResultCode and struct MapContext.MemoryManagementResult.
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.
Jira-Ticket: HERESDK-11213.

4.25.5.0

2026-03-25

Added ChargingConnectorType.SAE_J3400 to support SAE J3400 type of North American Charging Standard (NACS).
Jira-Ticket: HERESDK-11766.

4.25.5.0

2026-03-25

Deprecated ChargingConnectorType.TESLA. Use instead ChargingConnectorType.SAE_J3400.
Jira-Ticket: HERESDK-11766.

4.25.5.0

2026-03-25

Added MapScene.addMapPolygons, MapScene.removeMapPolygons, MapScene.removeAllMapPolygons to add/remove sets of map polygons.
Jira-Ticket: HERESDK-1148.

4.25.5.0

2026-03-25

Added MapScene.addMapMarkers3d, MapScene.removeMapMarkers3d, MapScene.removeAllMapMarkers3d to add/remove sets of 3D map markers.
Jira-Ticket: HERESDK-1147.

4.25.5.0

2026-03-25

Added MapScene.removeAllMapPolylines to remove all map polylines from a scene.
Jira-Ticket: HERESDK-11849.

4.25.5.0

2026-03-25

Added MapScene.removeAllMapMarkers to remove all map markers from a scene.
Jira-Ticket: HERESDK-11904.

4.25.4.0

2026-03-05

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.
Jira-Ticket: HERESDK-11248.

4.25.4.0

2026-03-05

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.
Jira-Ticket: HERESDK-8734.

4.25.4.0

2026-03-05

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.
Jira-Ticket: HERESDK-8734.

4.25.4.0

2026-03-05

Default map features change in the following way:
- MapFeatures.roadExitLabels default enabled mode changed to MapFeatureModes.roadExitLabelsAll mode for MapScheme.logisticsDay, MapScheme.logisticsNight, MapScheme.logisticsHybridDay, MapScheme.logisticsHybridNight map schemes.
Jira-Ticket: CARTO-913.

4.25.4.0

2026-03-05

Deprecated TruckType class. Use the TruckCategory class instead.
Deprecated VehicleSpecification.truckType. Use the VehicleSpecification.truckCategory instead.
Jira-Ticket: HERESUP-59374.

4.25.3.0

2026-02-18

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.
Jira-Ticket: HERESDK-10229.

4.25.3.0

2026-02-18

Deprecated RefreshRouteOptions class. Use the RoutingOptions class instead.
Deprecated RefreshRouteOptionsData class. Use the RoutingOptions class instead.
Jira-Ticket: HERESDK-8734.

4.25.3.0

2026-02-18

Deprecated calculationOptions from Route. Use the routingOptions from Route instead.
Jira-Ticket: HERESDK-8734.

4.25.3.0

2026-02-18

Committed to APIs and removed beta status for Route.routingOptions.
Committed to APIs and removed beta status for RoutingInterface.calculateRoute.
Committed to APIs and removed beta status for RoutingOptions.
Jira-Ticket: HERESDK-8734.

4.25.3.0

2026-02-18

Committed to APIs and removed beta status for RoutingEngine.refreshRoute with RoutingOptions parameter types, RoutingEngine.importRoute with RoutingOptions parameter types.
Jira-Ticket: HERESDK-8734.

4.25.2.0

2026-02-06

Added information about multi-travel pass characteristics to TollFare interface for online-routing.
Jira-Ticket: HERESUP-52847.

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.
Jira-Ticket: HERESDK-8741.

4.25.2.0

2026-02-06

Add fromDefaultParameterConfiguration static function to RoutingOption, which constructs a RoutingOption object with the transport specifications taken from SDKNativeEngine.parameterConfig.transportSpecification.
Jira-Ticket: HERESDK-8741.

4.25.2.0

2026-02-06

Deprecated RoutingEngine.importRoute methods with CarOptions as parameter. Use the RoutingEngine.importRoute methods with RoutingOptions parameter instead.
Deprecated RoutingEngine.importRoute methods with PedestrianOptions as parameter. Use the RoutingEngine.importRoute methods with RoutingOptions parameter instead.
Deprecated RoutingEngine.importRoute methods with BicycleOptions as parameter. Use the RoutingEngine.importRoute methods with RoutingOptions parameter instead.
Deprecated RoutingEngine.importRoute methods with ScooterOptions as parameter. Use the RoutingEngine.importRoute methods with RoutingOptions parameter instead.
Deprecated RoutingEngine.importRoute methods with TruckOptions as parameter. Use the RoutingEngine.importRoute methods with RoutingOptions parameter instead.
Deprecated RoutingEngine.importRoute methods with TaxiOptions as parameter. Use the RoutingEngine.importRoute methods with RoutingOptions parameter instead.
Deprecated RoutingEngine.importRoute methods with BusOptions as parameter. Use the RoutingEngine.importRoute methods with RoutingOptions parameter instead.
Deprecated RoutingEngine.importRoute methods with PrivateBusOptions as parameter. Use the RoutingEngine.importRoute methods with RoutingOptions parameter instead.
Deprecated RoutingEngine.importRoute methods with EVCarOptions as parameter. Use the RoutingEngine.importRoute methods with RoutingOptions parameter instead.
Deprecated RoutingEngine.importRoute methods with EVTruckOptions as parameter. Use the RoutingEngine.importRoute methods with RoutingOptions parameter instead.
Deprecated RoutingEngine.importRoute methods with RefreshRouteOptions as parameter. Use the RoutingEngine.importRoute methods with RoutingOptions parameter instead.
Jira-Ticket: HERESDK-8734.

4.25.2.0

2026-02-06

Deprecated RoutingInterface.calculateRoute method with CarOptions as parameter. Use the RoutingInterface.calculateRoute method with RoutingOptions parameter instead.
Deprecated RoutingInterface.calculateRoute method with PedestrianOptions as parameter. Use the RoutingInterface.calculateRoute method with RoutingOptions parameter instead.
Deprecated RoutingInterface.calculateRoute method with TruckOptions as parameter. Use the RoutingInterface.calculateRoute method with RoutingOptions parameter instead.
Deprecated RoutingInterface.calculateRoute method with ScooterOptions as parameter. Use the RoutingInterface.calculateRoute method with RoutingOptions parameter instead.
Deprecated RoutingInterface.calculateRoute method with BicycleOptions as parameter. Use the RoutingInterface.calculateRoute method with RoutingOptions parameter instead.
Deprecated RoutingInterface.calculateRoute method with TaxiOptions as parameter. Use the RoutingInterface.calculateRoute method with RoutingOptions parameter instead.
Deprecated RoutingInterface.calculateRoute method with EVCarOptions as parameter. Use the RoutingInterface.calculateRoute method with RoutingOptions parameter instead.
Deprecated RoutingInterface.calculateRoute method with EVTruckOptions as parameter. Use the RoutingInterface.calculateRoute method with RoutingOptions parameter instead.
Deprecated RoutingInterface.calculateRoute method with BusOptions as parameter. Use the RoutingInterface.calculateRoute method with RoutingOptions parameter instead.
Deprecated RoutingInterface.calculateRoute method with PrivateBusOptions as parameter. Use the RoutingInterface.calculateRoute method with RoutingOptions parameter instead.
Jira-Ticket: HERESDK-8734.

4.25.2.0

2026-02-06

Deprecated RoutingEngine.refreshRoute methods with RefreshRouteOptions as parameter. Use the RoutingEngine.refreshRoute methods with RoutingOptions parameter instead.
Jira-Ticket: HERESDK-8734.

4.25.1.0

2026-01-16

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.
- MapSceneLoadOptionsBuilder: Builder class for creating MapSceneLoadOptions instances with a fluent API. The builder enforces that exactly one of mapScheme or configurationFile is set.
- 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 loadScene API with a builder pattern that provides a cleaner, more type-safe way to load map scenes with
optional watermark, feature configurations, and overriding map style.
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.
Jira-Ticket: HERESDK-5004.

4.25.1.0

2026-01-16

Added support for SearchOptions.distributedResults in SearchEngine,
that indicates if search along the route should produce well-distributed results.
Jira-Ticket: HERESDK-10722.

4.25.1.0

2026-01-16

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).
Jira-Ticket: HERESDK-8733.

4.25.1.0

2026-01-16

Removed VehicleSpecification.allowDriveThroughTaxiRoads. The property was moved to TaxiSpecification.allowDriveThroughTaxiRoads.
Removed VehicleSpecification.allowScooterOnHighway. The property was moved to ScooterSpecification.allowScooterOnHighway.
Jira-Ticket: HERESDK-8733.

4.25.1.0

2026-01-16

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.
Jira-Ticket: HERESDK-8733.

4.25.1.0

2026-01-16

Added RoutingOptions.transportSpecification which will include the transport mode and the vehicle, pedestrian, scooter and taxi specification.
Jira-Ticket: HERESDK-8733.

4.25.1.0

2026-01-16

Added MapFeatures.trafficLights and MapFeatureModes.trafficLightsAll to show traffic lights.
Jira-Ticket: HERESDK-9936.

4.25.1.0

2026-01-16

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.
Jira-Ticket: HERESDK-8733.

4.25.1.0

2026-01-16

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.
Jira-Ticket: HERESDK-8733.

4.25.1.0

2026-01-16

Added MapContentSettings.configureVehicleRestrictionFilter(transportSpecs:) method to filter restrictions shown on the map and to easily match the filtering to routing parameters.
Jira-Ticket: HERESDK-10243.

4.25.1.0

2026-01-16

Deprecated MapContentSettings.configureVehicleRestrictionFilter(transportMode:truckSpecifications:hazardousMaterials:tunnelCategory:) method, use MapContentSettings.configureVehicleRestrictionFilter(transportSpecs:) instead.
Jira-Ticket: HERESDK-10243.

4.25.1.0

2026-01-16

Added SDKOptions.customOptions property.

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.
Jira-Ticket: HERESDK-10723.

4.25.1.0

2026-01-16

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.
Jira-Ticket: HERESDK-8740.

4.25.1.0

2026-01-16

Added ParameterConfiguration.transportSpecification, which contains the default attribute values for attributes for vehicle, pedestrian, scooter and taxi specification.
Jira-Ticket: HERESDK-8740.

4.25.1.0

2026-01-16

Added serialize() and deserialize() in Route to allow storing and restoring of Route objects.
Jira-Ticket: HERESDK-9005.

4.25.0.0

2025-12-16

Replace VehicleProfile.truckType with VehicleProfile.truckCategory. VehicleProfile is a beta API so no deprecation process is necessary.
Replace VehicleSpecification.truckType with VehicleSpecification.truckCategory. VehicleSpecification is a beta API so no deprecation process is necessary.
Jira-Ticket: HERESDK-8733.

4.25.0.0

2025-12-16

Removed the previously deprecated RoadType type. Use instead TimingProfile.
Removed the previously deprecated Maneuver.roadType(), Maneuver.nextRoadType(). Use Route.sections[Maneuver.sectionIndex].spans[Maneuver.spanIndex].streetAttributes object to determine the type of the road. StreetAttributes.BUILT_UP_AREA will indicate an urban road, StreetAttributes.MOTORWAY, StreetAttributes.CONTROLLED_ACCESS_HIGHWAY or StreetAttributes.RAMP will indicate a highway and all the rest will indicate a rural road type.
Jira-Ticket: HERESKD-6972.

4.25.0.0

2025-12-16

Removed deprecated EVMobilityServiceProviderPreferences.excluded. Use other pereferences levels of EVMobilityServiceProviderPreferences.
Jira-Ticket: HERESDK-7518.

4.25.0.0

2025-12-16

Added ability to allow/disallow showing MapMarker as icon without text if text collides with other markers. See MapMarker.isTextOptional for details.
Jira-Ticket: HERESDK-9915.

4.25.0.0

2025-12-16

Only part of ALPHA RELEASE builds: Added OCM map feature and mode for vegetation. Added .vegetation to the MapFeatures enum. Added .vegetationAll to the MapFeatureModes enum.
Jira-Ticket: HERESDK-10418.

4.25.0.0

2025-12-16

Removed deprecated country codes - [ALA, ATF, BVT, GGY, HMD, JEY, UMI].
Jira-Ticket: HERESDK-9328.

4.25.0.0

2025-12-16

Map style update: Consistently brightened the complete set of night schemes. All the elements of the map have been consistently brightened including the landuse, water, transport, streets, and overlays like icons including road shields, poi, traffic, exits, truck, safety camera.
Jira-Ticket: CARTO-559.

4.25.0.0

2025-12-16

Added ViolatedRestriction.forbiddenTruckCategory which will replace the deprecated ViolatedRestriction.forbiddenTruckType.
Jira-Ticket: HERESDK-8733.

4.25.0.0

2025-12-16

Deprecated attribute forbiddenTruckType from ViolatedRestriction. Use ViolatedRestriction.forbiddenTruckCategory instead.
Jira-Ticket: HERESDK-8733.

4.24.5.0

2025-11-24

Fixed wrong 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.
Jira-Ticket: HERESDK-1804.

4.24.4.0

2025-11-10

Changed MapView.shadowQuality property to set and get non-optional shadow quality.
Default shadow quality is set to ShadowQuality.medium.
Jira-Ticket: HERESDK-9785.

4.24.4.0

2025-11-10

Fixed an issue where SDK would request a large number of traffic tiles leading to increased mobile data consumption.
Jira-Ticket: HERESUP-45161.

4.24.3.0

2025-10-30

Added MapCameraKeyframeTrack.lookAtDistance(ofKind: MapMeasure.Kind, keyframes: [ScalarKeyframe], easing: Easing, interpolationMode: KeyframeInterpolationMode)
Jira-Ticket: HERESDK-1296.

4.24.3.0

2025-10-30

Only part of ALPHA RELEASE builds: Removed alpha APIs
MapScene.loadScene(mapScheme: MapScheme, enabledFeatures: [String: String],<br/> completion: LoadSceneCallback?),
MapScene.loadScene(fromFile: String, enabledFeatures: [String: String],<br/> completion: LoadSceneCallback?), and MapScene.setEnabledFeatures(_ features: [String: String]).
Use the other alpha API variants
loadScene(mapScheme: MapScheme, enabledFeatures: [String: String],<br/> disabledFeatures: [String], completion: LoadSceneCallback?) and
loadScene(fromFile: String, enabledFeatures: [String: String],<br/> disabledFeatures: [String], completion: LoadSceneCallback?), and combine
enableFeatures(_ features: [String: String]) with disableFeatures(_ features: [String]) to
control features explicitly.
Jira-Ticket: HERESDK-9854.

4.24.3.0

2025-10-30

Deprecated MapCameraKeyframeTrack.lookAtDistance(keyframes: [ScalarKeyframe], easing: Easing, interpolationMode: KeyframeInterpolationMode). Use MapCameraKeyframeTrack.lookAtDistance(ofKind: MapMeasure.Kind, keyframes: [ScalarKeyframe], easing: Easing, interpolationMode: KeyframeInterpolationMode) instead.
Jira-Ticket: HERESDK-1296.

4.24.3.0

2025-10-30

Added new setMarker3dModel with additional RenderSize.Unit parameter to LocationIndicator.
Jira-Ticket: HERESDK-7442.

4.24.3.0

2025-10-30

Deprecated setMarker3dModel of LocationIndicator, please use an overloaded method with additional RenderSize.Unit parameter instead.
Jira-Ticket: HERESDK-7442.

4.24.2.0

2025-10-10

Only part of ALPHA RELEASE builds: Added .dayCycleNotSupported error state to the enum MapSceneLights.attributeSettingError.
Jira-Ticket: HERESDK-9207.

4.24.2.0

2025-10-10

Enabled the use of RoadFeature.SEASONAL_CLOSURE as an avoidance option in isoline calculation.
Jira-Ticket: HERESDK-9081.

4.24.1.0

2025-09-30

Only part of ALPHA RELEASE builds: Removed the timezone parameter from MapSceneLights.getDayPeriodAndLightDirection(GeoCoordinates, double TimeZone, Date). The method now computes normalized day period and light direction (azimuth, altitude) using only coordinates and UTC time to achieve near-realistic light effects.
Note: This is an Alpha API.
Jira-Ticket: HERESDK-9251.

4.24.1.0

2025-09-30

Upgrade build system Xcode version from 14.2 to version 16.2. The new version will be used for release builds. Older Xcode versions may, but are not guaranteed to work.
Jira-Ticket: HERESDK-9133.

4.24.1.0

2025-09-30

Added MaterialReflectivity struct and LocationIndicator.materialReflectivity property to enable Location Indicator to interact with scene lights. Location Indicator casts and receivers shadows when MapFeatures.shadows feature is enabled.
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.
Jira-Ticket: HERESDK-9053.

4.24.1.0

2025-09-30

Add GeoPolyline.coordinatesAt() to convert offsets on the polyline to coordinates.
Jira-Ticket: HERESDK-9336.

4.24.1.0

2025-09-30

Add GeoCoordinates.interpolate() to interpolate between two coordinates.
Jira-Ticket: HERESDK-9336.

4.24.0.0

2025-09-12

Removed the previously deprecated maxGrossWeightInKilograms. Use maxWeight instead.
Jira-Ticket: HERESDK-5378.

4.24.0.0

2025-09-12

Only part of ALPHA RELEASE builds: Increased maximum tilt angle to 89 degrees for ALPHA builds.
Jira-Ticket: HERESDK-6160.

4.24.0.0

2025-09-12

Removed evDetails from sdk.routing.Route. Use consumptionInKilowattHours instead.
Jira-Ticket: HERESDK-9263.

4.24.0.0

2025-09-12

Removed evDetails from sdk.routing.Section. Use consumptionInKilowattHours instead.
Jira-Ticket: HERESDK-9263.

4.24.0.0

2025-09-12

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.
Jira-Ticket: HERESDK-9184.

4.24.0.0

2025-09-12

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.
Jira-Ticket: HERESDK-9133.

4.23.5.0

2025-08-29

No changes, since the member was marked as internal only and was skipped for iOS code generation.
Jira-Ticket: HERESDK-8915.

4.23.5.0

2025-08-29

Field directions is added to the LaneMarkings class.
Jira-Ticket: HERESDK-8918.

4.23.4.0

2025-08-19

Only part of ALPHA RELEASE builds: Added DayPeriodAndDirection struct and MapSceneLights.getDayPeriodAndLightDirection(GeoCoordinates, Double, Date) to compute the normalized day period and sun light direction (azimuth, altitude) to achieve near-realistic sunlight effects.
Note: This Alpha API is under active development and may change soon. Integration should be postponed until the API is finalized.
Jira-Ticket: HERESDK-7720.

4.23.4.0

2025-08-19

Added operators "==" and "!=" to AuthenticationMode and fixed SDKOptions operators "==" and "!=".
Jira-Ticket: HERESDK-7990.

4.23.3.0

2025-08-04

Enabled the use of new routing API, RoutingOptions in isoline routing.
Jira-Ticket: HERESDK-8197.

4.23.3.0

2025-08-04

Only part of ALPHA RELEASE builds: Added MapSceneLights.enableLightingInterpolation(Bool) and MapSceneLights.setLightingInterpolationParameters(Double, Direction?) for automatic lighting control with smooth transitions between dawn, day, dusk and night phases.
Note: These Alpha APIs are under active development and may change soon. Currently label colors do not automatically adapt to lighting phase changes. Integration should be postponed until the APIs are finalized.
Jira-Ticket: HERESDK-7663.

4.23.3.0

2025-08-04

MapScene.loadScene(*, fromFile, *) APIs can now handle HERE Style Editor v1.13.0 exports packaged as zip archives.
Jira-Ticket: HERESDK-7166.

4.23.2.0

2025-07-21

Added field currentWeightInKilograms to object TruckSpecifications to indicate the current weight of the vehicle.
Jira-Ticket: HERESDK-5816.

4.23.2.0

2025-07-21

Added AvoidanceOptions.zoneCategories, AvoidanceOptions.zoneIds and AvoidanceOptions.exceptZoneIds options for isoline calculation.
Jira-Ticket: HERESUP-29704.

4.23.1.0

2025-07-11

Only part of ALPHA RELEASE builds: Alpha: Added delegate FrameRateDelegate and method setFrameRateListener(listener) to HereMap class.
Jira-Ticket: HERESDK-1520.

4.23.1.0

2025-07-11

Added class TranslucentMapLayerGroup and function MapLayerPriorityBuilder.inGroup() to allow placing custom line layers into a translucent layer group. Custom line layers in a translucent layer group are rendered in an offscreen translucent pass so that overlapping translucent line geometry is not alpha blended with itself.

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.
Jira-Ticket: HERESDK-6208.

4.23.1.0

2025-07-11

Only part of ALPHA RELEASE builds: The type change has no effect on generated interfaces.
Jira-Ticket: HERESDK-1520.

4.23.1.0

2025-07-11

Removed the previously deprecated LayerConfiguration.Feature.TRAFFIC. Use instead LayerConfiguration.Feature.RDS_TRAFFIC.
Jira-Ticket: HERESDK-5196.

4.23.1.0

2025-07-11

Map style update: Enriched the POI display on the map by implementing new Here Design System icons for various POI categories which previously used generic iconography.
Jira-Ticket: CARTO-768.

4.23.1.0

2025-07-11

The minimum supported iOS version for HERE SDK has been raised from version 15.0 to 16.0.
Jira-Ticket: HERESDK-7916.

4.23.1.0

2025-07-11

Removed the previously deprecated SDKOptions.accessKeyId and SDKOptions.accessKeySecret. Use instead SDKOptions.authenticationMode.
Jira-Ticket: HERESDK-5664.

4.23.1.0

2025-07-11

Default zoom-level to storage-level mapping changed from using an offset of -1 to using an offset of -3 for all layer types, except raster, which can be created with MapLayerBuilder API.
MapPolyline.DashImageRepresentation map measure support changed from range [1-20] to [3-19].
Jira-Ticket: HERESDK-7816.

4.23.0.0

2025-07-07

Deprecated EVMobilityServiceProviderPreferences.excluded. Use other pereferences levels of EVMobilityServiceProviderPreferences.
Jira-Ticket: HERESDK-7254.

4.23.0.0

2025-07-07

Removed deprecated enum value MapMeasure.Kind.distance. Use MapMeasure.Kind.distanceInMeters instead.
Jira-Ticket: HERESDK-6671.

4.23.0.0

2025-07-07

In class MapFeatures renamed building3dModels to advancedBuildings. In MapFeatureModes renamed building3dModelsGrayscale to advancedBuildingsGrayscale, building3dModelsTextured to advancedBuildingsTextured and building3dModelTextureless to advancedBuildingsTextureless.
Jira-Ticket: HERESDK-7601.

4.23.0.0

2025-07-07

Fixed return to route issue that happens when using avoidance area options like corridor, boundingbox and polygon.
Jira-Ticket: HERESUP-20669.

4.23.0.0

2025-07-07

Removed the previously deprecated Waypoint.isChargingStation property. Use chargingStop property instead.
Jira-Ticket: HERESDK-5165.

4.23.0.0

2025-07-07

Deprecated the following countries from the CountryCode enum: ala, atf, bvt, ggy, hmd, jey, umi. Please use fin, fra, nor, gbr, aus, gbr, usa respectively.
Jira-Ticket: HERESDK-6802.

4.23.0.0

2025-07-07

Removed beta label for MapPolyline.setRepresentaion().
Jira-Ticket: HERESDK-7692.

4.23.0.0

2025-07-07

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.
Jira-Ticket: TW-2423.

4.22.4.0

2025-05-27

Supported Waypoint.currentWeightChangeInKilograms to change the current weight of the vehicle at waypoints in online routing.
Jira-Ticket: HERESDK-6687.

4.22.3.0

2025-05-12

Map style update: Refined pedestrian and walkway path styling by adjusting color and width and improving visual clarity. Note that this feature was already introduced with HERE SDK 4.21.4.0.
Jira-Ticket: CARTO-417.

4.22.3.0

2025-05-12

Map style update: Adjustment of walkway and pedestrian road styles in Harp.gl and RTS to ensure appropriate visibility at zoomed-out levels. Note that this feature was already introduced with HERE SDK 4.22.2.0.
Jira-Ticket: CARTO-715.

4.22.2.0

2025-04-28

Added ability to change font in MapMarker. Added initializer to MapMarker.TextStyle with font name parameter and a read-only fontName property.
Jira-Ticket: HERESDK-5620.

4.22.2.0

2025-04-28

Only part of ALPHA RELEASE builds: Added internal class TranslucentMapLayerGroup and internal function MapLayerPriorityBuilder.inGroup(). This is an unreleased feature for internal use only, so there could be a few bugs and unexpected behavior. Related APIs may change for new releases without a deprecation process.
Jira-Ticket: HERESDK-5108.

4.22.2.0

2025-04-28

Improve the correspondence between some of http client status codes and error messages returned by sdk.
Jira-Ticket: HERESDK-6210.

4.22.2.0

2025-04-28

Map style update: Refined 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 HERE SDK 4.21.4.0.
Jira-Ticket: CARTO-417.

4.22.2.0

2025-04-28

Added BatterySpecifications.maxPowerAtLowVoltageInKilowatts to allow vehicles which support 800V to use lower voltage charging stations.
Jira-Ticket: HERESDK-6391.

4.22.2.0

2025-04-28

Extend PassThroughFeature enum with ONLINE_SEARCH value. Enabling of this passthrough feature in DevApp allows usage of online search in offline mode.
Jira-Ticket: HERESDK-6527.

4.22.1.0

2025-04-15

Added gradient support for MapPolyline with progress. Transition between MapPolyline.lineColor and MapPolyline.progressColor can rendered gradually. The length of that transition can be specified with
MapPolyline.progressGradientLength property in zoom level dependent pixels.
Jira-Ticket: HERESDK-6220.

4.22.1.0

2025-04-15

Fixed behavior of MapLayer.setPriority() to internally unapply previous priorities before applying the new one and updated documentation accordingly. Fixed internal behavior of MapLayerPriorityBuilder and the resulting MapLayerPriority when a layer (category) is defined more than once with MapLayerPriorityBuilder. The internal behavior is now consistent and clearly documented. Previously, when chaining priorities, only in the case of two consecutive priority definitions for the same layer (category) the first one was internally overriden. Now, any previously defined priority in the chain for the same layer (category) is overriden and the documentation was updated accordingly.
Jira-Ticket: HERESDK-6131.

4.22.1.0

2025-04-15

Remove mistakenly exposed class CertificateSettings for Swift
Jira-Ticket: HERESDK-2659.

4.22.1.0

2025-04-15

Map style update: Microhood city labels were removed from the map display because they cluttered the map and exist in just a few countries.
Jira-Ticket: CARTO-679.

4.22.0.0

2025-04-02

Added class AssetsManager to register custom fonts that can be used in SVG images with font-family text attribute.
Jira-Ticket: HERESDK-5619.

4.22.0.0

2025-04-02

Removed the previously deprecated avoid_bounding_box_areas. Use avoid_bounding_box_areas_options instead.
Removed the previously deprecated avoid_polygon_areas. Use avoid_polygon_areas_options instead.
Jira-Ticket: HERESDK-3798.

4.22.0.0

2025-04-02

Removed already deprecated SDKOptions.customEngineBaseUrls. Use SDKOptions.customeEngineOptions instead.
Jira-Ticket: HERESDK-4143.

4.22.0.0

2025-04-02

Removed already deprecated TrafficSpeed. Use DynamicSpeedInfo instead.
Jira-Ticket: HERESDK-4486.

4.22.0.0

2025-04-02

Remove deprecated constructor for MapLayerMapMeasureDependentStorageLevels. Use MapLayerMapMeasureDependentStorageLevels.withStorageLevelOffset() method to create MapLayerMapMeasureDependentStorageLevels instances instead.
Jira-Ticket: HERESDK-4649.

4.22.0.0

2025-04-02

Removed deprecated API:
MapViewBase.PickMapItemsHandler
MapViewBase.pickMapItems(at centerPoint: Point2D, radius: Double, completion callback: @escaping (PickMapItemsResult?) -> Void) - please use pick() instead
MapView.pickMapItems(at centerPoint: Point2D, radius: Double, completion callback: @escaping (PickMapItemsResult?) -> Void) - please use pick() instead
Jira-Ticket: HERESDK-5132.

4.22.0.0

2025-04-02

Removed deprecated API:
MapViewBase.PickMapContentHandler
MapViewBase.pickMapContent(inside viewArea: Rectangle2D, completion callback: @escaping (PickMapContentResult?) -> Void) - please use pick() instead
MapView.pickMapContent(inside viewArea: Rectangle2D, completion callback: @escaping (PickMapContentResult?) -> Void) - please use pick() instead
Jira-Ticket: HERESDK-6469.

4.22.0.0

2025-04-02

Fix bug causing missing consumption value on TrafficOnSpan for EV routes.
Jira-Ticket: HERESDK-6367.

4.22.0.0

2025-04-02

Remove deprecated MapScene.setPoiVisibility API. Use MapContentSettings.setPoiCategoriesVisibility and MapContentSettings.resetPoiCategoriesVisibility instead.
Jira-Ticket: HERESDK-4213.

4.21.5.0

2025-03-17

Added structure NameId to represent name-id pairs.
Jira-Ticket: HERESUP-10514.

4.21.5.0

2025-03-17

Added properties ChargingStation.brand to describe chagring station brand name and id, ChargingStation.charge_point_operator to describe charging point operator name and id and ChargingStation.matching_e_mobility_service_providers to show list of matcher E-Mobility Service Providers.
Jira-Ticket: HERESUP-10514.

4.21.5.0

2025-03-17

Added getDeviceId to retrieve identifier assigned to the device for this application for MAU count
Jira-Ticket: HERESDK-4708.

4.21.5.0

2025-03-17

Only part of ALPHA RELEASE builds: Added offscreen feature to control layers that use off-screen textures. The main purpose of this feature is to prohibit the use of off-screen textures for PowerVR Rogue series of GPUs to prevent a GPU driver bug on Android platform that causes a crash when multiple off-screen textures are used. The feature is marked with alpha tag to avoid external control of its enabling and disabling.
Jira-Ticket: HERESUP-1790.

4.21.5.0

2025-03-17

Fix request for route calculation by adding departure or arrival time also when traffic is disabled. Departure or arrival time can influence the route even when traffic is not taken into account, because some roads’ accessibility can be time-dependent.
Jira-Ticket: HERESDK-6120.

4.21.4.0

2025-02-28

If application works in a memory constraint environment, use SDKOption.lowMemoryMode to reduce memory footprint of the Here SDK. Low memory mode reduces performance of the SDK.
Jira-Ticket: HERESDK-5800.

4.21.4.0

2025-02-28

When application detects increased memory pressure, then SDKNativeEngine.purgeMemoryCaches method can be called to purge in-memory caches of the SDK, to decrease it’s memory footprint. Calling this method may temporarily decrease performance.
Jira-Ticket: HERESDK-5800.

4.21.3.0

2025-02-14

Added MapArrow.visibilityRanges : [MapMeasureRange] property. This property allows controlling the visibility of map arrows based on zoom levels by specifying a list of zoom level ranges. When the list is empty (default), the map arrows are visible at all zoom levels.
Jira-Ticket: HERESDK-5732.

4.21.3.0

2025-02-14

Removed the beta label from taxi related methods, fields and enum items. The following APIs are now considered to be stable: calculateTaxiRoute method of RoutingInterface, TAXI enum item of SectionTransportMode, TaxiOptions class, allowDriveThroughTaxiRoads field of TaxiOptions, importTaxiRoute and importTaxiRouteWithStops methods of RoutingEngine.
Jira-Ticket: HERESDK-5780.

4.21.3.0

2025-02-14

Remove Beta API parameterless styling function ["pixel-world-scale"].
Use ["pixel-world-scale", <number_expression>] instead.
Jira-Ticket: HERESDK-3922.

4.21.3.0

2025-02-14

Deprecate BusSpecifications.lastCharacterOfLicensePlate. Use instead BusOptions.lastCharacterOfLicensePlate.
Jira-Ticket: HERE-5050.

4.21.3.0

2025-02-14

Attribute lastCharacterOfLicensePlate is moved from BusSpecifications to all corresponding transport mode options to extend the functionality to all relevant transport modes. It is added to following transport mode options: CarOptions, EVCarOptions, BusOptions, PrivateBusOptions, TruckOptions, EVTruckOptions, ScooterOptions, TaxiOptions.
Jira-Ticket: HERESDK-5613.

4.21.2.0

2025-02-03

Added MapView.reinit() method to reinitialize a MapView invalidated by destruction of shared SDKNativeEngine.
Jira-Ticket: HERESDK-5192.

4.21.2.0

2025-02-03

Added enum 'CurrentType' that represents the type of electric current (ac or dc).
Added PlaceFilter.Ev.currentType filter to retrieve EV charging stations by the current type.
Jira-Ticket: HERESDK-1607.

4.21.2.0

2025-02-03

Map style update: Enriched the POI display on the map by implementing additional Here Design System icons for various POI categories which previously used a more generic iconography.
Jira-Ticket: CARTO-428.

4.21.2.0

2025-02-03

Introduce PolylineSimplifier component to help application reduce the complexity of GeoPolyline
Jira-Ticket: HERESUP-5719.

4.21.2.0

2025-02-03

Added TileGeoBoundsCalculator API that allows users to compute the geodetic bounds of tiles for supported TilingScheme.

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.
Jira-Ticket: HERESDK-4774.

4.21.2.0

2025-02-03

Fix bug causing EV car route never go through HOV lanes even when it should be allowed
Jira-Ticket: HERESDK-5667.

4.21.1.0

2025-01-22

Added ViolatedRestriction.Details.maxWeight. Added structure VehicleRestrictionMaxWeight to store max permitted weight along with weight restrictions type.
Jira-Ticket: HERESUP-6108.

4.21.1.0

2025-01-22

Deprecated maxGrossWeightInKilograms. Use instead maxWeight.
Jira-Ticket: HERESUP-6108.

4.21.1.0

2025-01-22

Deprecated the attributes Section.evDetails and Route.evDetails. Use Section.consumptionInKilowattHours and Route.consumptionInKilowattHours instead.
Jira-Ticket: HERESDK-4431.

4.21.1.0

2025-01-22

Map style update: Implemented dedicated set of truck restriction assets for the Hybrid MapSchemes.
Jira-Ticket: CARTO-418.

4.21.1.0

2025-01-22

Map style update: Enabled the diplay of POI categories that have previously not been visible on the map including the following main categories: business-services-areas; leisure-outdoor; medical POIs within the emergency category; all shopping categories. The change also includes a promotion of car parking POIs from start zoom level 18 to 17.
Jira-Ticket: CARTO-316.

4.21.1.0

2025-01-22

Added additionalPolylines field to TrafficLocation class. Traffic API v7 response data may contain a set of smaller
polylines rather than a continuous polyline. The current HSDK implementation doesn't take that into account
and treats the data as one contiguous polyline, which can lead to visual bugs when displaying polyline on the map.
A new additionalPolylines field has been introduced to store all GeoPolyline after the first gap between links.
Jira-Ticket: HERESUP-4954.

4.21.1.0

2025-01-22

Added Section.noThroughRestriction property that indicates area allowed to enter only it they are making a stop and added Span.noThroughRestrictionIndexes property.
Jira-Ticket: HERESUP-6108.

4.21.1.0

2025-01-22

Online routing requests will use brotli encoding to reduce response size.
Jira-Ticket: HERESDK-1934.

4.21.1.0

2025-01-22

Fixed SearchEngine.searchByPickedPlace and SearchEngine.searchPickedPlace for EV charging stations.
Jira-Ticket: HERESDK-5563.

4.21.1.0

2025-01-22

Added EngineBaseURL.ISOLINE_ROUTING_ENGINE enum value to provide custom url for isorouting engine url.
Jira-Ticket: HERESUP-8583.

4.21.1.0

2025-01-22

Added enum value MapMeasure.Kind.distanceInMeters.
Jira-Ticket: HERESDK-2152.

4.21.1.0

2025-01-22

Deprecated enum value MapMeasure.Kind.distance. Use MapMeasure.Kind.distanceInMeters instead.
Jira-Ticket: HERESDK-2152.

4.21.0.0

2024-12-16

Added attribute id to EVChargingPool, which represents HERE ID of the charging pool
Added attributes to Evse:
- cpoId, which represents the unique ID of an EVSE in the system of the CPO
- cpoEvseEmi3Id, which represents identifier in Emi3 format of the EVSE within the Charge Point Operator (CPO) platform
- status, which represents status of the EVSE such as AVAILABLE, OCCUPIED etc
- lastUpdated, which represents the last update time of the dynamic connector availability information
- connectors, which represents the list of connectors of the EVSE
Jira-Ticket: HERESDK-4980.

4.21.0.0

2024-12-16

Changed behaviour of PanDelegate and PinchRotateDelegate.
Pan gesture is now cancelled when pinch-rotate gesture starts.
If two finger panning is detected during pinch-rotate, then
pan gesture is started and both pan and pinch-rotate events
are emitted.
When pinch-rotate gesture finishes, then pan gesture (if in progress),
also finishes.
Jira-Ticket: HERESDK-4845.

4.21.0.0

2024-12-16

Fixes inconsistent behaviour of pinch-rotate gesture, where additional map translation would occur during rotation in some scenarios.
Jira-Ticket: HERESDK-4845.

4.21.0.0

2024-12-16

Prevent possible ANR that occurred when destroying the RoutingEngine while pending task were still in progress.
Jira-Ticket: HERESDK-4553.

4.21.0.0

2024-12-16

Removed the previosly deprecated TimeRule.asString. Use TimeRule.time_rule_string instead.
Jira-Ticket: HERESDK-5149.

4.21.0.0

2024-12-16

Deprecated the attribute Waypoint.isChargingStation. Use Waypoint.chargingStop instead.
Jira-Ticket: HERESDK-5142.

4.21.0.0

2024-12-16

Add Waypoint.chargingStop so that waypoint can be regarded as a charging stop.
Jira-Ticket: HERESDK-5142.

4.21.0.0

2024-12-16

Deprecated fields accessKeyId, accessKeySecret and other related constructors. The constructor with AuthenticationMode is the preferred method for initialization
Jira-Ticket: HERESDK-1464.

4.21.0.0

2024-12-16

Added PolygonTileDataSource and PolygonTileSource APIs to allow users to inject custom polygon tile sources into HERE SDK.

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.
Jira-Ticket: HERESDK-438.

4.21.0.0

2024-12-16

Changed behavior of TwoFingerPanDelegate.
Detect two finger pan only after a vertical movement of at least 5 mm.
Before, it was detected already after 1.5 mm which led to accidental
detections of two finger pan in some cases.
Jira-Ticket: HERESDK-5111.

4.21.0.0

2024-12-16

Remove the beta tag from SDKOptions.authenticationMode as it is the preferred way to initialize SDKOptions
Jira-Ticket: HERESDK-5478.

4.20.5.0

2024-11-22

Replaced property LocationIndicator.haloColor to configure the color of the accuracy indicator halo of the LocationIndicator with setter and getter methods LocationIndicator.setHaloColor(_ style: LocationIndicator.IndicatorStyle, color: UIColor) -> Void and LocationIndicator.getHaloColor(_ style: LocationIndicator.IndicatorStyle) -> UIColor, specifying the applicable style.

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.
Jira-Ticket: HERESDK-2354.

4.20.5.0

2024-11-22

Added new attributes to EVChargingStation:
- occupiedConnectorCount, which represents the number of occupied physical connectors
- outOfServiceConnectorCount, which represents the number of physical connectors that are out of service
- reservedConnectorCount, which represents the number of physical connectors that are reserved
- lastUpdated, which represents the last update of the availableConnectorCount and occupiedConnectorCount attributes
Jira-Ticket: HERESDK-4980.

4.20.5.0

2024-11-22

Fix incorrect route parsing when tolls enabled. The problem occurs when the name of the toll systems are not available when calculating a route with tolls.
Jira-Ticket: HERESUP-5912.

4.20.4.0

2024-11-11

Added LineTileDataSource and LineTileSource APIs to allow users to inject custom line tile sources into HERE SDK.

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.
Jira-Ticket: HERESDK-4384.

4.20.3.0

2024-10-25

Added property LocationIndicator.haloColor to configure the color of the accuracy indicator halo of the LocationIndicator for the active LocationIndicator.IndicatorStyle setting.

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.
Jira-Ticket: HERESDK-2354.

4.20.3.0

2024-10-25

Added GeoPolygon(geoBox: [GeoBox]) and GeoPolyline(geoBox: [GeoBox]) to construct a GeoPolygon/GeoPolyline from a GeoBox.
Jira-Ticket: HERESDK-2718.

4.20.3.0

2024-10-25

Deprecated RouteOptions.occupantsNumber. Use occupantsNumber in corresponding transport mode options instead, like CarOptions.occupants_number.
Jira-Ticket: HERESUP-367.

4.20.3.0

2024-10-25

AllowOptions structure is added to following transport mode options: CarOptions, EVCarOptions, BusOptions, PrivateBusOptions, TruckOptions, EVTruckOptions. It contains options that has to be explicitly allowed by user.
Jira-Ticket: HERESUP-367.

4.20.3.0

2024-10-25

Attribute occupantsNumber is moved from RouteOptions to corresponding transport mode options instead. It is added to following transport mode options: CarOptions, EVCarOptions, BusOptions, PrivateBusOptions, TruckOptions, EVTruckOptions, ScooterOptions.
Jira-Ticket: HERESUP-367.

4.20.3.0

2024-10-25

Added new struct EVMobilityServiceProviderPreferences that represents sets of E-Mobility Service Providers' ID grouped by preference level. Added new field EVCarOptions.evMobilityServiceProviderPreferences.
Jira-Ticket: HERESDK-4574.

4.20.3.0

2024-10-25

Add Waypoint.is_charging_station so that waypoint can be regarded as a charging stop.
Jira-Ticket: HERESDK-4699.

4.20.2.0

2024-10-14

Fixed next road numbers selection giving priority to those from signpost.
Jira-Ticket: HERESUP-1471.

4.20.2.0

2024-10-14

Added support to show multiple truck restriction icons per road segment for OCM map.
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.
Jira-Ticket: HERESDK-4372.

4.20.2.0

2024-10-14

Changed TrafficQueryError.invalidIncidentId to TrafficQueryError.invalidIncident
Jira-Ticket: HERESDK-3585.

4.20.2.0

2024-10-14

Added TrafficQueryError.invalidIn, TrafficQueryError.invalidParameter and TrafficQueryError.internalError
Jira-Ticket: HERESDK-3585.

4.20.2.0

2024-10-14

Deprecated the attribute Toll.tollSystem. Use the new attribute Toll.tollSystems instead. Note that this change was already included in HERE SDK 4.20.1.0.
Jira-Ticket: HERESDK-4347.

4.20.2.0

2024-10-14

Added PointTileDataSource and PointTileSource APIs to allow users to inject custom point tile sources into HERE SDK.

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.
Jira-Ticket: HERESDK-4364.

4.20.2.0

2024-10-14

Added MapFeature.ambientOcclusion with MapFeatureMode.ambientOcclusionAll to enable/disable ambient occlusion effect.
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.
Jira-Ticket: HERESDK-3983.

4.20.2.0

2024-10-14

Fixed incorrect routing when both max speed on segments and avoid segments are not empty when requesting a route. When both were set, only the former was being used.
Jira-Ticket: HERESUP-2314.

4.20.1.0

2024-09-28

Added RoutingEngine.calculateTrafficOnRoute() for electric vehicles to provide the current traffic on the route.
Jira-Ticket: HERESDK-4231.

4.20.1.0

2024-09-28

Added MapLayerMapMeasureDependentStorageLevels.withStorageLevelOffset() method to create MapLayerMapMeasureDependentStorageLevels instances.

Updated the documentation for MapLayerBuilder.withMapMeasureDependentStorageLevels() method to clarify that the default mapping will now use a storage level that is one level lower than the corresponding map measure.
Jira-Ticket: HERESUP-543.

4.20.1.0

2024-09-28

Deprecated constructor for MapLayerMapMeasureDependentStorageLevels. Use MapLayerMapMeasureDependentStorageLevels.withStorageLevelOffset() method to create MapLayerMapMeasureDependentStorageLevels instances instead.
Jira-Ticket: HERESUP-543.

4.20.1.0

2024-09-28

Added Toll.tollSystems to replace Toll.tollSystem.
Jira-Ticket: HERESDK-4347.

4.20.1.0

2024-09-28

Removed beta label for MapMeasureDependentRenderSize, representing a render size, described as map measure dependent values.
Jira-Ticket: HERESDK-3518.

4.20.1.0

2024-09-28

N/A
Jira-Ticket: HERESDK-4434.

4.20.1.0

2024-09-28

Improved gesture detection: Gesture types 'GestureType.Pan' and 'GestureType.PinchRotate' can be detected simultaneously when using two fingers.
Jira-Ticket: HERESDK-4528.

4.20.1.0

2024-09-28

Added RoutingEngine.calculateTrafficOnRoute method overload to calculate traffic for EV car routes. Additionally, consumptionInKilowattHours field has been added to TrafficOnSpan that indicates the power consumption in kilowatt-hours (kWh) necessary to traverse the span. Also departurePlace and arrivalPlace have been added to TrafficOnSection containing, among other properties, the estimated battery charge in kWh when leaving/arriving to a section.
Jira-Ticket: HERESDK-4231.

4.20.1.0

2024-09-28

The minimum supported iOS version for HERE SDK has been raised to iOS 15.
Jira-Ticket: HERESDK-4433.

4.20.1.0

2024-09-28

Fixed offline-routing to be calculated even though specified avoid areas are not included in loaded map data.
Jira-Ticket: HERESUP-743.

4.20.0.0

2024-09-18

Added Style.update(Style) and HereMap.style -> Style API that allows customizations of map style. New style definition General.Labels.Scale.Factor
is made available for controlling labels size on the map.
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.
Jira-Ticket: HERESDK-3578.

4.20.0.0

2024-09-18

Added calculateJamFactor() method to DynamicSpeedInfo structure.
Jira-Ticket: HERESDK-3696.

4.20.0.0

2024-09-18

Deprecated TrafficSpeed structure, please use DynamicSpeedInfo structure instead.
Deprecated trafficSpeed propery in Span class, please use dynamicSpeedInfo property instead.
Jira-Ticket: HERESDK-3696.

4.20.0.0

2024-09-18

Deprecated method RoutingEngine.calculateIsoline the functionality moved to IsolineRoutingEngine, please use it instead.
Jira-Ticket: HERESDK-3315.

4.20.0.0

2024-09-18

Fixes the rendering of svg icon on the map when the svg uses 'm' tag.
Jira-Ticket: HERESDK-4046.

4.20.0.0

2024-09-18

Remove already deprecated Unknown from RoadType. Unknown was never returned and null is used instead in specific cases.
Jira-Ticket: HERESDK-4346.

4.20.0.0

2024-09-18

Removed deprecated static function MapView.deinitialize(), deinitialization is handled internally.
Removed deprecated static function MapView.resume(), use per MapView instance resume() function instead.
Removed deprecated static function MapView.pause(), use per MapView instance pause() function instead.
Jira-Ticket: HERESDK-3532.

4.19.5.0

2024-08-26

Deprecated MapScene.setPoiVisibility API. Use MapContentSettings.setPoiCategoriesVisibility and MapContentSettings.resetPoiCategoriesVisibility instead.
Jira-Ticket: HERESDK-3751.

4.19.5.0

2024-08-26

Wait until all routing request will finish before destruct object to prevent access to deleted resources and crash at the end.
Jira-Ticket: HERESDK-3875.

4.19.5.0

2024-08-26

Fixed wrong turn orientation that happens when multiple streets on a junction go straight ahead.
Jira-Ticket: OLPSUP-30920.

4.19.5.0

2024-08-26

API SDKOptions.customEngineBaseUrls is deprecated in favour of SDKOptions.customEngineOptions, as it allows setting a specific URL for online service as well as custom authentication parameters.
Jira-Ticket: HERESDK-3662.

4.19.5.0

2024-08-26

Added missing specification detail about corridor radius in AvoidanceOptions.
Jira-Ticket: HERESDK-4098.

4.19.5.0

2024-08-26

Limit of segments in AvoidanceOptions is updated to match online routing limits.
Jira-Ticket: HERESUP-1142.

4.19.3.0

2024-07-31

Deprecated avoid_bounding_box_areas. Use avoid_bounding_box_areas_options.avoid_bounding_box_area instead.
Deprecated avoid_polygon_areas. Use avoid_polygon_areas_options.avoid_polygon_area instead.
Jira-Ticket: HERESDK-3678.

4.19.3.0

2024-07-31

Added field avoid_bounding_box_areas_options and avoid_polygon_areas_options to avoid rectangular and polygon shaped area duringAdded field avoid_bounding_box_areas_options and avoid_polygon_areas_options to avoid rectangular and polygon shaped area during route calculation including exceptions area (rectugular and polygon shaped) for this calculation.
Jira-Ticket: HERESDK-3678.

4.19.3.0

2024-07-31

Added PlaceFilter.EV.eMobilityServiceProviderPartnerIDs filter to retrieve EV charging stations with at least one e-Mobility Service Provider from the given list.
The feature is available as closed-alpha.
Jira-Ticket: HERESDK-1885.

4.19.3.0

2024-07-31

Added properties axleCount, trailerCount, and trailerAxleCount to CarSpecifications for routing.
Jira-Ticket: HERESDK-3753.

4.19.3.0

2024-07-31

Added EMobilityServiceProvider that represents e-Mobility Service Provider.
Added EVChargingPool.eMobilityServiceProviders.
The feature is available as closed-alpha.
Jira-Ticket: HERESDK-3552.

4.19.2.0

2024-07-18

Android: Added TileKey, TileSource and RasterTileSource APIs to allow users to inject custom raster tile sources into HERE SDK.
Added RasterDataSource constructor over a raster tile source.

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.
Jira-Ticket: HERESDK-587.

4.19.2.0

2024-07-18

Consolidated HTTP error codes into BAD_REQUEST and INTERNAL_SERVER_ERROR and output actual codes as error log.
Jira-Ticket: HERESDK-3415.

4.19.2.0

2024-07-18

Increased road shield icon display density. Aligned start zoom levels display between Explore and Navigate editions.
Jira-Ticket: CARTO-432.

4.19.2.0

2024-07-18

Support occupantsNumber of RouteOptions for bus.
Jira-Ticket: HERESDK-3667.

4.19.2.0

2024-07-18

Removed uninitializedLights state from the enum AttributeSettingError. This change is due to the implementation of a solution that ensures the Light Source API becomes available immediately after the scene load is completed.
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.
Jira-Ticket: HERESDK-3565.

4.19.2.0

2024-07-18

Added transponders property to TollFare to publish transponder names with toll cost in routing response.
Jira-Ticket: HERESDK-3701.

4.19.2.0

2024-07-18

Added property TruckSpecifications.trailerAxleCount for toll cost calculation in routing.
Jira-Ticket: HERESDK-3653.

4.19.1.0

2024-07-09

Added MapFeatures.lowSpeedZones and MapFeatureModes.lowSpeedZonesAll to show areas with reduced speed limits. Only available for Japan currently.
Jira-Ticket: HERESDK-2485.

4.19.1.0

2024-07-09

Provide an option to specify an offset for map measure to storage level mapping. Added class MapMeasureDependentStorageLevels. Added method MapLayerBuilder.withMapMeasureDependentStorageLevels().
Jira-Ticket: HERESDK-3445.

4.19.1.0

2024-07-09

Added CarSpecifications to specify vehicle dimension for CarOptions, EVCarOptions, and TaxiOptions.
Jira-Ticket: HERESDK-3461.

4.19.1.0

2024-07-09

Map style update: Implemented additional icons for grocery, clothing and shoe shopping POIs.
Jira-Ticket: CARTO-324.

4.19.1.0

2024-07-09

Map style update: Implemented Japan specific roadside station icon (michi-no-eki).
Jira-Ticket: CARTO-461.

4.19.0.0

2024-06-24

Extended MapMarker to support the display of user supplied text along with an image. Added MapMarker.TextStyle and MapMarker.TextStyle.Placement to support the encapsulation and configuration of the visual properties of the text of a MapMarker.

List of added MapMarker properties/methods:
* init(GeoCoordinates coordinates, MapImage image, String text)
* String text
* MapMarker.TextStyle textStyle
Jira-Ticket: HERESDK-3069.

4.19.0.0

2024-06-24

Added API to manage light settings in a MapScene.
New API:
* MapScene.lights to retrieve the MapSceneLights instance.
* MapSceneLights.Category enum defines the different categories of lights.
* MapSceneLights.AttributeSettingError enum to define attribute errors on light APIs.
* MapSceneLights.Direction struct to specify a light direction.
* MapSceneLights.AttributeSettingCompletionHandler interface for handling errors on light APIs.
* MapSceneLights.reset() to reset the attributes of all lights to their default values.
* MapSceneLights.setColor(category: Category, color: UIColor, completion: AttributeSettingCompletionHandler?), MapSceneLights.setIntensity(category: Category, intensity: Double, completion: AttributeSettingCompletionHandler?), MapSceneLights.setDirection(category: Category, direction: Direction, completion: AttributeSettingCompletionHandler?) to set the light attributes.
* MapSceneLights.getColor(category: Category), MapSceneLights.getIntensity(category: Category), MapSceneLights.getDirection(category: Category) to retrieve the light attributes.

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.
Jira-Ticket: HERESDK-2533.

4.19.0.0

2024-06-24

Added 'MapScheme.logisticsHybridDay' and 'MapScheme.logisticsHybridNight', hybrid map schemes with focus on fleet management content.
Jira-Ticket: HERESDK-2032.

4.19.0.0

2024-06-24

Added textUsageOption to RouteTextOptions. Defines whether street name, route number and signporst direction should be used when generating maneuver text.
Jira-Ticket: HERESDK-2896.

4.19.0.0

2024-06-24

Removed deprecated AvoidanceOptions.avoidAreas property. Use [AvoidanceOptions.avoidBoundingBoxAreas] instead.
Jira-Ticket: HERESDK-1867.

4.19.0.0

2024-06-24

Remove deprecated instructionFormat attribute from RouteTextOptions.
Jira-Ticket: HERESDK-106.

4.19.0.0

2024-06-24

Removed deprecated TextFormat.
Jira-Ticket: HERESDK-106.

4.19.0.0

2024-06-24

Removed deprecated class PickMapContentResult.PoiResult and property PickMapContentResult.pois. Use sdk.core.PickedPlace and PickMapContentResult.pickedPlaces instead.
Jira-Ticket: HERESDK-3382.

4.19.0.0

2024-06-24

Deprecated:
MapViewBase.PickMapItemsHandler,
MapViewBase.PickMapContentHandler,
MapViewBase.pickMapItems(at centerPoint: Point2D, radius: Double, completion callback: @escaping (PickMapItemsResult?) -> Void) - please use pick() instead,
MapViewBase.pickMapContent(inside viewArea: Rectangle2D, completion callback: @escaping (PickMapContentResult?) -> Void) - please use pick() instead,
MapView.pickMapItems(at centerPoint: Point2D, radius: Double, completion callback: @escaping (PickMapItemsResult?) -> Void) - please use pick() instead,
MapView.pickMapContent(inside viewArea: Rectangle2D, completion callback: @escaping (PickMapContentResult?) -> Void) - please use pick() instead.
Jira-Ticket: HERESDK-2976.

4.19.0.0

2024-06-24

Removed beta label for:
MapViewBase.pick(filter: MapScene.MapPickFilter?, inside viewArea: Rectangle2D, completion callback: @escaping (MapPickResult?) -> Void),
MapView.pick(filter: MapScene.MapPickFilter?, inside viewArea: Rectangle2D, completion callback: @escaping (MapPickResult?) -> Void),
MapViewBase.PickMapHandler,
MapScene.MapPickFilter,
MapPickResult,
MapObjectDescriptor.
Jira-Ticket: HERESDK-2976.

4.19.0.0

2024-06-24

Removed the previously deprecated:
MapCameraAnimationFactory.createAnimation(from cameraUpdate: MapCameraUpdate, duration: TimeInterval, easingFunction: EasingFunction)
MapCameraKeyframeTrack.lookAtDistance(keyframes: [ScalarKeyframe], easingFunction: EasingFunction, interpolationMode: KeyframeInterpolationMode)
MapCameraKeyframeTrack.lookAtTarget(keyframes: [GeoCoordinatesKeyframe], easingFunction: EasingFunction, interpolationMode: KeyframeInterpolationMode)
MapCameraKeyframeTrack.lookAtOrientation(keyframes: [GeoOrientationKeyframe], easingFunction: EasingFunction, interpolationMode: KeyframeInterpolationMode)
MapCameraKeyframeTrack.principalPoint(keyframes: [Point2DKeyframe], easingFunction: EasingFunction, interpolationMode: KeyframeInterpolationMode)
MapCameraKeyframeTrack.normalizedPrincipalPoint(keyframes: [Anchor2DKeyframe], easingFunction: EasingFunction, interpolationMode: KeyframeInterpolationMode)
MapCameraKeyframeTrack.fieldOfView(keyframes: [ScalarKeyframe], easingFunction: EasingFunction, interpolationMode: KeyframeInterpolationMode)
MapItemKeyFrameTrack.moveTo(keyframes: [GeoCoordinatesKeyframe], easingFunction: EasingFunction, interpolationMode: KeyframeInterpolationMode)
MapItemKeyFrameTrack.polylineProgress(keyframes: [ScalarKeyframe], easingFunction: EasingFunction, interpolationMode: KeyframeInterpolationMode)
Use counterpart methods with Easing parameter instead.

Removed the previoulsy deprecated:
MapCameraKeyframeTrack.easingFunction: EasingFunction \{ get \} getter.
Jira-Ticket: HERESDK-764.

4.19.0.0

2024-06-24

icon-text style technique attribute font-size name changed to text-size.

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.
Jira-Ticket: HERESDK-3457.

4.19.0.0

2024-06-24

Added new text-outline-width attribute to icon-text style technique to allow customization of text outline width in pixels.

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.
Jira-Ticket: HERESDK-3310.

4.18.5.0

2024-06-06

Changed endpoint for raster service to RTS (https://maps.hereapi.com/v3/base/mc/\{z\}/\{x\}/\{y\}/jpeg?style=satellite.day&size=512). This endpoint does not support credentials from legacy Developer accounts. See release announcement for HERE SDK 4.18.4.0 for details.
Jira-Ticket: HERESDK-3169.

4.18.5.0

2024-06-06

Updated the supported map measure value range for 'DashImageRepresentation' from [0-20] to [1-20].
Jira-Ticket: HERESDK-2735.

4.18.4.0

2024-05-23

Adds LayerConfiguration.implicitlyPrefetchedFeatures field. Allows API client to specify the list of features to be implicitly prefetched. Also, allows to specify an empty list, effectively disabling implicit prefetching. In such case, trade-off network consumption vs offline capabilities moved to the minimal network consumption.
Jira-Ticket: IOTSDK-23833.

4.18.4.0

2024-05-23

Added MapContentType.point enum value.
Added PointData, PointDataBuilder, PointDataAccessor, PointDataSource and PointDataSourceBuilder for creating and managing custom geodetic point data sources.

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.
Jira-Ticket: HERESDK-786.

4.18.4.0

2024-05-23

Added TripAdvisor support in SearchEngine.setCustomOption.
Jira-Ticket: HERESDK-3124.

4.18.4.0

2024-05-23

Added EngineBaseURL.rasterTileService enum value.
Custom base url for raster service can be specified by providing a custom url template to SDKOptions.
Jira-Ticket: HERESDK-2381.

4.18.3.0

2024-05-16

Added: MapViewBase.pick(filter: MapScene.MapPickFilter?, inside viewArea: Rectangle2D, completion callback: @escaping (MapPickResult?) -> Void),
MapView.pick(filter: MapScene.MapPickFilter?, inside viewArea: Rectangle2D, completion callback: @escaping (MapPickResult?) -> Void),
MapViewBase.PickMapHandler,
MapScene.MapPickFilter,
MapPickResult,
MapObjectDescriptor.
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.
Jira-Ticket: IOTSDK-23699.

4.18.3.0

2024-05-16

Added tolls options support for routing.
Jira-Ticket: IOTSDK-23879.

4.18.3.0

2024-05-16

Fixed RoutingEngine.returnToRoute method where the returned route lacked stopovers when the lastTraveledSectionIndex parameter was zero.
Jira-Ticket: IOTSDK-24164.

4.18.2.0

2024-04-30

Added MapContentType.polygon enum value.
Added PolygonData, PolygonDataBuilder, PolygonDataAccessor, PolygonDataSource and PolygonDataSourceBuilder for creating and managing custom geodetic polygon data sources.

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.
Jira-Ticket: IOTSDK-21033.

4.18.2.0

2024-04-30

Added GeoPolygon(vertices: [GeoCoordinates], innerBoundaries: [[GeoCoordinates]]) to construct a GeoPolygon with inner boundaries (holes) and
GeoPolygon.innerBoundaries member to store and access a GeoPolygon inner boundaries.
Jira-Ticket: IOTSDK-21033.

4.18.2.0

2024-04-30

TimeRule.asString will be removed in v4.21.0. Please use TimeRule.time_rule instead.
Jira-Ticket: IOTSDK-23669.

4.18.2.0

2024-04-30

Map style update: Added dedicated roadshield icon for Indonesia.
Jira-Ticket: CARTODSG-8.

4.18.1.0

2024-04-22

Fixed incorrect side of destination in the notification by exposing side of street information from Routing response if available and side of street hint is provided when requesting a route.
Jira-Ticket: IOTSDK-16639.

4.18.1.0

2024-04-22

Fixed lost camera limits when setting MapCameraLimits.zoomRange.
Jira-Ticket: IOTSDK-23393.

4.18.0.0

2024-04-05

Deprecated sdk.search.SearchError.polylineTooLong. SDK resolves too long polyline issue by itself. sdk.search.SearchError.polylineTooLong will be removed in 4.20.0 version.
Jira-Ticket: IOTSDK-23697.

4.18.0.0

2024-04-05

Enabled Z-Level road rendering.
Jira-Ticket: CARTODSG-432.

4.18.0.0

2024-04-05

Removed the previously deprecated Span.polyline. Use instead Span.geometry.
Jira-Ticket: IOTSDK-18874.

4.18.0.0

2024-04-05

LocationIndicator implementation of MapViewLifecycleDelegate protocol has been removed. Use LocationIndicator.enable and LocationIndicator.disable to add or remove a LocationIndicator from a MapView.
Jira-Ticket: IOTSDK-18871.

4.18.0.0

2024-04-05

Added IsolineRoutingEngine class
Jira-Ticket: IOTSDK-23274.

4.18.0.0

2024-04-05

The method Routing.calculateIsoline is deprecated, the functionality moved to IsolineRoutingEngine class.
Jira-Ticket: IOTSDK-23274.

4.18.0.0

2024-04-05

Added an API MapContext.freeResource() to free resource used by map view objects.
Jira-Ticket: IOTSDK-23774.

4.18.0.0

2024-04-05

Removed deprecated properties for visual properties of a MapPolyline as well as the related constructors. Use MapPolyline.SolidRepresentation and MapPolyline.DashRepresentation with MapPolyline.setRepresentation(Representation) and the constructor MapPolyline(GeoPolyline, Representation) instead.
List of removed methods/properties:
MapPolyline​.init(geometry:widthInPixels:color:))
MapPolyline.init(geometry:widthInPixels:color:outlineWidthInPixels:outlineColor:)
lineWidth,
lineColor,
lineCap,
measureDependentLineWidth,
outlineWidth,
outlineColor,
measureDependentOutlineWidth,
dashPattern,
dashFillColor
Jira-Ticket: IOTSDK-20185.

4.18.0.0

2024-04-05

Explore Edition customers experienced unnecessary requests for vector and satellite tiles that have been already cached. With HERE SDK 4.18.0.0 this has been fixed and new tiles are downloaded earliest after one day based on a LRU strategy.
Jira-Ticket: IOTSDK-23767.

4.18.0.0

2024-04-05

Removed beta label from RoutingEngine.refreshRoute and RoutingEngine.importRoute methods and their overloads, except for taxi mode which remains beta.
Jira-Ticket: IOTSDK-23855.

4.17.5.0

2024-03-19

Added MapContentType.line enum value.
Added DataAttributesBuilder for building DataAttributes instances.
Added DataAttributeValue, DataAttributes and DataAttributesBuilder for creating custom data attributes.
Added LineData, LineDataBuilder, LineDataAccessor, LineDataSource and LineDataSourceBuilder for creating and managing custom geodetic line data sources.

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.
Jira-Ticket: IOTSDK-21031.

4.17.5.0

2024-03-19

Added 'MapScheme.logisticsNight', the dark equivalent to 'MapScheme.logisticsDay'; a map scheme with focus on fleet management content.
Jira-Ticket: IOTSDK-23075.

4.17.5.0

2024-03-19

Removed beta label for MapScene.enableFeatures, MapScene.disableFeatures, MapScene.getSupportedFeatures and MapScene.getActiveFeatures
Jira-Ticket: IOTSDK-23457.

4.17.5.0

2024-03-19

Map style update: Added additional localized bank POIs.
Jira-Ticket: CARTODSG-656.

4.17.5.0

2024-03-19

Fixed density independent pixel scaling for 'MapMarker3d'.
Jira-Ticket: IOTSDK-23191.

4.17.5.0

2024-03-19

Adding timeRule property to TollFare as applicable times for toll cost.
Jira-Ticket: IOTSDK-23607.

4.17.4.0

2024-03-01

Implemented Dynamic POI label placement, which means POI labels could be displayed from the Top, Right, and Left of the POI icon.
Jira-Ticket: CARTODSG-607.

4.17.4.0

2024-03-01

Added outline display for polygonal roads in Japan.
Jira-Ticket: CARTODSG-6.

4.17.4.0

2024-03-01

Added pitch parameter to Location class
Jira-Ticket: IOTSDK-23242.

4.17.4.0

2024-03-01

Added DEAD_RECKONING to LocationTechnology enum
Jira-Ticket: IOTSDK-23242.

4.17.3.0

2024-02-14

Introduced visual improvements for the roads in a hybrid scheme on a zoom-in level. Now transparent roads are displayed without round caps artifacts at the intersection of road segments.
Jira-Ticket: CARTODSG-715.

4.17.3.0

2024-02-14

Added a closed-alpha feature SearchOptions.highDensityEncodingEnabled.
Enabling high density encoding allows input parameters of type GeoCorridor to be encoded
with higher density of coordinates in SearchEngine requests.
Jira-Ticket: IOTSDK-23076.

4.17.2.0

2024-01-31

Added PlaceFilter.EV.minPowerInKilowatts that enables retrieving EV charging stations
with the given minimum charging power.
This is a closed-alpha release of this feature.
Jira-Ticket: IOTSDK-22954.

4.17.2.0

2024-01-31

MapCameraKeyframeTrack.fieldOfView() - values for FoV will be clamped to range [1deg, 150deg]
MapCameraUpdateFactory.setVerticalFieldOfView() - value for FoV will be clamped to range [1deg, 150deg]
Jira-Ticket: IOTSDK-20796.

4.17.2.0

2024-01-31

Enabled display of outlines for water polygons & polylines.
Jira-Ticket: CARTODSG-686.

4.17.2.0

2024-01-31

Added DrawOrderType enum representing the type of map item draw order.
Added MapPolyline.drawOrderType : DrawOrderType property.
Jira-Ticket: IOTSDK-23108.

4.17.1.0

2024-01-17

MapImageOverlay and related API are out of beta state.
Jira-Ticket: IOTSDK-18994.

4.17.1.0

2024-01-17

Fixed missing display of MapMarker for map schemes: .roadNetworkDay and .roadNetworkNight`.
Jira-Ticket: IOTSDK-22629.

4.17.1.0

2024-01-17

Upgrade build system Xcode version from 13.2.1 to version 14.2. The new version will be used for release builds.
Jira-Ticket: IOTSDK-20679.

4.17.1.0

2024-01-17

Changed the start visibility of city labels from class 4 to neighborhoods to be displayed one or two zoom levels earlier, it helps increase city label density.
Jira-Ticket: CARTODSG-706.

4.17.1.0

2024-01-17

Added property PickMapContentResult.pickedPlaces containing a list of PickedPlace results.
Jira-Ticket: IOTSDK-19054.

4.17.1.0

2024-01-17

Deprecated class PickMapContentResult.PoiResult and property PickMapContentResult.pois. Use sdk.core.PickedPlace and PickMapContentResult.pickedPlaces instead.
Jira-Ticket: IOTSDK-19054.

4.17.1.0

2024-01-17

Added PickedPlace.offlineSearchId that holds a place ID.
Jira-Ticket: IOTSDK-19054.

4.17.0.0

2023-12-07

Added Easing class representing an easing function to be used with animations.
Added MapCameraAnimationFactory.createAnimation(from cameraUpdate: MapCameraUpdate, duration: Duration, easing: Easing).
Added MapCameraKeyframeTrack.lookAtDistance(keyframes: [ScalarKeyframe], easing: Easing, interpolationMode: KeyframeInterpolationMode).
Added MapCameraKeyframeTrack.lookAtTarget(keyframes: [GeoCoordinatesKeyframe], easing: Easing, interpolationMode: KeyframeInterpolationMode).
Added MapCameraKeyframeTrack.lookAtOrientation(keyframes: [GeoOrientationKeyframe], easing: Easing, interpolationMode: KeyframeInterpolationMode).
Added MapCameraKeyframeTrack.principalPoint(keyframes: [Point2DKeyframe], easing: Easing, interpolationMode: KeyframeInterpolationMode).
Added MapCameraKeyframeTrack.normalizedPrincipalPoint(keyframes: [Anchor2DKeyframe], easing: Easing, interpolationMode: KeyframeInterpolationMode).
Added MapCameraKeyframeTrack.position(keyframes: [GeoCoordinatesKeyframe], easing: Easing, interpolationMode: KeyframeInterpolationMode).
Added MapCameraKeyframeTrack.orientation(keyframes: [GeoOrientationKeyframe], easing: Easing, interpolationMode: KeyframeInterpolationMode).
Added MapCameraKeyframeTrack.fieldOfView(keyframes: [ScalarKeyframe], easing: Easing, interpolationMode: KeyframeInterpolationMode).
Added MapItemKeyFrameTrack.moveTo(keyframes: [GeoCoordinatesKeyframe], easing: Easing, interpolationMode: KeyframeInterpolationMode).
Added MapItemKeyFrameTrack.polylineProgress(keyframes: [ScalarKeyframe], easing: Easing, interpolationMode: KeyframeInterpolationMode).
Jira-Ticket: IOTSDK-19638.

4.17.0.0

2023-12-07

Deprecated MapCameraAnimationFactory.createAnimation(from cameraUpdate: MapCameraUpdate, duration: Duration, easingFunction: EasingFunction). Use MapCameraAnimationFactory.createAnimation(from cameraUpdate: MapCameraUpdate, duration: Duration, easing: Easing) instead.
Deprecated MapCameraKeyframeTrack.easingFunction property.
Deprecated MapCameraKeyframeTrack.lookAtDistance(keyframes: [ScalarKeyframe], easingFunction: EasingFunction, interpolationMode: KeyframeInterpolationMode). Use MapCameraKeyframeTrack.lookAtDistance(keyframes: [ScalarKeyframe], easing: Easing, interpolationMode: KeyframeInterpolationMode) instead.
Deprecated MapCameraKeyframeTrack.lookAtTarget(keyframes: [GeoCoordinatesKeyframe], easingFunction: EasingFunction, interpolationMode: KeyframeInterpolationMode) Use MapCameraKeyframeTrack.lookAtTarget(keyframes: [GeoCoordinatesKeyframe], easing: Easing, interpolationMode: KeyframeInterpolationMode) instead.
Deprecated MapCameraKeyframeTrack.lookAtOrientation(keyframes: [GeoOrientationKeyframe], easingFunction: EasingFunction, interpolationMode: KeyframeInterpolationMode). Use MapCameraKeyframeTrack.lookAtOrientation(keyframes: [GeoOrientationKeyframe], easing: Easing, interpolationMode: KeyframeInterpolationMode) instead.
Deprecated MapCameraKeyframeTrack.principalPoint(keyframes: [Point2DKeyframe], easingFunction: EasingFunction, interpolationMode: KeyframeInterpolationMode). Use MapCameraKeyframeTrack.principalPoint(keyframes: [Point2DKeyframe], easing: Easing, interpolationMode: KeyframeInterpolationMode) instead.
Deprecated MapCameraKeyframeTrack.normalizedPrincipalPoint(keyframes: [Anchor2DKeyframe], easingFunction: EasingFunction, interpolationMode: KeyframeInterpolationMode). Use MapCameraKeyframeTrack.normalizedPrincipalPoint(keyframes: [Anchor2DKeyframe], easing: Easing, interpolationMode: KeyframeInterpolationMode) instead.
Deprecated MapCameraKeyframeTrack.position(keyframes: [GeoCoordinatesKeyframe], easingFunction: EasingFunction, interpolationMode: KeyframeInterpolationMode). Use MapCameraKeyframeTrack.position(keyframes: [GeoCoordinatesKeyframe], easing: Easing, interpolationMode: KeyframeInterpolationMode) instead.
Deprecated MapCameraKeyframeTrack.orientation(keyframes: [GeoOrientationKeyframe], easingFunction: EasingFunction, interpolationMode: KeyframeInterpolationMode). Use MapCameraKeyframeTrack.orientation(keyframes: [GeoOrientationKeyframe], easing: Easing, interpolationMode: KeyframeInterpolationMode) instead.
Deprecated MapCameraKeyframeTrack.fieldOfView(keyframes: [ScalarKeyframe], easingFunction: EasingFunction, interpolationMode: KeyframeInterpolationMode). Use MapCameraKeyframeTrack.fieldOfView(keyframes: [ScalarKeyframe], easing: Easing, interpolationMode: KeyframeInterpolationMode) instead.
Deprecated MapItemKeyFrameTrack.moveTo(keyframes: [GeoCoordinatesKeyframe], easingFunction: EasingFunction, interpolationMode: KeyframeInterpolationMode). Use MapItemKeyFrameTrack.moveTo(keyframes: [GeoCoordinatesKeyframe], easing: Easing, interpolationMode: KeyframeInterpolationMode) instead.
Deprecated MapItemKeyFrameTrack.polylineProgress(keyframes: [ScalarKeyframe], easingFunction: EasingFunction, interpolationMode: KeyframeInterpolationMode). Use MapItemKeyFrameTrack.polylineProgress(keyframes: [ScalarKeyframe], easing: Easing, interpolationMode: KeyframeInterpolationMode) instead.
Jira-Ticket: IOTSDK-19638.

4.17.0.0

2023-12-07

Removed the previously deprecated templateUrl from RaterDataSourceConfiguration.Provider. Use instead urlProvider which is not optional anymore . TileUrlProviderFactory.fromXyzUrlTemplate() can be used to generate a url provider callback for xyz url template.
Note: The BETA API using TileUrlProviderCallback and TileUrlProviderFactory was promoted to stable.
Jira-Ticket: IOTSDK-18988.

4.17.0.0

2023-12-07

Fixed too long shield text for road shields in Japan when English language is used.
Jira-Ticket: OLPSUP-27378.

4.17.0.0

2023-12-07

Added enum EngineBaseURL.trafficVectorTileService to provide a custom traffic vector tile service url.
Jira-Ticket: IOTSDK-19023.

4.17.0.0

2023-12-07

Added GeoBox.intersection(GeoBox) and static GeoBox.intersection(List<GeoBox>) to find intersection of geo boxes.
Jira-Ticket: IOTSDK-20559.

4.17.0.0

2023-12-07

Added queryForFlow() methods to TrafficEngine for querying traffic flow in a bounding box, a circle, or a corridor. This is a beta release of this feature.
Jira-Ticket: IOTSDK-20554.

4.17.0.0

2023-12-07

Deprecated RouteTextOptions.instructionFormat as it is not supported.
Jira-Ticket: IOTSDK-4468.

4.17.0.0

2023-12-07

Deprecated static function MapView.deinitialize. Deprecated static function MapView.resume, use instead per map view instance resume function. Deprecated static function MapView.pause, use instead per map view instance pause function.
Jira-Ticket: IOTSDK-16349.

4.17.0.0

2023-12-07

Added Style as abstraction of a custom layer style.
Added JsonStyleFactory as a factory of Style from JSON sources.
Added MapLayerBuilder.withStyle(Style) method to provide a custom style when creating a MapLayer.
Added MapLayer.setStyle(Style) method to update a custom layer style.

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.
Jira-Ticket: IOTSDK-20190.

4.17.0.0

2023-12-07

Deprecated AvoidanceOptions.avoidAreas. Use AvoidanceOptions.avoidBoundingBoxAreas instead.
Jira-Ticket: IOTSDK-19958.

4.17.0.0

2023-12-07

Added property avoidPolygonAreas to AvoidanceOptions to enable avoiding polygon-shaped areas during route calculation.
Jira-Ticket: IOTSDK-19958.

4.17.0.0

2023-12-07

Added two enum values to MapScheme: .roadNetworkDay and .roadNetworkNight for a road network only map without labels. It is used for mini maps that provide an overview of an upcoming maneuver.
Jira-Ticket: IOTSDK-19842.

4.16.4.0

2023-11-22

Only part of ALPHA RELEASE builds: Added queryForFlow() to TrafficEngine for querying traffic flow in a bounding box, a circle, or a corridor.
Jira-Ticket: IOTSDK-19472.

4.16.4.0

2023-11-22

Added property trafficOptimizationMode to RouteOptions. Added enum TrafficOptimizationMode used to specify traffic optimisation mode and containing also value for complete disabling of traffic optimisation.
Jira-Ticket: IOTSDK-17972.

4.16.4.0

2023-11-22

Deprecated RouteOptions.enableTrafficOptimization. Use RouteOptions.trafficOptimizationMode instead.
Jira-Ticket: IOTSDK-17972.

4.16.4.0

2023-11-22

Added POIPaymentDetails, POIPaymentMethod and Details.payment to show the available
payment options at a POI. This is a beta feature and thus subject to change.
Jira-Ticket: IOTSDK-19892.

4.16.4.0

2023-11-22

Improved State and County Capital Label Priority.
Jira-Ticket: CARTODSG-675.

4.16.4.0

2023-11-22

Implemented new coach and updated tram icon.
Jira-Ticket: CARTODSG-682.

4.16.4.0

2023-11-22

Added builtUpArea and controlledAccessHighway to StreetAttributes enum.
Jira-Ticket: IOTSDK-20220.

4.16.4.0

2023-11-22

Deprecated controlledAccess enum value in StreetAttributes. Use instead controlledAccessHighway.
Jira-Ticket: IOTSDK-20220.

4.16.4.0

2023-11-22

Removed closed-alpha APIs sdk.search.EVPaymentMethod and sdk.search.PlaceFilter.EV.paymentMethods.
Jira-Ticket: IOTSDK-20465.

4.16.4.0

2023-11-22

Improved toll tunnel styling for Japan day, night and logistics scenes.
Jira-Ticket: CARTODSG-673.

4.16.3.0

2023-11-09

Added shadows constant to MapFeatures as well as shadowsAll constant to MapFeatureModes to enable/disable shadows feature. Added enum ShadowQuality. Added MapView.shadowQuality property to set and get shadow quality.
Jira-Ticket: IOTSDK-19109.

4.16.3.0

2023-11-09

Added minChargetAtFirstChargingStationInKilowattHours to BatterySpecifications. It indicates the minimum charge when arriving at first charging station in kWh.
Jira-Ticket: IOTSDK-19369.

4.16.3.0

2023-11-09

Add CalculationOptionsType.PRIVATE_BUS. Add CalculationOptions.private_bus_options. Add PrivateBusOptions struct. Add RoutingInterface.calculate_route method for private bus transport mode.
Jira-Ticket: IOTSDK-19575.

4.16.3.0

2023-11-09

Added RoutingEngine.import_route method for private bus routing. Added RefreshRouteOptions constructor for private bus routing.
Jira-Ticket: IOTSDK-19575.

4.16.3.0

2023-11-09

Added mountain peak elevation visualization.
Jira-Ticket: CARTODSG-20.

4.16.3.0

2023-11-09

Only part of ALPHA RELEASE builds: Added GeoBox.intersection(GeoBox) and static GeoBox.intersection(List<GeoBox>) to find intersection of geo boxes.
Jira-Ticket: IOTSDK-19227.

4.16.3.0

2023-11-09

Added maxWeightPerAxleGroupInKilograms to ViolatedRestriction. Indicates where the max permitted weight per axle group during the trip in kilograms is exceeded.
Jira-Ticket: IOTSDK-19780.

4.16.3.0

2023-11-09

Known issue with ViolatedRestriction.maxWeightPerAxleGroupInKilograms. It works only for online routing engine.
Jira-Ticket: IOTSDK-19780.

4.16.2.0

2023-10-27

added BusOptions.BusSpecifications for bus routing features
Jira-Ticket: IOTSDK-19366.

4.16.2.0

2023-10-27

Added Details.foodTypes to show food types assigned to a place.
Jira-Ticket: IOTSDK-19551.

4.16.2.0

2023-10-27

IOTSDK-19405: Added Environmental zone notice details. Added routingZoneReference to ViolatedRestriction.Details.
Jira-Ticket: IOTSDK-19405.

4.16.2.0

2023-10-27

IOTSDK-19601: Added payload capacity notice details. Added maxPayloadCapacityInKilograms to ViolatedRestriction.Details.
Jira-Ticket: IOTSDK-19601.

4.16.2.0

2023-10-27

added SectionTransportMode.PRIVATE_BUS
Jira-Ticket: IOTSDK-19574.

4.16.2.0

2023-10-27

added TransportMode.PRIVATE_BUS
Jira-Ticket: IOTSDK-19574.

4.16.2.0

2023-10-27

Map style update: Added the green and white road shield icon to indicate the Trans-Canada highway on the MapView.
Jira-Ticket: CARTODSG-118.

4.16.2.0

2023-10-27

Added RoutingEngine.importRoute functions that accept BicycleOptions, ScooterOptions, PedestrianOptions. There are two overloads - one without 'RouteStop' and one with
'RouteStop' argument.
Jira-Ticket: IOTSDK-19694.

4.16.2.0

2023-10-27

Only part of ALPHA RELEASE builds: Internal: JSON Styles - line-progress technique polyline-progress attribute was renamed to progress.
Jira-Ticket: IOTSDK-19442.

4.16.2.0

2023-10-27

Two new language codes of ES_AR (Argentinian Spanish) and NL_BE (Flemish) have been added to the list of supported language code.
Jira-Ticket: IOTSDK-6227.

4.14.4.1

2023-10-05

Prevent empty exit number label display in map at zoom levels < 15.
Jira-Ticket: IOTSDK-19348.

4.16.1.0

2023-10-16

Removed deprecated log levels: LogLevel.logLevelTrace and LogLevel.logLevelDebug. Removed SDKNativeEngine.setLogAppender(LogAppender) method, use LogControl API instead.
Jira-Ticket: IOTSDK-16982.

4.16.1.0

2023-10-16

Added 'SDKNativeEngine.passThroughFeature' property to support PassThroughFeature.
Jira-Ticket: IOTSDK-18442.

4.16.1.0

2023-10-16

Only part of ALPHA RELEASE builds: Changed API MapPolyline.DashRepresentation and MapPolyline.SolidRepresentation to be immutable. Removed all setters. Add additional parameter of type LineCap to the related constructors.
Jira-Ticket: IOTSDK-19309.

4.16.1.0

2023-10-16

Added MapPolyline.SolidRepresentation and MapPolyline.DashRepresentation to encapsulate the visual properties of a MapPolyline.
Jira-Ticket: IOTSDK-18505.

4.16.1.0

2023-10-16

Deprecated properties for visual properties of a MapPolyline as well as the related constructors. Use MapPolyline.SolidRepresentation and MapPolyline.DashRepresentation with MapPolyline.setRepresentation(Representation) and the constructor MapPolyline(GeoPolyline, Representation) instead.
List of deprecated methods/properties:
MapPolyline​.init(geometry:widthInPixels:color:))
MapPolyline.init(geometry:widthInPixels:color:outlineWidthInPixels:outlineColor:)
lineWidth,
lineColor,
lineCap,
measureDependentLineWidth,
outlineWidth,
outlineColor,
measureDependentOutlineWidth,
dashPattern,
dashFillColor
Jira-Ticket: IOTSDK-18505.

4.16.1.0

2023-10-16

Removed beta label for MapMeasureDependentRenderSize representing a render size, described as map measure dependent values.
Jira-Ticket: IOTSDK-18505.

4.16.1.0

2023-10-16

Removed beta label for MapPolyline.Representation and `MapPoyline.setRepresentation(_:).
Jira-Ticket: IOTSDK-18505.

4.16.1.0

2023-10-16

Added property id to TrafficIncidentOnRoute
Jira-Ticket: IOTSDK-19406.

4.16.1.0

2023-10-16

Added 'PlaceFoodType', 'CategoryQuery.includeFoodTypes' and 'CategoryQuery.excludeFoodTypes'
to support food type filtering.
Jira-Ticket: IOTSDK-14081.

4.16.1.0

2023-10-16

Only part of ALPHA RELEASE builds: Internal: JSON Styles - styleSet keyword was renamed to layer, line technique fillColor attribute was renamed to dash-gap-color and raster technique blend-factor attribute was renamed to opacity.
Jira-Ticket: IOTSDK-19439.

4.16.1.0

2023-10-16

Added more granular categorization and visualization of truck restrictions related to amount of axles: weight per axle group, weight per axle number, axle group restriction.
Jira-Ticket: CARTODSG-490.

4.16.1.0

2023-10-16

The method MapContentSettings.setTrafficRefreshPeriod(_ value: TimeInterval) now correctly updates the refresh frequency for upcoming requests.
Jira-Ticket: IOTSDK-19480.

4.16.1.0

2023-10-16

Changed default font for svg text rendering back to regular. It was changed to bold font accidentally since release 4.14.5.
Jira-Ticket: IOTSDK-18808.

4.16.0.0

2023-10-10

Removed deprecated function CatalogVersionHint.latest(). Use instead CatalogVersionHint.latest(Bool).
Jira-Ticket: IOTSDK-17205.

4.16.0.0

2023-10-10

Removed deprecated log levels: LogLevel.logLevelTrace and LogLevel.logLevelDebug. Removed SDKNativeEngine.setLogAppender(LogAppender) method, use LogControl API instead.
Jira-Ticket: IOTSDK-16982.

4.16.0.0

2023-10-10

Show traffic road closure icon, when road is closed; independent of incident type.
Jira-Ticket: CARTODSG-532.

4.16.0.0

2023-10-10

Removed deprecated option: RouteOptions.enable_enter_highway_maneuver_action.
Jira-Ticket: IOTSDK-18061.

4.16.0.0

2023-10-10

Added enum EngineBaseURL.trafficData to provide custom traffic data url
Jira-Ticket: IOTSDK-19023.

4.16.0.0

2023-10-10

Removed deprecated method MapViewBase.setWatermarkPlacement(_ placement: WatermarkPlacement, bottomMargin: Int32).
Jira-Ticket: IOTSDK-18987.

4.16.0.0

2023-10-10

Added MapMeasureDependentRenderSize to represent a render size, described as map measure dependent values.

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.
Jira-Ticket: IOTSDK-18504.

4.16.0.0

2023-10-10

Changed BETA API MapPolyline.DashImageRepresentation to be immutable. Use MapMeasureDependentRenderSize type as size input parameter instead of a map of (double, double).
Jira-Ticket: IOTSDK-18504.

4.16.0.0

2023-10-10

Made GeoBox.envelope(GeoBox) and static GeoBox.envelopeGeoBoxes(List<GeoBox>) to envelope two or more geo boxes public.
Jira-Ticket: IOTSDK-19385.

4.16.0.0

2023-10-10

Added MapContentSettings.setTrafficRefreshPeriod(_ value: TimeInterval) method to change traffic refresh period and MapContentSettings.resetTrafficRefreshPeriod() to reset applied traffic refresh period.
Jira-Ticket: IOTSDK-18111.

4.16.0.0

2023-10-10

The method MapContentSettings.setTrafficRefreshPeriod(_ value: TimeInterval) might have no effect, because the values might be internally overridden after some time.
Jira-Ticket: IOTSDK-19480.

4.15.5.0

2023-09-18

Added MapCameraUpdateFactory.compositeUpdate([MapCameraUpdate]) function to support the creation of composite MapCameraUpdate instances.
Jira-Ticket: IOTSDK-17968.

4.15.5.0

2023-09-18

Implemented bathymetry for normal day and night
Jira-Ticket: CARTODSG-542.

4.15.5.0

2023-09-18

Added two MapCameraUpdateFactory.lookToMatch functions that match a given geo point to a given view point. This is a beta release of this feature, so there could be a few bugs and unexpected behavior. Related APIs may change for new releases without a deprecation process.
Jira-Ticket: IOTSDK-18772.

4.15.5.0

2023-09-18

Introduced new enum TruckRoadTypes to represent Swedish BK classes and Mexican truck road types.
The Truck Road Type link-attribute represents truck specific networks that have complex restrictions specified. The Truck Road Type attribute can reference a LAT file, which contains detailed vehicle specs that are corresponding to some BK class.
Note that for Sweden, a reference table is not provided. Truck drivers know which BK class their truck complies to; hence they will not depend on a system to calculate the BK class.
Jira-Ticket: IOTSDK-19027.

4.15.5.0

2023-09-18

Fixed the generated ManeuverAction occurring from one highway to another highway. It is considered as a FORK based on the turn direction.
Jira-Ticket: OLPSUP-24250.

4.15.5.0

2023-09-18

Updated Gluecodium version from 13.6.4 to 13.7.0
Jira-Ticket: IOTSDK-19154.

4.15.5.0

2023-09-18

Added sdk.search.EVChargingPool.cpoId and sdk.search.EVChargingPool.evseInfo as closed-alpha that contain info about CPO (Charge Point Operator) ID for charging pool and Electric Vehicle Supply Equipment ID (EVSE ID) for an exact identification of the charging infrastructure and charging point. These IDs are represented as String. Note: Participants of the closed-alpha group can get access from HERE to use this feature. If the credentials are not enabled, a [SearchError.forbidden] will be propagated.
Jira-Ticket: IOTSDK-18993.

4.15.5.0

2023-09-18

Added sdk.search.PlaceFilter.ev.paymentMethods and sdk.search.EVPaymentMethod enum as closed-alpha that contain info about available payment methods. There is no possibility to check payment methods in search results at the moment, only set them as input filter.Note: Participants of the closed-alpha group can get access from HERE to use this feature. If the credentials are not enabled, a [SearchError.FORBIDDEN] will be propagated.
Jira-Ticket: IOTSDK-19042.

4.15.5.0

2023-09-18

Added collection of TruckRoadType elements to TruckOptions and EVTruckOptions. Updated serialization of corresponding options. This provides user possibility of setting restrictions regarding truck road types.
Jira-Ticket: IOTSDK-19028.

4.15.5.0

2023-09-18

Added GeoBox.envelope(GeoBox) and static GeoBox.envelopeGeoBoxes(List<GeoBox>) to envelope two or more geo boxes.
Jira-Ticket: IOTSDK-18980.

4.15.5.0

2023-09-18

Added generation of detailed section notice warning for violated truck road type. Added VIOLATED_AVOID_TRUCK_ROAD_TYPE to SectionNoticeCode, forbidden_truck_road_types to ViolatedRestriction.
Jira-Ticket: IOTSDK-19029.

4.15.4.0

2023-09-05

sdk.search.PlaceFilter.ev.supplierNames and sdk.search.PlaceFilter.ev.connectorTypeIDs fields are publicly available as closed-alpha.
Jira-Ticket: IOTSDK-18519.

4.15.4.0

2023-09-05

Map style update: Lite night scheme was redesigned to have dark street colors. Other map elements were styled accordinly to fit the new design. Dark streets are better aligned with lite day. All streets are white in lite day, and all streets are dark in lite night.
Jira-Ticket: CARTODSG-618.

4.15.4.0

2023-09-05

Country boundary display was improved by increasing line width and apply a more saturated color. State boundary display changes now on zoomed in levels from a solid to a dashed line.
Jira-Ticket: CARTODSG-520.

4.15.4.0

2023-09-05

Removes importRoute(routeHandle: RouteHandle, refreshRouteOptions: RefreshRouteOptions, completion: @escaping CalculateRouteCompletionHandler) -> TaskHandle where RefreshRouteOptions are constructed with BicycleOptions, PedestrianOptions, or ScooterOptions. Removes RoutingEngine.importRoute(with locations: [Location], bicycleOptions: BicycleOptions, completion: @escaping CalculateRouteCompletionHandler) -> TaskHandle, RoutingEngine.importRoute(with locations: [Location], pedestrianOptions: PedestrianOptions, completion: @escaping CalculateRouteCompletionHandler) -> TaskHandle and importRoute(with locations: [Location], scooterOptions: ScooterOptions, completion: @escaping CalculateRouteCompletionHandler) -> TaskHandle.
Jira-Ticket: IOTSDK-18911.

4.15.4.0

2023-09-05

Added new RoutingEngine.importRoute function which accepts RouteStop list. 'RouteStop' contains index of location point provided in track and stop delay if one present. During navigation the RouteStop will be treated as stopover and will be reported as milestone when passing-by
Jira-Ticket: IOTSDK-18910.

4.15.4.0

2023-09-05

Added political view support for base map labels.
Jira-Ticket: IOTSDK-17085.

4.15.4.0

2023-09-05

Added method MapScene.reloadScene to reload the currently loaded scene preserving MapFeature settings. This method skips internal optimization checks done by the various methods to load a scene.
Jira-Ticket: IOTSDK-19108.

4.15.3.0

2023-08-24

LocationIndicator implementing MapViewLifecycleListener is deprecated. Instead, LocationIndicator.enable and LocationIndicator.disable can be used to add/remove LocationIndicator to/from a MapViewBase.
Jira-Ticket: IOTSDK-17259.

4.15.3.0

2023-08-24

Only part of ALPHA RELEASE builds: Added MapMeasureDependentRenderSize that represents a render size, described as map measure dependent values. Added MapPolyline.SolidRepresentation that is used to manipulate properties of solid MapPolyline.
Jira-Ticket: IOTSDK-17859.

4.15.3.0

2023-08-24

Added struct RouteOffset, struct RouteRailwayCrossing, struct RouteRailwayCrossingType and property Route.railway_crossings
Jira-Ticket: IOTSDK-18632.

4.15.2.0

2023-08-03

Removed sdk.search.TextQuery.fuelTypes, sdk.search.TextQuery.truckFuelTypes, sdk.search.TextQuery.truckClass. Use instead sdk.search.TextQuery.placeFilter.
Jira-Ticket: IOTSDK-18486.

4.15.2.0

2023-08-03

Added 'urlProvider' to 'RasterDataSourceConfiguration.Provider', a callback that will be invoked to get url for each tile.
Added 'TileUrlProviderFactory.fromXyzUrlTemplate()' function, which can be used to generate a url provider callback for xyz url template.
Marked 'templateUrl' in 'RaterDataSourceConfiguration::Provider' to be deprecated from v4.17.0

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.
Jira-Ticket: IOTSDK-17398.

4.15.2.0

2023-08-03

Removed sdk.search.CategoryQuery.fuelTypes, sdk.search.CategoryQuery.truckFuelTypes, sdk.search.CategoryQuery.truckClass. Use instead sdk.search.CategoryQuery.placeFilter.
Jira-Ticket: IOTSDK-18489.

4.15.2.0

2023-08-03

Added sdk.search.CategoryQuery.placeFilter, sdk.search.TextQuery.placeFilter and sdk.search.PlaceFilter that is used to specify place filtering options.
Jira-Ticket: IOTSDK-18489.

4.15.2.0

2023-08-03

Implementation of country specific public transit iconography
Jira-Ticket: CARTODSG-273.

4.15.1.0

2023-07-25

Only part of ALPHA RELEASE builds: Added MapScene.loadScene(fromFile: String, enabledFeatures: Map<String, String>, disabledFeatures: List<String>, completion: LoadSceneCompletionHandler), MapScene.loadScene(fromFile: String, enabledFeatures: Map<String, String>, completion: LoadSceneCompletionHandler) and MapScene.loadScene(mapScheme: MapScheme, enabledFeatures: Map<String, String>, completion: LoadSceneCompletionHandler) that loads a scene and configures its features.
Jira-Ticket: IOTSDK-18304.

4.15.1.0

2023-07-25

Exposed styling of Restricted Access Roads which gets applied if road segment is flagged either as 'Private', Service Road' or 'Public Access = no'
Jira-Ticket: CARTODSG-474.

4.15.1.0

2023-07-25

Shared instance of SDKNativeEngine is not created automatically on startup. Customer must create it explicitly. Options are not read from plist. The class OptionReader is completelly removed. SDKOptions.cachePath and SDKOptions.persistentMapStoragePath are empty now after initialization and any relative path is concerned relative to <Application_Home>/Library/Caches and Application Library directory respectivelly. Previously those paths contained default paths <Application_Home>/Library/Caches and Application Library directory after initialization of SDKOptions.
Jira-Ticket: IOTSDK-13832.

4.15.1.0

2023-07-25

Added specific prefix for sdk log output
Jira-Ticket: IOTSDK-17323.

4.15.1.0

2023-07-25

Improved outline styling for Environmental & Congestion Zone polygons
Jira-Ticket: CARTODSG-548.

4.15.0.0

2023-07-13

Added roadExitLabels constant to MapFeatures as well as roadExitLabelsNumbersOnly and roadExitLabelsAll constants to MapFeatureModes to enable/disable road exit labels feature.
Jira-Ticket: IOTSDK-17484.

4.15.0.0

2023-07-13

Deleted SDKOptions.enableIndexing flag. Use instead OfflineSearchEngine.setIndexOptions.
Jira-Ticket: IOTSDK-17978.

4.15.0.0

2023-07-13

Add offsetStart and offsetEnd properties to SegmentReference class
Jira-Ticket: IOTSDK-18045.

4.15.0.0

2023-07-13

Removed deprecated MapFeatureMode.trafficFlowRegionSpecific. Please use MapFeatureModes.trafficFlowJapanWithoutFreeFlow instead.
Jira-Ticket: IOTSDK-14409.

4.15.0.0

2023-07-13

Added MapPolyline.measureDependentLineWidth, MapPolyline.measureDependentOutlineWidth and MapArrow.measureDependentTailWidth properties to set and get the line and outline width of a MapPolyline and the tail width of a MapArrow depending on camera zoom level. Please note that this is a beta release of this API.
Jira-Ticket: IOTSDK-13048.

4.15.0.0

2023-07-13

Added class MapPolyline.Representation that is a base class for classes defining visual appearance of MapPolyline.
Added class MapPolyline.DashImageRepresentation used to render MapPolyline as a series of images placed along polyline.
Added contructor
MapPolyline.init(geometry: GeoPolyline, representation: MapPolyline.Representation) that allows to create
polyline that is using MapPolyline.Representation for defining visual appearance of line.
Added a function public func MapPolyline.setRepresentation(_ representation: MapPolyline.Representation) used to change visual appearance of polyline.
Jira-Ticket: IOTSDK-17427.

4.15.0.0

2023-07-13

Removed deprecated TextQuery.includeChains and TextQuery.includeChains.
Please use CategoryQuery.includeChains and CategoryQuery.excludeChains instead.
Jira-Ticket: IOTSDK-15537.

4.15.0.0

2023-07-13

Added class 'PassThroughWaypoint' and Section.passthroughWaypoints property.
Jira-Ticket: IOTSDK-17886.

4.15.0.0

2023-07-13

Implemented new POI icon for EV Charging
Jira-Ticket: CARTODSG-433.

4.15.0.0

2023-07-13

Added 'MapScheme.logisticsDay', a day version map scheme with focus on fleet management content.
Jira-Ticket: IOTSDK-16237.

4.15.0.0

2023-07-13

Added sdk.core.engine.UsageStats struct that gathers statistics of the HERE SDK network usage for uploaded and downloaded data. SDKNativeEngine.getSdkUsageStats() and SDKNativeEngine.enableUsageStats() were added to use this feature. Please note that this is a beta release for UsageStats feature.
Jira-Ticket: IOTSDK-16164.

4.15.0.0

2023-07-13

Added isOffRoad method to the RoutePlace that indicates if a route place is off-road or not.
Jira-Ticket: IOTSDK-17445.

4.15.0.0

2023-07-13

Added SDKNativeEngine.clearPersistentUsageStats() and SDKNativeEngine.clearUsageStatsCache() functions. This is a beta release of this feature, so there could be a few bugs and unexpected behaviors.
Jira-Ticket: IOTSDK-16327.

4.15.0.0

2023-07-13

Removes deprecated MapScene.Layers. MapScene.setLayerVisibility can no longer be used to enable/disable map features. Please use MapScene.enableFeatures and MapScene.disableFeatures instead.
Jira-Ticket: IOTSDK-13835.

4.15.0.0

2023-07-13

The altitude of the look at target point is ignored. Any subsequent camera updates and animations will consider the target point as being located on the ground.
Impacted functions: MapCameraAnimationFactory.flyTo functions, MapCamera.lookAt functions and MapCameraUpdateFactory.lookAt functions.
Jira-Ticket: IOTSDK-14988.

4.15.0.0

2023-07-13

Hamlets are city center labels for small villages, previous were visible from zoom level 14. At mobile map looks a bit empty at zl 13, so visibily moved to zoom level 13.
Jira-Ticket: CARTODSG-551.

4.15.0.0

2023-07-13

Removed the previously deprecated MapCameraKeyframeTrack.focalLength() method. Use MapCameraKeyframeTrack.fieldOfView() instead.
Removed the previously deprecated MapCameraKeyframeTrack.setFocalLength() method. Use MapCameraKeyframeTrack.setVerticalFieldOfView() instead.
Jira-Ticket: IOTSDK-18269.

4.15.0.0

2023-07-13

Added bounding_box into sdk.search.Place.serializeCompact().
Jira-Ticket: IOTSDK-18326.

4.14.5.0

2023-06-27

Added an API to obtain road-shield icons. Added classes IconProvider, RoadShieldIconProperties
and enum RouteType. Added method IconProvider.createRoadShieldIcon() to which the interface
IconProvider.IconProviderCallback is passed which receives a UIImage with the generated road-shield icon or an error code.

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.
Jira-Ticket: IOTSDK-17270.

4.14.5.0

2023-06-27

Only part of ALPHA RELEASE builds: Added MapPolyline.measureDependentLineWidth, MapPolyline.measureDependentOutlineWidth and MapArrow.measureDependentLineWidth properties to set and get the [outline] width of these objects depending on camera distance/zoom level.
Jira-Ticket: IOTSDK-13048.

4.14.5.0

2023-06-27

Added property roadNumbers to get route numbers from span with extra information e.g. route type and direction. Added property routeType to LocalizedRoadNumber.
Jira-Ticket: IOTSDK-16851.

4.14.5.0

2023-06-27

Improved visual styling for Tunnels in map styles.
Jira-Ticket: CARTODSG-119.

4.14.5.0

2023-06-27

Expose LayerConfiguration to allow API client to specify the list of features to enable for map download. By disabling map features that are not essential for the application, it is possible to reduce the size of the map to download.
Jira-Ticket: IOTSDK-15098.

4.14.5.0

2023-06-27

Only part of ALPHA RELEASE builds: Added publicTransit constant to MapFeatures and publicTransitAll and publicTransitAsia constants to MapFeatureModes to enable/disable public transit feature.
Jira-Ticket: IOTSDK-17337.

4.14.5.0

2023-06-27

Added getShieldText method on Span to be used together with Span.getRoadNumbers to prepare shieldText field in RoadShieldIconProperties.
Jira-Ticket: IOTSDK-6287.

4.14.4.0

2023-06-09

Added an API for a map polyline to block vehicle restriction icons. Added MapPolyline.mapContentCategoriesToBlock : [MapContentCategory] property. Added MapContentCategory enum.
Jira-Ticket: IOTSDK-17282.

4.14.4.0

2023-06-09

Implemented new POI icon for Art Museum category
Jira-Ticket: CARTODSG-547.

4.14.3.0

2023-05-24

Added 'MapScheme.liteDay', 'MapScheme.liteNight', 'MapScheme.liteHybridDay', 'MapScheme.liteHybridNight' schemes, which are the simplified versions of the respective normal map schemes.
Jira-Ticket: IOTSDK-17336.

4.14.2.0

2023-05-10

Improved visual hierarchy of city labels in map styles.
Jira-Ticket: CARTODSG-524.

4.14.1.0

2023-05-08

Added authenticationMode in SDKOptions. Please note that this is a beta release of the AuthenticationMode feature. There could be a few bugs and unexpected behaviors. Related APIs may change for new releases without a deprecation process.
Jira-Ticket: IOTSDK-15681.

4.14.1.0

2023-05-08

Removed deprecated geo fields and constructors of sdk.search.TextQuery and sdk.search.CategoryQuery. Use newly added constructors taking sdk.search.TextQuery.Area and sdk.search.CategoryQuery.Area instead.
Jira-Ticket: IOTSDK-14246.

4.14.1.0

2023-05-08

Implementation of GTFS public transit access POIs available with OCM map version 79
Jira-Ticket: CARTODSG-173.

4.14.1.0

2023-05-08

Removed deprecated CategoryQuery.withExcludeCategories. Please set excludeCategories directly using categoryQueryObject.excludeCategories.
Jira-Ticket: IOTSDK-14246.

4.14.1.0

2023-05-08

Improved & aligned naming convention of Traffic Styling variables
Jira-Ticket: CARTODSG-516.

4.14.0.0

2023-04-28

Removed deprecated methods MapCamera.lookAt(point: GeoCoordinates, distanceInMeters: Double) and MapCamera.lookAt(point: GeoCoordinates, orientation: GeoOrientationUpdate, distanceInMeters: Double). Use MapCamera.lookAt(point: GeoCoordinates, zoom: MapMeasure) and MapCamera.lookAt(point: GeoCoordinates, orientation: GeoOrientationUpdate, zoom: MapMeasure) instead.
Jira-Ticket: IOTSDK-11527.

4.14.0.0

2023-04-28

Allow avoiding U-turns for cars, taxis and buses in online route calculations.
Jira-Ticket: IOTSDK-14541.

4.14.0.0

2023-04-28

Removed deprecated method MapView.pickMapFeatures and class PickMapFeaturesResult.
Jira-Ticket: IOTSDK-12995.

4.14.0.0

2023-04-28

Removed display of truck speed restriction icon + line for vehicle restriction map feature.
Jira-Ticket: IOTSDK-16389.

4.14.0.0

2023-04-28

PASSED notification is not published if AHEAD notification was not published before
Jira-Ticket: IOTSDK-16573.

4.14.0.0

2023-04-28

Added CatalogConfiguration.getDefault(CatalogType) API to get default catalog configuration for so-called "rest of the world" and Japan.
Jira-Ticket: IOTSDK-16544.

4.14.0.0

2023-04-28

Removed Section.trafficSpeeds property. Use instead Span.trafficSpeed property. Removed TrafficSpeed.offset. Use instead Span.sectionPolylineOffset property.
Jira-Ticket: IOTSDK-16921.

4.14.0.0

2023-04-28

Removed the previously deprecated MapView.setWatermarkPosition function. Use instead MapView.setWatermarkLocation.
Jira-Ticket: IOTSDK-13061.

4.14.0.0

2023-04-28

Fix Slovenian language definition
Jira-Ticket: IOTSDK-16997.

4.14.0.0

2023-04-28

Added outlineColor and outlineWidth property to class MapPolygon to enable display of polygon outline.
Jira-Ticket: IOTSDK-16922.

4.14.0.0

2023-04-28

Implementation of GTFS public transit POIs with icon grouping display available on the map with OCM map version 78
Jira-Ticket: CARTODSG-67.

4.14.0.0

2023-04-28

Implementation and styling Unpaved road attributes. Unpaved road fill color, outline color, labels are styled with brownish tint
Jira-Ticket: CARTODSG-475.

4.14.0.0

2023-04-28

Enabled Desert polygon display for OCM
Jira-Ticket: CARTODSG-96.

4.13.5.0

2023-03-28

Added read only property signpost to get signpost information. SignpostLabel.direction will replace RoadTexts.towards for getting information about direction.
Jira-Ticket: IOTSDK-13004.

4.13.5.0

2023-03-28

Added violatedRestrictions : [ViolatedRestriction] property to class SectionNotice
Jira-Ticket: IOTSDK-16484.

4.13.5.0

2023-03-28

RealisticViewWarning.realistic_view will have empty strings for junction_view_svg_image_content and signpost_svg_image_content when distance_type is PASSED
Jira-Ticket: IOTSDK-16371.

4.13.5.0

2023-03-28

Added Span.countryCode property.
Jira-Ticket: IOTSDK-16458.

4.13.5.0

2023-03-28

Road sign notifications and natural guidance now read road signs on the correct road side.
Jira-Ticket: IOTSDK-16203.

4.13.5.0

2023-03-28

ManeuverAction.enterHighwayFromLeft and ManeuverAction.enterHighwayFromRight are properly generated when RouteOptions.enableEnterHighwayManeuverAction is set.
Jira-Ticket: IOTSDK-15292.

4.13.5.0

2023-03-28

Added LocationIndicator.opacity property to set and get opacity of a location indicator.
Jira-Ticket: IOTSDK-15656.

4.13.5.0

2023-03-28

Only part of ALPHA RELEASE builds: Added SDKOptions.enableIndexing flag that controls indexing over persistent map.
Jira-Ticket: IOTSDK-16682.

4.13.5.0

2023-03-28

New structure of a list of LocalizedRoadNumber is now available.
Jira-Ticket: IOTSDK-13008.

4.13.5.0

2023-03-28

The numbersWithDirection field in RoadTexts has been added to contain road numbers with direction. This new field is aimed to replace the deprecated numbers field in RoadTexts.
Jira-Ticket: IOTSDK-13008.

4.13.5.0

2023-03-28

The numbers field in RoadTexts is deprecated and it will be removed as per SDK version 4.16.0. Please use numbersWithDirection field to obtain road numbers information.
Jira-Ticket: IOTSDK-13008.

4.13.4.0

2023-03-01

Added PickMapItemsResult.markers3d read-only property that holds the list of picked MapMarker3D instances.
Jira-Ticket: IOTSDK-14570.

4.13.4.0

2023-03-01

Added MapMarker3D.visibilityRanges : [MapMeasureRange] property.
Jira-Ticket: IOTSDK-7787.

4.13.4.0

2023-03-01

Added visibilityRanges property to MapPolyline
Jira-Ticket: IOTSDK-5058.

4.13.4.0

2023-03-01

Added offlineMode to SDKOptions so app can start in offline mode.
Jira-Ticket: IOTSDK-15993.

4.13.4.0

2023-03-01

Added ignoreCachedData option to sdk.core.engine.CatalogVersionHint.latest(), which allows to update catalog version when cache contains data.
Jira-Ticket: IOTSDK-16257.

4.13.4.0

2023-03-01

This version of the HERE SDK is delivered with map data v71 for ROW catalog and v67 for JPN catalog.
Jira-Ticket: IOTSDK-16329.

4.13.4.0

2023-03-01

Added MapMarker.visibilityRanges : [MapMeasureRange] property.
Jira-Ticket: IOTSDK-16118.

4.13.4.0

2023-03-01

Added SDKNativeEngine.proxySettings property to get/set the proxy settings that will be used by HERE SDK
network for all requests.

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.
Jira-Ticket: IOTSDK-15417.

4.13.4.0

2023-03-01

Deprecated sdk.core.engine.CatalogVersionHint.latest(). Use sdk.core.engine.CatalogVersionHint.latest(Boolean) instead.
Jira-Ticket: IOTSDK-16257.

4.13.4.0

2023-03-01

Fixed map feature handling when invalid feature mode is specified. Now features with invalid mode are ignored.
Jira-Ticket: IOTSDK-13916.

4.13.3.0

2023-02-15

Added designated constructor to MapView as MapView.init(frame: CGRect, withSdkEngine: SDKNativeEngine, withOptions: MapViewOptions?)
Jira-Ticket: IOTSDK-15811.

4.13.3.0

2023-02-15

Only part of ALPHA RELEASE builds: Changed
MapContentSettings.setMapContentType(mapFormatType: MapContentSettings.MapFormatType) method to MapContentSettings.mapContentType : MapContentSettings.MapFormatType property.
This API is available only for internal variant.
Jira-Ticket: IOTSDK-14191.

4.13.3.0

2023-02-15

MapViewBase.pickMapItems() picks MapPolylines with fillColor.alpha = 0
Jira-Ticket: IOTSDK-15665.

4.13.3.0

2023-02-15

Added MapPolygon.visibilityRanges : [MapMeasureRange] property.
Jira-Ticket: IOTSDK-5783.

4.13.3.0

2023-02-15

Only part of ALPHA RELEASE builds: Added violatedVehicleRestrictions : [VehicleRestriction], violatedTransportModes : [String] properties to class SectionNotice
Jira-Ticket: IOTSDK-9247.

4.13.3.0

2023-02-15

Added opacity and renderInternalsEnabled properties to MapMarker3D
Jira-Ticket: IOTSDK-15655.

4.13.3.0

2023-02-15

Bitcode is disabled as it's deprecated. Debug symbols are added as separate dSYM package for device architecture.
Jira-Ticket: IOTSDK-16139.

4.13.2.0

2023-02-08

Pause/resume is called internally when application switches between background and foreground. The suggested calling functions of pause/resume in MapView class are corrected if the user still needs to call them explicitly.
Jira-Ticket: IOTSDK-15269.

4.13.2.0

2023-02-08

Added function
MapView.setWatermarkLocation(anchor: Anchor2D, offset: Point2D)
Added read-only property watermarkSize to MapView class.
Jira-Ticket: IOTSDK-15334.

4.13.2.0

2023-02-08

Deprecated function
MapView.setWatermarkPlacement(_ placement: WatermarkPlacement, bottomMargin: Int32)
Jira-Ticket: IOTSDK-15334.

4.13.2.0

2023-02-08

Deprecated FERRY from ManeuverAction enum. It was never used.
Jira-Ticket: IOTSDK-15885.

4.13.2.0

2023-02-08

Added more error codes to RoutingError to provide detailed reason about routing calculation failure.
Jira-Ticket: IOTSDK-15932.

4.13.2.0

2023-02-08

MapViewBase.pickMapItems() picks MapPolygons with fillColor.alpha = 0
Jira-Ticket: IOTSDK-15664.

4.13.1.0

2023-01-18

Added optional billingTag field in SDKOptions to track platform usage across components.
Jira-Ticket: IOTSDK-15294.

4.13.1.0

2023-01-18

Added MapMarkerCluster.opacity property to set and get opacity of the map marker clusters.
Jira-Ticket: IOTSDK-15662.

4.13.1.0

2023-01-18

Several map style improvements
- Use map data attribute 'National Importance' for priority and visibility settings of POIs. (Explore only)
- Use dedicated traffic incident marker for type 'lane-restriction'.
- Visualize land parcels in Victoria, Australia. (Navigate only)
- Update road shield icon for Turkey & Jamaica.
- Adjust visibility of public transport POIs and subway and tram lines in Japan.
- Improve visibility of intersections and traffic lights in Japan.
Jira-Ticket: [CARTODSG-91, CARTODSG-69, CARTODSG-268, CARTODSG-404, CARTODSG-431, CARTODSG-131](https://saeljira.it.here.com/browse/CARTODSG-91, CARTODSG-69, CARTODSG-268, CARTODSG-404, CARTODSG-431, CARTODSG-131).

4.13.0.0

2022-12-12

Removed deprecated MapCameraObserver protocol, MapCamera.addObserver(_ observer: MapCameraObserver) and MapCamera.removeObserver(_ observer: MapCameraObserver) methods. Use MapCamera.addDelegate(_ delegate: MapCameraDelegate) and MapCamera.removeDelegate(_ delegate: MapCameraDelegate) instead.
Jira-Ticket: IOTSDK-12941.

4.13.0.0

2022-12-12

Removed previously deprecated enum sdk.routing.HazardousGood. Please use sdk.transport.HazardousMaterialinstead.
Removed previously deprecated variable sdk.routing.TruckOptions.hazardousGoods. Please use sdk.routing.TruckOptions.hazardousMaterialsinstead.
Removed previously deprecated variable sdk.routing.EVTruckOptions.hazardousGoods. Please use sdk.routing.EVTruckOptions.hazardousMaterialsinstead.
Jira-Ticket: IOTSDK-12411.

4.13.0.0

2022-12-12

Removed previously deprecated sdk.routing.TruckOptions.tunnelCategory. Please use sdk.routing.TruckOptions.linkTunnelCategoryinstead.
Removed previously deprecated sdk.routing.EVTruckOptions.tunnelCategory. Please use sdk.routing.EVTruckOptions.linkTunnelCategoryinstead.
Jira-Ticket: IOTSDK-12410.

4.13.0.0

2022-12-12

Removed MapCameraUpdateFactory.setPrincipalPointOffset(_ principalPointOffset: Point2D) method.
Jira-Ticket: IOTSDK-12534.

4.13.0.0

2022-12-12

Deprecated methods to manipulate the focal length of the 'MapCamera'. Methods 'setFocalLength()' of class 'MapCameraUpdateFactory' and 'focalLength()' of class 'MapCameraKeyframeTrack'. Modify the field of view to achieve a similar visual change.
Jira-Ticket: IOTSDK-15220.

4.13.0.0

2022-12-12

When all types of gesture actions are disabled using the Gestures.disableDefaultAction(GestureType) method the start of a gesture will no longer cancel ongoing camera animations.
Jira-Ticket: IOTSDK-14924.

4.13.0.0

2022-12-12

Added functionality to set offline mode for HERE SDK, which prevents the HERE SDK from initiating any online connection.
SDKNativeEngine.setOfflineMode method added to enable/disable this functionality.
SDKNativeEngine.getOfflineMode method added to fetch the current state this functionality.
Jira-Ticket: IOTSDK-14980.

4.13.0.0

2022-12-12

Removed deprecated enum entries of MapError: duplicateLayer, invalidDataSource, invalidContent, unknownLayer, unknown.
Jira-Ticket: IOTSDK-12535.

4.13.0.0

2022-12-12

Removed deprecated and unsupported method RasterDataSource.changeConfiguration(_ configFile: String)
Jira-Ticket: IOTSDK-12535.

4.13.0.0

2022-12-12

Removed deprecated MapCamera.cancelAnimation() method.
Jira-Ticket: IOTSDK-12942.

4.13.0.0

2022-12-12

No changes.
Jira-Ticket: IOTSDK-12942.

4.13.0.0

2022-12-12

Removed deprecated methods MapCameraLimits.setMinTilt and MapCameraLimits.setMinTilt, use MapCameraLimits.tiltRange instead. Removed deprecated methods MapCameraLimits.setMinZoomLevel and MapCameraLimits.setMaxZoomLevel, use MapCameraLimits.zoomRange instead. Removed enum 'MapCameraLimits.ErrorCode' and exception MapCameraLimitsException.MapCameraLimitsException which have become obsolete.
Jira-Ticket: IOTSDK-12943.

4.13.0.0

2022-12-12

Added methods MapScene.addMapImageOverlay(_ MapImageOverlay) and MapScene.removeMapImageOverlay(_ MapImageOverlay).
Jira-Ticket: IOTSDK-15206.

4.13.0.0

2022-12-12

Added class MapImageOverlay.
Jira-Ticket: IOTSDK-15206.

4.13.0.0

2022-12-12

Removes previously deprecated variable TruckSpecifications.type. Please use TruckSpecifications.truckType instead.
Jira-Ticket: IOTSDK-12485.

4.13.0.0

2022-12-12

Removed deprecated MapCamera.flyTo() methods and related MapCamera.FlyToOptions. Use one of the MapCameraAnimationFactory.flyTo() methods to create a fly-to camera animation and MapCamera.startAnimation(MapCameraAnimation) to initiate it.
Jira-Ticket: IOTSDK-12944.

4.13.0.0

2022-12-12

Remove deprecated 'sdk.routing.Route.polyline'. Use 'sdk.routing.Route.geometry' instead.
Remove deprecated 'sdk.routing.Section.polyline'. Use 'sdk.routing.Section.geometry' instead.
Jira-Ticket: IOTSDK-15505.

4.13.0.0

2022-12-12

Added collection of MaxSpeedOnSegment instances to all motor-vehicle based route calculation options (BusOptions, CarOptions, EVCarOptions, EVTruckOptions, ScooterOptions, TaxiOptions, and TruckOptions) to enable introducing restriction on base speed for segments which affects route calculation and the ETA.
Jira-Ticket: IOTSDK-15006.

4.13.0.0

2022-12-12

Add segmentHint and onRoadThreshold properties to Waypoint struct to improve waypoint matching
Jira-Ticket: IOTSDK-15005.

4.13.0.0

2022-12-12

Added MapMarker.opacity property to set and get opacity of the map markers.
Jira-Ticket: IOTSDK-7163.

4.13.0.0

2022-12-12

This version of the HERE SDK is delivered with map data version 60.
Jira-Ticket: IOTSDK-15393.

4.13.0.0

2022-12-12

Remove deprecated Location.timestamp_since_boot_in_milliseconds. Use Location.timestamp_since_boot instead.
Jira-Ticket: IOTSDK-15504.

4.13.0.0

2022-12-12

Remove deprecated AuthenticationData.expiry_time_in_seconds. Use AuthenticationData.expiry_time instead.
Jira-Ticket: IOTSDK-15504.

4.12.11.0

2022-11-23

Added property LocationIndicator.isAccuracyVisualized: Bool to allow visualising the accuracy. If isAccuracyVisualized is set to true the field Location.horizontalAccuracyInMeters controls the size of the accuracy indicator halo when calling LocationIndicator.updateLocation(location).
Jira-Ticket: IOTSDK-9118.

4.12.11.0

2022-11-23

This version of the HERE SDK is delivered with map data version 59.
Jira-Ticket: IOTSDK-15239.

4.12.11.0

2022-11-23

Added MapContentSettings.filterTrafficIncidents(trafficIncidents: [TrafficIncidentType]) method to filter the displayed traffic incidents and MapContentSettings.resetTrafficIncidentFilter() method to reset the applied traffic incident filter.
Jira-Ticket: IOTSDK-14742.

4.12.10.0

2022-11-17

Fixed missing AHEAD truck restriction warning not given when the restriction does not start at the beginning of a segment.
Jira-Ticket: IOTSDK-14960.

4.12.10.0

2022-11-17

This version of the HERE SDK is delivered with map data version 57.
Jira-Ticket: IOTSDK-15091.

4.12.9.0

2022-10-26

MapMarkerCluster.ImageStyle changed from class to struct with addition of two properties
<br/> public struct ImageStyle \{<br/> public var image: MapImage<br/> public var anchor: Anchor2D<br/>\}<br/>

Added new struct MapMarkerCluster.CounterStyle to style cluster markers which display a marker count.

Added new constructor to MapMarkerCluster class
<br/>public init(imageStyle: MapMarkerCluster.ImageStyle, counterStyle: MapMarkerCluster.CounterStyle)<br/>

Note: This feature was in BETA state until now and is not anymore.
Jira-Ticket: IOTSDK-14241.

4.12.9.0

2022-10-26

Removed AlphaBlendType enum and the property MapPolyline.alphaBlendType: AlphaBlendType. This was a beta feature.
Jira-Ticket: HARP-19646.

4.12.9.0

2022-10-26

Only part of ALPHA RELEASE builds: Added
MapContentSettings.MapFormatType enum and MapContentSettings.setMapContentType(mapFormatType: MapContentSettings.MapFormatType) method.
This API is available only for internal variant.
Jira-Ticket: IOTSDK-14191.

4.12.9.0

2022-10-26

Added methods
public class MapScene \{<br/> public func addMapPolylines(_ mapPolylines: [MapPolyline]) -> Void<br/> public func removeMapPolylines(_ mapPolylines: [MapPolyline]) -> Void<br/>\}
Jira-Ticket: IOTSDK-12666.

4.12.9.0

2022-10-26

Deprecated altitude of camera's look-at target point.
Jira-Ticket: HARP-19636.

4.12.9.0

2022-10-26

Added enum EngineBaseURL.AUTHENTICATION to provide custom authentication base url
Jira-Ticket: IOTSDK-14819.

4.12.9.0

2022-10-26

Added enum EngineBaseURL.DS_PROXY to provide custom DS Proxy url
Jira-Ticket: IOTSDK-14821.

4.12.9.0

2022-10-26

ADDED new features JUNCTION_VIEW_3X4, JUNCTION_VIEW_16X9, JUNCTION_SIGN_3X4, JUNCTION_SIGN_3X5, JUNCTION_SIGN_4X3, JUNCTION_SIGN_5X3, JUNCTION_SIGN_16X9 in the LayerConfiguration to provide data of junction view, signposts images and assets with aspect ratio.
Jira-Ticket: IOTSDK-14710.

4.12.9.0

2022-10-26

Navigate variant only: Added new class 'PickMapContentResult.VehicleRestrictionResult' and property PickMapContentResult.vehicleRestrictions: List<VehicleRestrictionResult> to add support for picking of vehicle restriction icons from the map. This is a beta release of this feature.
Jira-Ticket: IOTSDK-12288.

4.12.9.0

2022-10-26

Added sdk.transport.VehicleProfile to define the vehicle that is used.
Jira-Ticket: IOTSDK-14327.

4.12.8.0

2022-10-13

Only part of ALPHA RELEASE builds: Added new enum 'VehicleRestrictionCategory', new class 'PickMapContentResult.VehicleRestrictionResult' and property MapContentResult.vehicleRestrictions: List<VehicleRestrictionResult> to add support for picking of vehicle restriction icons from the map.
Jira-Ticket: IOTSDK-12288.

4.12.8.0

2022-10-13

• Added MapPolylineAnimation class to represent an animation that can be applied to a MapPolyline object.
  - Added public func startAnimation(_ animation: MapPolylineAnimation, animationDelegate listener: AnimationDelegate) -> Void to MapPolyline to start an animation.
  - Added public func cancelAnimation(_ animation: MapPolylineAnimation) -> Void to MapPolyline to cancel an animation.
  - Added public static func polylineProgress(keyframes: [ScalarKeyframe], easingFunction: EasingFunction, interpolationMode: KeyframeInterpolationMode) throws -> MapItemKeyFrameTrack to create a keyframe track for the progress property of a 'MapPolyline'.
  Jira-Ticket: HARP-19604.

4.12.7.0

2022-09-28

Added MapPolyline.progressOutlineeColor property to style the outline of the progress part of a polyline.
Jira-Ticket: HARP-18454.

4.12.7.0

2022-09-28

Added MapView.secondaryLanguage property to set and get secondary map language.
Jira-Ticket: HARP-19524.

4.12.7.0

2022-09-28

Upgrade build system Xcode version from 12.4 to version 13.2.1. The new version will be used for release builds.
Jira-Ticket: IOTSDK-14513.

4.12.7.0

2022-09-28

This version of the HERE SDK is delivered with map data version 54.
Jira-Ticket: IOTSDK-14428.

4.12.7.0

2022-09-28

Added struct sdk.core.engine.CatalogConfiguration, which can be used to access default catalogs on the HERE platform, as well as custom catalogs such as for self-hosted or BYOD (bring your own data) use cases.

Added struct sdk.core.engine.DesiredCatalog, which provides an interface to identify a catalog on the HERE platform.
The user can specify the HERE Resource Name (HRN) for the catalog along with a hint for the desired version.

Added class sdk.core.engine.CatalogVersionHint, which provides an interface for specifying the catalog version in the sdk.core.engine.DesiredCatalog.

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.
Jira-Ticket: IOTSDK-14186.

4.12.6.0

2022-09-14

Exposes CategoryQuery.fuelTypes and TextQuery.fuelTypes. Which can be used to filter sdk.search.FuelStation results based on available fuel types.
Exposes TextQuery.truckFuelTypes and CategoryQuery.truckFuelTypes. Which can be used to filter sdk.search.FuelStation results based on available truck fuel types.
Jira-Ticket: IOTSDK-14287.

4.12.6.0

2022-09-14

Exposes CategoryQuery.fuelTypes and TextQuery.fuelTypes.
Which can be used to filter sdk.search.FuelStation results with minimum supported sdk.transport.TruckClass.
This filter is only available to use with the SearchEngine. The OfflineSearchEngine (not available for all editions) does not apply this filter.
Jira-Ticket: IOTSDK-14287.

4.12.6.0

2022-09-14

Added MapFeatureModes.trafficFlowJapanWithoutFreeFlow.
Jira-Ticket: IOTSDK-14172.

4.12.6.0

2022-09-14

Deprecated MapFeatureModes.trafficFlowRegionSpecific, it will be removed in version 4.15.0. Use MapFeatureModes.trafficFlowJapanWithoutFreeFlow instead.
Jira-Ticket: IOTSDK-14172.

4.12.6.0

2022-09-14

Added AlphaBlendType enum and MapPolyline.alphaBlendType: AlphaBlendType property.

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.
Jira-Ticket: HARP-19498.

4.12.6.0

2022-09-14

Added MapPolyline.progress and MapPolyline.progressColor properties to style two parts of a polyline with different colors.
Jira-Ticket: HARP-18454.

4.12.6.0

2022-09-14

Improved appearance of point of interests. Colored text based on category, updated image assets. This was already introduced for the release 4.12.5.0.
Jira-Ticket: HARP-19470.

4.12.6.0

2022-09-14

Deprecated SDKInitializer and related functionality, it will be removed in version 4.15.0. Use SDKNativeEngine.makeSharedInstance instead.
Jira-Ticket: IOTSDK-13844.

4.12.6.0

2022-09-14

Expose new feature OfflineBusRouting in the LayerConfiguration that adds support to OfflineRountingEngine to calculate routes with BusOptions. Attention: Without this feature, bus routes cannot be calculated offline.
Jira-Ticket: IOTSDK-14352.

4.12.6.0

2022-09-14

Optimized the map view representation for hybrid map schemes (improved readability; day & night design unified)
Jira-Ticket: HARP-19471.

4.12.5.0

2022-08-31

Implemented advanced building style transition across zoom levels.
Jira-Ticket: HARP-8049.

4.12.5.0

2022-08-31

Only part of INTERNAL RELEASE builds: Added struct sdk.maploader.CatalogIdentifier. This is used to identify any catalog in the HERE platform.
Contains catalog hrn and version.
Jira-Ticket: IOTSDK-14127.

4.12.5.0

2022-08-31

Added property Details.fuelStation that contains fuel station attributes. Added struct sdk.search.FuelStation,sdk.search.FuelAdditive, sdk.search.GenericFuel, sdk.search.TruckFuel. Currently it is supported only for online search. It can be enabled by adding show=fuel custom option. This is a beta feature and thus subject to change.
Jira-Ticket: IOTSDK-13264.

4.12.5.0

2022-08-31

This version of the HERE SDK is delivered with map data version 53.
Jira-Ticket: IOTSDK-14252.

4.12.5.0

2022-08-31

All map features now have a named default mode. Constants for those were added to MapFeatureModes: buildingFootprintsAll, extrudedBuildingsAll, environmentalZonesAll, trafficIncidentsAll, safetyCamerasAll (Navigate only).
Jira-Ticket: IOTSDK-14172.

4.12.5.0

2022-08-31

Added MapFeatures.congestionZones and MapFeatureModes.congestionZonesAll.
Jira-Ticket: IOTSDK-14302.

4.12.5.0

2022-08-31

Added MapFeatures.environmentalZones and MapFeatureModes.environmentalZonesAll.
Jira-Ticket: IOTSDK-13902.

4.12.5.0

2022-08-31

Improved appearance of buildings by distributing start zoom level of buildings with different importance.
Jira-Ticket: HARP-8049.

4.12.5.0

2022-08-31

Improved appearance of point of interests. Colored text based on category, updated image assets.
Jira-Ticket: HARP-19470.

4.12.4.0

2022-08-17

Added sdk.search.AreaType enum which represents type of area such as country, state, district, etc.
Jira-Ticket: IOTSDK-7592.

4.12.4.0

2022-08-17

Added property sdk.search.Place.areaType which gets the area type for the respective place.
Jira-Ticket: IOTSDK-7592.

4.12.4.0

2022-08-17

Increased size limit from 10000 to 50000 for routingEngine.importRoute() when setting a list of Location points.
Jira-Ticket: IOTSDK-14102.

4.12.4.0

2022-08-17

Added EVChargingStation.hasFixedCable field.
Jira-Ticket: IOTSDK-14196.

4.12.4.0

2022-08-17

Fixed missing tolls information that happens when bus or taxi routing is used.
Jira-Ticket: IOTSDK-12676.

4.12.4.0

2022-08-17

The enableEnterHighwayManeuverAction boolean flag in RouteOptions is introduced to accommodate a smooth transition on handling the new ENTER_HIGHWAY_FROM_LEFT and ENTER_HIGHWAY_FROM_RIGHT values in ManeuverAction enum. These new values are currently generated only if the mentioned boolean flag in RouteOptions is set to true. However, this will be the default behavior in the next release (4.14.0).
Jira-Ticket: IOTSDK-13199.

4.12.4.0

2022-08-17

A new boolean flag of enableEnterHighwayManeuverAction is introduced in RouteOptions. This flag is used temporarily to accommodate the generation of two new values of ENTER_HIGHWAY_FROM_LEFT and ENTER_HIGHWAY_FROM_RIGHT from ManeuverAction enum, if set true. Such behavior will no longer require the setting of this boolean flag in the next release version 4.14.0.
Jira-Ticket: IOTSDK-13199.

4.12.4.0

2022-08-17

Improved time to create Route from online router with very large routes.
Jira-Ticket: IOTSDK-13756.

4.12.4.0

2022-08-17

Only applies to HERE SDK Navigate with map data version greater than 47: Fixed high number of mountain peak labels on the map of USA, improving performance and map readability. Cached/persistent map need to be upgraded to version 48 or greater.
Jira-Ticket: IOTSDK-13855.

4.12.3.0

2022-08-03

Corrected the range of SearchOptions.max_items. It should be in the range [1, 100]. When not set, results will be limited to 20.
OfflineSearchEngine autosuggest max items will be limited to 20 by default (previously it was 5).
Jira-Ticket: IOTSDK-13617.

4.12.3.0

2022-08-03

MapMarkerCluster.ImageStyle changed from class to struct with addition of two properties
<br/> public struct ImageStyle \{<br/> public var image: MapImage<br/> public var anchor: Anchor2D<br/>\}<br/>

Added new struct MapMarkerCluster.CounterStyle to style cluster markers which display a marker count

Added new constructor to MapMarkerCluster class
<br/>public init(imageStyle: MapMarkerCluster.ImageStyle, counterStyle: MapMarkerCluster.CounterStyle)<br/>

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.
Jira-Ticket: IOTSDK-10207.

4.12.3.0

2022-08-03

Added sdk.search.TruckAmenities struct. Currently it is supported only for online search. It can be enabled by adding show=truck custom option.
Jira-Ticket: IOTSDK-13263.

4.12.3.0

2022-08-03

Deprecated TextQuery.includeChains and TextQuery.excludeChains. Please use CategoryQuery.includeChains and CategoryQuery.excludeChains instead.
Jira-Ticket: IOTSDK-14080.

4.12.3.0

2022-08-03

Added CategoryQuery.includeChains and CategoryQuery.excludeChains that support search filtering by chains.
Jira-Ticket: IOTSDK-14080.

4.12.3.0

2022-08-03

MapFeatureModes.trafficFlowRegionSpecific now only works with Japan-enabled map. For rest of the world map, please use MapFeatureModes.trafficFlowWithFreeFlow instead.
Jira-Ticket: IOTSDK-13903.

4.12.3.0

2022-08-03

Updated to harp 0.70.0
Jira-Ticket: IOTSDK-13989.

4.12.3.0

2022-08-03

When MapView is placed inside a UIScrollView (directly or indirectly), it will block the scrolling if the user interacts with the map allowing map gestures to work. If the touch gesture is fast enough (like a swipe, for example), UIScrollView will work as normal, intercept touches and prevent MapView gestures from working.
Jira-Ticket: IOTSDK-13775.

4.12.2.0

2022-07-20

Integration of HARP 0.69
Jira-Ticket: IOTSDK-13876.

4.12.1.0

2022-07-08

Added capability to enable/disable map features, query supported
map features and check currently active map features.

Added following methods to MapScene:
func getActiveFeatures() -> [String: String]
func getSupportedFeatures() -> [String: [String]]
func enableFeatures(_ features: [String: String]) -> Void
func disableFeatures(_ features: [String]) -> Void

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.
Jira-Ticket: IOTSDK-13580.

4.12.1.0

2022-07-08

Added PostAction.chargingDetails, which supports additional parameters for EV charging.
Jira-Ticket: IOTSDK-13551.

4.12.1.0

2022-07-08

Added TextQuery.includeChains and TextQuery.excludeChains that support search filtering by chains.
Jira-Ticket: IOTSDK-13719.

4.12.1.0

2022-07-08

Added MapFeatures class which contains constants for map features. Added MapFeatureModes which contains constants for map feature modes.
Jira-Ticket: IOTSDK-13581.

4.12.1.0

2022-07-08

Added support for the new web-based unified HERE Style Editor that is available on the HERE platform. Custom map styles that have been made with the legacy desktop editor need to be migrated to the new HERE Style Editor format. Get in touch with your HERE representative to convert your existing styles. The HERE Style Editor is available via self-serve:

- Sign-Up for an account on HERE Platform (https://platform.here.com/sign-up).
- Confirm and finalize account generation by providing addition details.
- Select HERE Style Editor from the Launcher Menu on your landing page at Platform or use direct link after sign in (https://platform.here.com/style-editor/).
- Start utilizing HERE Style Editor by selecting a base style you want to customize.
- Apply your customizations to the map style.
- Finalize your work by exporting the customized map style to your local PC (File -> Export Map Style) and load it to your application.
Jira-Ticket: IOTSDK-1000.

4.12.1.0

2022-07-08

Added SDKNativeEngine.makeSharedInstance method to safely initialize shared instance of SDKNativeEngine and gracefully destroy previoius instance if exists.
Jira-Ticket: IOTSDK-12047.

4.12.1.0

2022-07-08

Speed up processing of online routing responses
Jira-Ticket: IOTSDK-13756.

4.12.1.0

2022-07-08

Deprecated all constants defined in MapScene.Layers. Instead of using those constants with MapScene.setLayerVisibility(), one is to use MapScene.enableFeatures() and MapScene.disableFeatures() with the constants from MapFeatures and MapFeatureModes. Note that unlike layer visibility state, map feature state is reset on loadScene().
Jira-Ticket: IOTSDK-13668.

4.12.1.0

2022-07-08

Only applies to HERE SDK Navigate with map data version 47: High number of mountain peak labels are present on the map of USA, resulting in overwhelming number of labels being shown on the map, which reduces performance and map readability.
Jira-Ticket: IOTSDK-13855.

4.12.0.0

2022-07-06

Analytic now records usage when functinality related to search, mapview, routing, maploader is used. Creation of SDKNativeEngine doesn't trigger record of usage. If usage was recorded and credentials are changed then usage is performed again.
Jira-Ticket: IOTSDK-12843.

4.12.0.0

2022-07-06

Integrates HARP 0.66
Jira-Ticket: IOTSDK-13477.

4.12.0.0

2022-07-06

Added ACCOMMODATION, ACCOMMODATION_HOTEL_MOTEL and ACCOMMODATION_LODGING constants in PlaceCategory.
Jira-Ticket: IOTSDK-13360.

4.12.0.0

2022-07-06

Deprecated ACCOMODATION, ACCOMODATION_HOTEL_MOTEL and ACCOMODATION_LODGING constants in PlaceCategory. ACCOMMODATION, ACCOMMODATION_HOTEL_MOTEL and ACCOMMODATION_LODGING should be used instead.
Jira-Ticket: IOTSDK-13360.

4.12.0.0

2022-07-06

Remove deprecated MapScene.setLayerState(layerName: String, newState: MapScene.LayerState). Use MapScene.setLayerVisibility(...﹚ instead.
Remove deprecated enum MapScene.LayerState, use VisibilityState instead.
Jira-Ticket: IOTSDK-11528.

4.12.0.0

2022-07-06

Integrated harp version 0.67.0
Jira-Ticket: IOTSDK-13613.

4.12.0.0

2022-07-06

This version of the HERE SDK is delivered with map data version 45.
Jira-Ticket: IOTSDK-13621.

4.12.0.0

2022-07-06

Improved normal night map scheme for better readability. Increased brightness, saturation and contrast and reduced the number of different color tones.
Jira-Ticket: HARP-16820.

4.12.0.0

2022-07-06

A new web-based unified HERE Style Editor will be made available on the HERE platform, together with the release of HERE SDK 4.12.1.0. It is compatible with the JSAPI and the HERE SDK. Custom map styles that have been made with the legacy desktop editor need to be migrated to the new HERE Style Editor format. Get in touch with your HERE representative to discuss potential style updates until then. HERE SDK 4.12.0.0 is the last release that supports the old desktop format.
Jira-Ticket: IOTSDK-1000.

4.11.4.0

2022-06-09

Added trafficIncidentIndexes to Span. The indexes are related to the traffic incidents in the parent Section.
Jira-Ticket: IOTSDK-13098.

4.11.4.0

2022-06-09

waypointIndex of the first departure place and last arrival place of online routes are now set according to the waypoints indices
Jira-Ticket: IOTSDK-13187.

4.11.4.0

2022-06-09

Use pixel scale in renderer as reference for zooming map content. When the default camera settings are used this results in the map being more zoomed in than previously.
Jira-Ticket: IOTSDK-13117.

4.11.4.0

2022-06-09

Added setGeoCoordinates and getGeoCoordinates to Metadata.
Jira-Ticket: APIGEN-1520.

4.11.4.0

2022-06-09

Added availableConnectorCount to EVChargingStation. It represents the number of available physical connectors at the charging station.
Jira-Ticket: IOTSDK-13446.

4.11.4.0

2022-06-09

Integrated HARP Native version 0.65.0
Jira-Ticket: IOTSDK-13373.

4.11.4.0

2022-06-09

Changed type of PickMapContentResult.TrafficIncidentResult.originalId property to String
Jira-Ticket: IOTSDK-13383.

4.11.3.0

2022-05-17

Deprecated 'MapCamera.lookAt(point: GeoCoordinates, distanceInMeters: Double)' and 'MapCamera.lookAt(point: GeoCoordinates, orientation: GeoOrientationUpdate, distanceInMeters: Double)'
Jira-Ticket: IOTSDK-10913.

4.11.3.0

2022-05-17

Added 'MapCamera.lookAt(point: GeoCoordinates, zoom: MapMeasure)' and 'MapCamera.lookAt(point: GeoCoordinates, orientation: GeoOrientationUpdate, zoom: MapMeasure)'
Jira-Ticket: IOTSDK-10913.

4.11.3.0

2022-05-17

Added class PickMapContentResult.TrafficIncidentResult containing all data of a picked traffic incident. Added PickMapContentResult.trafficIncidents property for retrieving picked traffic incidents.
Jira-Ticket: IOTSDK-12427.

4.11.3.0

2022-05-17

Updates the SDK to harp version 0.63.0
Jira-Ticket: IOTSDK-13118.

4.11.3.0

2022-05-17

Integrated HARP Native version 0.64.0
Jira-Ticket: IOTSDK-13247.

4.11.3.0

2022-05-17

This version of the HERE SDK is delivered with map data version 41.
Jira-Ticket: IOTSDK-13213.

4.11.2.0

2022-04-28

Deprecated MapViewBase.pickMapFeatures(in: Rectangle2D, completion: @escaping (PickMapFeaturesResult?) -> Void), MapView.pickMapFeatures(in: Rectangle2D, completion: @escaping (PickMapFeaturesResult?) -> Void), PickMapFeaturesResult.
Jira-Ticket: IOTSDK-12981.

4.11.2.0

2022-04-28

Added MapViewBase.pickMapContent(in: Rectangle2D, completion: @escaping (PickMapContentResult?) -> Void), MapView.pickMapContent(in: Rectangle2D, completion: @escaping (PickMapContentResult?) -> Void), PickMapContentResult.
Jira-Ticket: IOTSDK-12981.

4.11.2.0

2022-04-28

Added RoutePrefetcher.prefetchAroundLocation api. Prefetches map data within a circle of radius 10km of around a location.
It is recommended to call this method once before starting navigation for a smooth experience.
Jira-Ticket: IOTSDK-12424.

4.11.2.0

2022-04-28

Deprecated Section.departureTime and Section.arrivalTime properties. Use Section.departureLocationTime and Section.arrivalLocationTime properties instead. Added LocationTime struct which which provides the local time, UTC time and the UTC offset.
Jira-Ticket: IOTSDK-12926.

4.11.2.0

2022-04-28

Deprecated existing constructors of sdk.search.TextQuery and sdk.search.CategoryQuery.
Use newly added constructors taking sdk.search.TextQuery.Area and sdk.search.CategoryQuery.Area instead.
Jira-Ticket: IOTSDK-13013.

4.11.2.0

2022-04-28

Fixed value stored in the sectionTransportMode property of the sdk.routing.Section for bus routes
Jira-Ticket: IOTSDK-13104.

4.11.2.0

2022-04-28

Added method RoutingEngine.setCustomOptions which allows adding custom options to each routing query.
Jira-Ticket: IOTSDK-13168.

4.11.2.0

2022-04-28

Fixed failing requests for TrafficEngine.
Jira-Ticket: IOTSDK-13245.

4.11.1.0

2022-04-08

'MapImage(imageData: Data, imageFormat: ImageFormat, width: UInt32, height: UInt32)' will also accept png image data.
Jira-Ticket: IOTSDK-13016.

4.11.1.0

2022-04-08

Traffic incidents search can be applied to corridor of arbitrary length.
Jira-Ticket: IOTSDK-12801.

4.11.1.0

2022-04-08

Added function to set watermark margin without limitation regardless
of its placement
MapView.setWatermarkPlacement(_ placement: WatermarkPlacement, bottomMargin: Int32)
Jira-Ticket: IOTSDK-12703.

4.11.1.0

2022-04-08

Deprecated function
MapView.setWatermarkPosition(placement: WatermarkPlacement, bottomCenterMargin: UInt32)
Jira-Ticket: IOTSDK-12703.

4.11.1.0

2022-04-08

Dark background removed from map view with webMercator projection.
Jira-Ticket: IOTSDK-12971.

4.11.1.0

2022-04-08

Added Suggestion.id that holds auto suggest item id.
Jira-Ticket: IOTSDK-13014.

4.11.1.0

2022-04-08

Integrated HARP 0.62
Jira-Ticket: IOTSDK-13017.

4.11.1.0

2022-04-08

Removed the previously deprecated
field Location.timestamp.
Jira-Ticket: IOTSDK-12988.

4.10.4.0

2022-04-05

Deprecated sdk.routing.HazardousGood enum. Use 'sdk.transport.HazardousMaterial' instead.
Jira-Ticket: IOTSDK-11015.

4.10.4.0

2022-04-05

Added sdk.transport.HazardousMaterial enum. It is meant to replace deprecated sdk.routing.HazardousGood.
Jira-Ticket: IOTSDK-11015.

4.10.4.0

2022-04-05

Deprecated EVTruckOptions.hazardous_goods. Use EVTruckOptions.hazardous_materials instead.
Jira-Ticket: IOTSDK-11015.

4.10.4.0

2022-04-05

Deprecated TruckOptions.hazardous_goods enum. Use 'TruckOptions.hazardous_materials' instead.
Jira-Ticket: IOTSDK-11015.

4.10.4.0

2022-04-05

Traffic incident queries can be canceled by calling cancel method of the here.sdk.core.threading.TaskHandle object they return
Jira-Ticket: IOTSDK-12489.

4.10.4.0

2022-04-05

HARP was updated to version 0.59
Jira-Ticket: IOTSDK-12610.

4.10.3.0

2022-04-05

Added MapIdleDelegate protocol. Added void HereMap.addMapIdledelegate(MapIdleDelegate) and void HereMap.removeMapIdleListener(MapIdleDelegate)
Jira-Ticket: IOTSDK-11221.

4.10.3.0

2022-04-05

Deprecated unsupported method RasterDataSource.changeConfiguration(_ configFile: String)
Jira-Ticket: HARP-18139.

4.10.3.0

2022-04-05

Updated HARP to v0.57
Jira-Ticket: IOTSDK-12272.

4.10.3.0

2022-04-05

Deprecated TransitDeparture.durationInSeconds. Use TransitDeparture.duration instead.
- Deprecated TransitDeparture constructor with parameters. Use the default constructor instead.
Jira-Ticket: IOTSDK-10084.

4.10.3.0

2022-04-05

Deprecated Maneuver.durationInSeconds. Use Maneuver.duration instead.
- Deprecated Section.durationInSeconds. Use Section.duration instead.
- Deprecated Section.trafficDelayInSeconds. Use Section.trafficDelay instead.
Jira-Ticket: IOTSDK-10084.