Changelog

Version

Date

Change

Description

4.25.5.0

2026-04-14

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

4.25.5.0

2026-04-14

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

4.25.5.0

2026-04-14

Map view: Renamed MapContext.setMemoryManagementOptions(MemoryManagementOptions, SetVideoMemoryLimitCompletionHandler) and the completion handler MapContext.SetVideoMemoryLimitCompletionHandler(Int32). Use MapContext.setMemoryManagementOptions(MemoryManagementOptions, SetMemoryManagementOptionsCompletionHandler) and the completion handler MapContext.SetMemoryManagementOptionsCompletionHandler(MemoryManagementResult) instead. Added the new enum MapContext.MemoryManagementResultCode and the new struct MapContext.MemoryManagementResult. Note that this feature is released as beta and may contain bugs or unexpected behavior. Related APIs may change in future releases without a deprecation process.

4.25.5.0

2026-04-14

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

4.25.5.0

2026-04-14

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

4.25.5.0

2026-04-14

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

4.25.5.0

2026-04-14

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

4.25.5.0

2026-04-14

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

4.25.5.0

2026-04-14

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

4.25.5.0

2026-04-14

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

4.25.5.0

2026-04-14

Deprecated the TransportProfile class. Use TransportSpecification instead.

4.25.4.0

2026-03-10

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

4.25.4.0

2026-03-10

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

4.25.4.0

2026-03-10

Routing: Deprecated IsolineOptions constructor with CarOptions parameter. Use the IsolineOptions constructor with RoutingOptions parameter instead. Deprecated IsolineOptions constructor with TruckOptions parameter. Use the IsolineOptions constructor with RoutingOptions parameter instead. Deprecated IsolineOptions constructor with EVCarOptions parameter. Use the IsolineOptions constructor with RoutingOptions parameter instead. Deprecated IsolineOptions constructor with EVTruckOptions parameter. Use the IsolineOptions constructor with RoutingOptions parameter instead. Deprecated IsolineOptions.carOptions. Use the IsolineOptions.routingOptions instead. Deprecated IsolineOptions.truckOptions. Use the IsolineOptions.routingOptions instead. Deprecated IsolineOptions.evCarOptions. Use the IsolineOptions.routingOptions instead. Deprecated IsolineOptions.evTruckOptions. Use the IsolineOptions.routingOptions instead.

4.25.4.0

2026-03-10

Map view: Improved the default map feature mode for road exit labels: The MapFeatures.roadExitLabels default enabled mode changed from roadExitLabelsNumbersOnly to MapFeatureModes.roadExitLabelsAll mode for MapScheme.logisticsDay, MapScheme.logisticsNight, MapScheme.logisticsHybridDay, MapScheme.logisticsHybridNight map schemes. For other map schemes, roadExitLabelsNumbersOnly will stay as the default feature mode. An overview of the new default map features and map feature modes per map scheme can be seen in the HERE Style Editor documentation.

4.25.4.0

2026-03-10

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

4.25.4.0

2026-03-10

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

4.25.4.0

2026-03-10

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

4.25.3.0

2026-02-19

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

4.25.3.0

2026-02-19

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

4.25.3.0

2026-02-19

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

4.25.2.0

2026-02-06

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

4.25.2.0

2026-02-06

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

4.25.2.0

2026-02-06

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

4.25.2.0

2026-02-06

Routing: Deprecated RoutingEngine.importRoute(...) methods that accept profile-specific option types (CarOptions, PedestrianOptions, BicycleOptions, ScooterOptions, TruckOptions, TaxiOptions, BusOptions, PrivateBusOptions, EVCarOptions, EVTruckOptions, RefreshRouteOptions). Use the RoutingEngine.importRoute(...) methods with RoutingOptions instead. Note: The suggested methods are still marked as beta, but the APIs are already considered stable, and we plan to move them out of beta in the next release.

4.25.2.0

2026-02-06

Routing: Deprecated RoutingInterface.calculateRoute(...) methods that accept profile-specific option types (CarOptions, PedestrianOptions, TruckOptions, ScooterOptions, BicycleOptions, TaxiOptions, EVCarOptions, EVTruckOptions, BusOptions, PrivateBusOptions). Use the RoutingInterface.calculateRoute(...) method with RoutingOptions instead. Note: The suggested methods are still marked as beta, but the APIs are already considered stable, and we plan to move them out of beta in the next release.

4.25.2.0

2026-02-06

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

4.25.1.0

2026-01-20

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

4.25.1.0

2026-01-20

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

4.25.1.0

2026-01-20

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

4.25.1.0

2026-01-20

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

4.25.1.0

2026-01-20

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

4.25.1.0

2026-01-20

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

4.25.1.0

2026-01-20

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

4.25.1.0

2026-01-20

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

4.25.1.0

2026-01-20

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

4.25.1.0

2026-01-20

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

4.25.1.0

2026-01-20

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

4.25.1.0

2026-01-20

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

4.25.1.0

2026-01-20

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

4.25.1.0

2026-01-20

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

4.25.1.0

2026-01-20

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

4.25.0.0

2025-12-19

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

4.25.0.0

2025-12-19

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

4.25.0.0

2025-12-19

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

4.25.0.0

2025-12-19

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

4.25.0.0

2025-12-19

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

4.25.0.0

2025-12-19

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

4.25.0.0

2025-12-19

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

4.25.0.0

2025-12-19

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

4.24.5.0

2025-11-27

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

4.24.4.0

2025-11-12

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

4.24.4.0

2025-11-12

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

4.24.4.0

2025-11-12

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

4.24.3.0

2025-11-03

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

4.24.3.0

2025-11-03

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

4.24.3.0

2025-11-03

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

4.24.3.0

2025-11-03

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

4.24.2.0

2025-10-13

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

4.24.1.0

2025-10-01

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

4.24.1.0

2025-10-01

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

4.24.1.0

2025-10-01

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

4.24.1.0

2025-10-01

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

4.24.1.0

2025-10-01

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

4.24.1.0

2025-10-01

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

4.24.1.0

2025-10-01

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

4.24.0.0

2025-09-17

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

4.24.0.0

2025-09-17

Routing: Removed evDetails from Route. Use consumptionInKilowattHours instead.

4.24.0.0

2025-09-17

Routing: Removed evDetails from Section. Use consumptionInKilowattHours instead.

4.24.0.0

2025-09-17

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

4.24.0.0

2025-09-17

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

4.24.0.0

2025-09-17

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

4.23.5.0

2025-09-03

No new features for this release of the HERE SDK for iOS (Explore).

4.23.4.0

2025-08-21

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

4.23.4.0

2025-08-21

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

4.23.4.0

2025-08-21

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

4.23.3.0

2025-08-05

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

4.23.3.0

2025-08-05

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

4.23.3.0

2025-08-05

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

4.23.3.0

2025-08-05

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

4.23.2.0

2025-07-23

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

4.23.2.0

2025-07-23

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

4.23.2.0

2025-07-23

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

4.23.1.0

2025-07-15

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

4.23.1.0

2025-07-15

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

4.23.1.0

2025-07-15

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

4.23.1.0

2025-07-15

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

4.23.1.0

2025-07-15

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

4.23.1.0

2025-07-15

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

4.23.1.0

2025-07-15

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

4.23.1.0

2025-07-15

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

4.23.0.0

2025-07-08

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

4.23.0.0

2025-07-08

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

4.23.0.0

2025-07-08

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

4.23.0.0

2025-07-08

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

4.23.0.0

2025-07-08

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

4.23.0.0

2025-07-08

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

4.23.0.0

2025-07-08

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

4.23.0.0

2025-07-08

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

4.23.0.0

2025-07-08

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

4.23.0.0

2025-07-08

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

4.23.0.0

2025-07-08

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

4.23.0.0

2025-07-08

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

4.23.0.0

2025-07-08

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

4.23.0.0

2025-07-08

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

4.22.5.0

2025-06-10

No new features for this release of the Explore Edition.

4.22.4.0

2025-05-28

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

4.22.3.0

2025-05-13

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

4.22.3.0

2025-05-13

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

4.22.3.0

2025-05-13

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

4.22.3.0

2025-05-13

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

4.22.3.0

2025-05-13

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

4.22.2.0

2025-04-30

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

4.22.2.0

2025-04-30

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

4.22.2.0

2025-04-30

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

4.22.2.0

2025-04-30

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

4.22.2.0

2025-04-30

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

4.22.1.0

2025-04-16

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

4.22.1.0

2025-04-16

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

4.22.1.0

2025-04-16

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

4.22.1.0

2025-04-16

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

4.22.0.0

2025-04-03

Added AssetsManager to register custom and fallback fonts. Once registered, the font name can be used in the SVG text tag as the font-family attribute when creating a MapImage with ImageFormat.SVG.

4.22.0.0

2025-04-03

Search: The beta property POIPaymentDetails.acceptedCashCurrencies is now optional. If cash is not an accepted payment method, or if the list of accepted currencies is unavailable, this property will be set to nil.

4.22.0.0

2025-04-03

Routing: Removed the previously deprecated AvoidanceOptions property avoidBoundingBoxAreas. Use avoidBoundingBoxAreasOptions instead. Removed the previously deprecated avoidPolygonAreas. Use avoidPolygonAreasOptions instead.

4.22.0.0

2025-04-03

Map view: Added gradient support for MapPolyline with progress to customize route-eat-up during turn-by-turn navigation. The transition between MapPolyline.lineColor and MapPolyline.progressColor can now be rendered gradually. The length of this transition can be set and retrieved using MapPolyline.progressGradientLength, specified in zoom-level-dependent pixels.

4.22.0.0

2025-04-03

Search: Deprecated WebImage.publicationDate. Date information is no longer available for images.

4.22.0.0

2025-04-03

Removed the previously deprecated property SDKOptions.customEngineBaseUrls. Use SDKOptions.customEngineOptions instead.

4.22.0.0

2025-04-03

Routing: Removed the previously deprecated TrafficSpeed class. Use DynamicSpeedInfo instead.

4.22.0.0

2025-04-03

Map view: Removed the previously deprecated constructor for MapLayerMapMeasureDependentStorageLevels. Use MapLayerMapMeasureDependentStorageLevels.withStorageLevelOffset() method to create MapLayerMapMeasureDependentStorageLevels instances instead.

4.22.0.0

2025-04-03

Map view: Removed the previously deprecated MapViewBase.PickMapItemsHandler and MapViewBase.PickMapContentHandler. Use pick() instead.

4.22.0.0

2025-04-03

Routing: Fixed a bug that caused missing consumption values in TrafficOnSpan for EV routes.

4.22.0.0

2025-04-03

Search: Filters in PlaceFilter.EV are now available to all customers, not just members of the closed alpha group. Note that this feature is also supported by the OfflineSearchEngine, if available for your edition.

4.22.0.0

2025-04-03

Map view: Removed the previously deprecated MapScene.setPoiVisibility API. Use MapContentSettings.setPoiCategoriesVisibility and MapContentSettings.resetPoiCategoriesVisibility instead.

4.21.5.0

2025-03-17

Search: Added enum values SearchError.queryEmpty, SearchError.invalidArea, SearchError.filterEmpty, SearchError.invalidCorridorPolyline, SearchError.invalidUrl, SearchError.invalidCustomOptionFormat, SearchError.invalidTruckClass, SearchError.badRequest. These features are also supported for the OfflineSearchEngine, if available for your edition.

4.21.5.0

2025-03-17

Search: Deprecated enum value SearchError.invalidParameter. Use the other dedicated errors instead.

4.21.5.0

2025-03-17

Added a NameID data type to represent name-id pairs.

4.21.5.0

2025-03-17

Routing: Added the following properties to ChargingStation: brand to include the brand name and ID of a charging station, chargePointOperator to include the name and ID of the charging point operator, and matchingEMobilityServiceProviders to list the matched E-Mobility service providers.

4.21.5.0

2025-03-17

Added SDKNativeEngine.getDeviceId(...) to get the unique identifier assigned to the device for an application. This device ID is primarily used for tracking Monthly Active Users (MAUs). If a device has a different device ID within the same month, it is counted as a separate MAU. However, if the device ID changes across different months, it still contributes to the same overall MAU count. Note that MAUs are only counted depending on your contract.

4.21.5.0

2025-03-17

Routing: Added support for all categories of AvoidanceOptions.zoneCategory and AvoidanceOptions.zoneIds. These features are also supported for the OfflineRoutingEngine, if available for your edition.

4.21.5.0

2025-03-17

Search: Extended search details: Added WebImage.publicationDate that contains the photo publication date. It is meant to replace WebImage.date. These features are also supported for the OfflineSearchEngine, if available for your edition.

4.21.5.0

2025-03-17

Search: Deprecated WebImage.date. Please use WebImage.publicationDate instead.

4.21.5.0

2025-03-17

Routing: Fixed route calculation requests by ensuring departure or arrival time is included even when traffic is disabled. These times can still influence the route, as road accessibility may vary depending on the time of day.

4.21.4.0

2025-05-13

Map view: After losing internet connection and then reconnecting, some roads on the map now render correctly and no parts of the map will appear incomplete.

4.21.4.0

2025-05-13

If an application runs in a memory-constrained environment, enable SDKOptions.lowMemoryMode to reduce the HERE SDK's memory footprint. When set to true this configures the internal memory caches to consume less memory. Note that enabling the low memory mode may also reduce the performance of the HERE SDK.

4.21.4.0

2025-05-13

When the application detects increased memory pressure, you can call the SDKNativeEngine.purgeMemoryCaches(...) method to clear the HERE SDK's in-memory caches and reduce its memory footprint. Note that calling this method may temporarily impact performance. Currently, only PurgeMemoryStrategy.full is supported, which clears all cached content without preserving any data.

4.21.3.0

2025-02-18

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

4.21.3.0

2025-02-18

Routing: Removed the beta label from taxi related methods, fields and enum items. The following APIs are now considered to be stable: routingEngine.calculateTaxiRoute(...), routingEngine.importTaxiRoute(...) routingEngine.importTaxiRouteWithStops(...), SectionTransportMode.taxi, TaxiOptions and taxiOptions.allowDriveThroughTaxiRoads.

4.21.3.0

2025-02-18

Map view: Removed parameterless custom scale style expression ["pixel-world-scale"]. Use instead ["pixel-world-scale", <number_expression>]. Note that this is still a beta API.

4.21.3.0

2025-02-18

Deprecated BusSpecifications.lastCharacterOfLicensePlate. Use instead BusOptions.lastCharacterOfLicensePlate.

4.21.3.0

2025-02-18

Routing: Added attribute lastCharacterOfLicensePlate to the following transport mode options: CarOptions, EVCarOptions, BusOptions, PrivateBusOptions, TruckOptions, EVTruckOptions, ScooterOptions and TaxiOptions.

4.21.3.0

2025-02-18

Map view: After losing internet connection and then reconnecting, some roads on the map may fail to render correctly, causing parts of the map to appear incomplete.

4.21.2.0

2025-02-03

Map view: Added MapView.reinit() method to reinitialize a MapView when it was disposed due to the destruction of the shared SDKNativeEngine, for example, when new SDKOptions are needed at runtime.

4.21.2.0

2025-02-03

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

4.21.2.0

2025-02-03

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

4.21.2.0

2025-02-03

Introduced the PolylineSimplifier component to reduce the complexity of long GeoPolyline objects. This helps minimize their size and decrease rendering effort, improving performance.

4.21.2.0

2025-02-03

Map view: Added TileGeoBoundsCalculator API that allows users to compute the geodetic bounds of tiles for supported TilingScheme. Note that this is a beta release of this feature.

4.21.2.0

2025-02-03

Routing: Fixed a bug where EV car routes would never use High-Occupancy Vehicle (HOV) lanes, even when permitted.

4.21.2.0

2025-02-03

Routing: Removed the beta label from PaymentMethod enum. It is now considered to be stable.

4.21.2.0

2025-02-03

Routing: Removed the beta label from fromDefaultParameterConfiguration() and walkSpeedInMetersPerSecond field of PedestrianOptions. They are now considered to be stable.

4.21.2.0

2025-02-03

Routing: Removed the beta label from RouteHandle class. It is now considered to be stable.

4.21.2.0

2025-02-03

Routing: Removed the beta label from TrafficOnSpan, TrafficOnSection, and TrafficOnRoute structs. They are now considered to be stable.

4.21.2.0

2025-02-03

Routing: Removed the beta label from fromDefaultParameterConfiguration() method of TransitRouteOptions. It is now considered to be stable.

4.21.2.0

2025-02-03

Routing: Removed the beta label from optimizeWaypointsOrder field of RouteOptions. It is now considered to be stable.

4.21.2.0

2025-02-03

Routing: Removed the beta label from returnToRoute() method of RoutingInterface. It is now considered to be stable.

4.21.2.0

2025-02-03

Map view: After losing internet connection and then reconnecting, some roads on the map may fail to render correctly, causing parts of the map to appear incomplete.

4.21.1.0

2025-01-22

The global offline switch sdkNativeEngine.isOfflineMode() does now load map tiles after enabling the online mode again or after restoring a lost network connection.

4.21.1.0

2025-01-22

Traffic: TrafficEngine: Polylines for traffic flow and incidents are now always provided as expected. Note that this issue occurred only in South Korea.

4.21.1.0

2025-01-22

Routing: Added ViolatedRestriction.Details.maxWeight. Added VehicleRestrictionMaxWeight to store the max permitted weight along with the weight restrictions type.

4.21.1.0

2025-01-22

Routing: Deprecated maxGrossWeightInKilograms. Use instead maxWeight.

4.21.1.0

2025-01-22

Routing: Deprecated the attributes Section.evDetails and Route.evDetails. Use Section.consumptionInKilowattHours and Route.consumptionInKilowattHours instead.

4.21.1.0

2025-01-22

Map style update: Added a dedicated set of truck restriction icons to support all hybrid MapScheme styles.

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.

4.21.1.0

2025-01-22

Traffic: 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 a polyline on the map. A new additionalPolylines field has been introduced to store all GeoPolyline objects after the first gap between links.

4.21.1.0

2025-01-22

Routing: Added section.noThroughRestriction which indicates an area allowed to enter only for residents or when vehicles make a stop. Added the related span.noThroughRestriction property.

4.21.1.0

2025-01-22

Routing: The RoutingEngine has been improved to use the brotli encoding when initiating requests to reduce the size of responses.

4.21.1.0

2025-01-22

Search: Fixed an issue related to EV charging stations for SearchEngine.searchByPickedPlace() and `SearchEngine.searchPickedPlace().

4.21.1.0

2025-01-22

Added EngineBaseURL.isolineRoutingEngine enum value to allow to provide a custom URL for use with the IsolineRoutingEngine.

4.21.1.0

2025-01-22

Map view: Added enum value MapMeasure.Kind.distanceInMeters to highlight the unit. This replaces the deprecated MapMeasure.Kind.DISTANCE.

4.21.1.0

2025-01-22

Map view: Deprecated enum value MapMeasure.Kind.distance. Use MapMeasure.Kind.distanceInMeters instead.

4.21.1.0

2025-01-22

Map view: After losing internet connection and then reconnecting, some roads on the map may fail to render correctly, causing parts of the map to appear incomplete.

4.21.0.0

2024-12-18

Search: Added attribute id to EVChargingPool, which represents a 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.

4.21.0.0

2024-12-18

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

4.21.0.0

2024-12-18

Map view: Fixed an issue with the pinch-rotate gesture where unintended map translation occurred during rotation in certain scenarios, ensuring consistent behavior.

4.21.0.0

2024-12-18

Routing: Fixed a potential ANR that could occur when destroying the RoutingEngine while tasks were still pending.

4.21.0.0

2024-12-18

Removed the previously deprecated TimeRule.asString. Use TimeRule.timeRuleString instead.

4.21.0.0

2024-12-18

Routing: Deprecated the attribute Waypoint.isChargingStation. Use Waypoint.chargingStop instead.

4.21.0.0

2024-12-18

Routing: Added Waypoint.chargingStop, allowing a waypoint to be designated as a charging stop.

4.21.0.0

2024-12-18

Map view: Creating road shield and vehicle restriction icons using the beta API IconProvider.createRoadShieldIcon(), IconProvider.createVehicleRestrictionIcon() now requires an additional parameter: the IconProviderAssetType. This parameter allows you to specify whether you want to use map assets, which are optimized for the map view, or ui assets, which are optimized for UI rendering. With this release, we have also added the assets required for the ui parameter. These SVG icons are included in the HERE SDK binary and occupy approximately 264 KB when compressed. You can manually remove these assets by following the instructions in the "Best Practices" section of the Developer Guide. If you choose ui after removing the assets, the IconProvider will automatically fall back to using the map assets.

4.21.0.0

2024-12-18

Deprecated the fields accessKeyId, accessKeySecret and other related constructors. Use instead the static methods offered by AuthenticationMode, which are now preferred when initializing SDKOptions and the HERE SDK. Take a look at the "HelloMap" example app on GitHub for a usage example.

4.21.0.0

2024-12-18

A dataPath field was added to SDKOptions which allows the HERE SDK to store data for internal use. Such data includes: offline search indices, positioning content, usage data information. More information can be found in the API Reference.

4.21.0.0

2024-12-18

Map view: Added PolygonTileDataSource and PolygonTileSource APIs to allow users to inject custom polygon tile sources into the HERE SDK. Note that this is a beta release of this feature.

4.21.0.0

2024-12-18

Map view: Changed behavior of TwoFingerPanDelegate. Now, we detect a two-finger-pan gesture only after a vertical movement of at least 5 mm. Previously, it was detected already after 1.5 mm which led to accidental detections of two-finger-pan gestures for some cases.

4.21.0.0

2024-12-18

Removed the beta tag from SDKOptions.authenticationMode as the API is now considered to be stable.

4.21.0.0

2024-12-18

MapView: Fixed mapView.takeScreenshot() to avoid interfering with the map renderer when called frequently, for example, during camera animations.

4.21.0.0

2024-12-18

Map view: Some customers see a "Failed to cache texture" error message in their logs. This message can be ignored. We switched the log level for texture caching failures from error to debug since such a caching failure doesn't affect the expected usage of a texture, for example, when being used with the MapImage class.

4.21.0.0

2024-12-18

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.21.0.0

2024-12-18

Map view: After losing internet connection and then reconnecting, some roads on the map may fail to render correctly, causing parts of the map to appear incomplete.

4.21.0.0

2024-12-18

TrafficEngine: Polylines for traffic flow and incidents are not always provided as expected, sometimes polylines may be missing.

4.20.5.0

2024-11-26

MapView: 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 that this is a beta release of this feature.

4.20.5.0

2024-11-26

Search: Added new attributes to EVChargingStation to provide more detailed connector information:
- occupiedConnectorCount: Number of connectors currently in use.
- outOfServiceConnectorCount: Number of connectors out of service.
-reservedConnectorCount: Number of connectors reserved.
- lastUpdated: Timestamp of the last update for availableConnectorCount and occupiedConnectorCount.

4.20.5.0

2024-11-26

Deprecated paymentIsRequired and subscriptionIsRequired fields from EVChargingPoolDetails. Current values are always set to false.

4.20.5.0

2024-11-26

LayerConfiguration.Feature.traffic has been deprecated and will be removed in v4.23.0. Please use LayerConfiguration.Feature.rdsTraffic instead.

4.20.5.0

2024-11-26

Routing: Fixed incorrect route parsing when tolls are enabled. The problem occurred when the name of the toll systems are not available when calculating a route with tolls.

4.20.5.0

2024-11-26

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.20.4.0

2024-11-12

Map view: Added LineTileDataSource and LineTileSource APIs to allow users to inject custom line tile sources. Note that this is a beta release of this feature.

4.20.4.0

2024-11-12

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.20.3.0

2024-10-28

Map view: Added property LocationIndicator.haloColor to configure the color of the accuracy halo for the active LocationIndicator.IndicatorStyle setting. Note that this is a beta release of this feature.

4.20.3.0

2024-10-28

Added GeoPolygon(geoBox: [GeoBox]) and GeoPolyline(geoBox: [GeoBox]) to construct a GeoPolygon or a GeoPolyline from a GeoBox.

4.20.3.0

2024-10-28

Routing: Deprecated RouteOptions.occupantsNumber. Use occupantsNumber of the corresponding transport mode options instead, like CarOptions.occupants_number.

4.20.3.0

2024-10-28

Routing: Added AllowOptions structure to the following transport mode options: CarOptions, EVCarOptions, BusOptions, PrivateBusOptions, TruckOptions, EVTruckOptions. It contains options that need to be explicitly allowed by a user.

4.20.3.0

2024-10-28

Routing: Moved attribute occupantsNumber from RouteOptions to the corresponding transport mode options instead. It is added to the following transport mode options: CarOptions, EVCarOptions, BusOptions, PrivateBusOptions, TruckOptions, EVTruckOptions, ScooterOptions.

4.20.3.0

2024-10-28

Search: Added businessAndServicesPetrolGasolineStation constant to class PlaceCategory. It represents businesses that sell fuel, oil, and other motoring supplies.

4.20.3.0

2024-10-28

EV Routing: Added EVMobilityServiceProviderPreferences that represents sets of E-Mobility Service Providers' ID grouped by preference level. Added new field EVCarOptions.evMobilityServiceProviderPreferences.

4.20.3.0

2024-10-28

EV Routing: Added Waypoint.isChargingStation so that a waypoint added by an app needs to be used as a stop at a charging station, even if battery specifications indicate a stop is not required.

4.20.3.0

2024-10-28

Map view: MapViewPin instances do not disappear after tilting and panning the map far away. The pins still show up above the horizon.

4.20.3.0

2024-10-28

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.20.2.0

2024-10-15

Routing: Fixed next road numbers selection giving priority to those from signpost.

4.20.2.0

2024-10-15

Map view: Added support to show multiple truck restriction icons per road segment. Note that this is a beta release of this feature.

4.20.2.0

2024-10-15

Traffic: Renamed TrafficQueryError.invalidIncidentId to TrafficQueryError.invalidIncident. Note that this is a beta release of this feature.

4.20.2.0

2024-10-15

Traffic: Added TrafficQueryError.invalidIn, TrafficQueryError.invalidParameter and TrafficQueryError.internalError. Note that this is a beta release of this feature.

4.20.2.0

2024-10-15

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

4.20.2.0

2024-10-15

Map view: Added PointTileDataSource and PointTileSource APIs to allow users to inject custom point tile sources into the HERE SDK. A possible use case is to add a large amount of custom data, for example, adding multiple charging stations to the map. A usage example is shown in the "CustomPointTileSource" example app. Note that this is a beta release of this feature.

4.20.2.0

2024-10-15

Map view: Added MapFeature.ambientOcclusion with MapFeatureMode.ambientOcclusionAll to enable/disable an ambient occlusion (AO) effect. This enhances the realism of a rendered 3D map scene by adding subtle shadows in areas where objects meet or where surfaces are close together. Currently, AO may result in incorrectly rendered map scenes when the map view is loaded as IBOutlet. Note that this is a beta release of this feature.

4.20.2.0

2024-10-15

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

4.20.2.0

2024-10-15

Map view: MapViewPin instances do not disappear after tilting and panning the map far away. The pins still show up above the horizon.

4.20.2.0

2024-10-15

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.20.1.0

2024-09-30

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

4.20.1.0

2024-09-30

Map view: Deprecated constructor for MapLayerMapMeasureDependentStorageLevels. Use MapLayerMapMeasureDependentStorageLevels.withStorageLevelOffset() method to create MapLayerMapMeasureDependentStorageLevels instances instead.

4.20.1.0

2024-09-30

Routing: Added Toll.tollSystems to replace the deprecated Toll.tollSystem.

4.20.1.0

2024-09-30

Map view: Removed beta status for MapMeasureDependentRenderSize, representing a render size, described as map measure dependent values. The feature is now considered to be stable and any future changes will follow a strict deprecation process.

4.20.1.0

2024-09-30

Map view: Improved gesture detection: Gesture types 'GestureType.Pan' and 'GestureType.PinchRotate' can now be detected simultaneously when using two fingers.

4.20.1.0

2024-09-30

Routing: Added overload for RoutingEngine.calculateTrafficOnRoute() to calculate traffic also 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.

4.20.1.0

2024-09-30

The minimum supported iOS version for the HERE SDK has been raised from iOS 13 to iOS 15.

4.20.1.0

2024-09-30

Map view: MapViewPin instances do not disappear after tilting and panning the map far away. The pins still show up above the horizon.

4.20.1.0

2024-09-30

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.20.0.0

2024-09-25

Upcoming breaking change: The minimum supported iOS version is planned to be raised from iOS 13 to iOS 15 with HERE SDK 4.20.1.0.

4.20.0.0

2024-09-25

Map view: Added Style.update(Style) and HereMap.getStyle() that supports the customization of predefined map styles. All MapScheme styles are supported. The new style definition General.Labels.Scale.Factor is made available to control the size of labels on the map. Note that this is a beta release of this feature.

4.20.0.0

2024-09-25

Routing: Added calculateJamFactor() method to DynamicSpeedInfo structure.

4.20.0.0

2024-09-25

Routing: Deprecated TrafficSpeed structure, please use DynamicSpeedInfo structure instead. Deprecated trafficSpeed property in Span class, please use dynamicSpeedInfo property instead.

4.20.0.0

2024-09-25

Routing: Deprecated RoutingEngine.calculateIsoline(). Please use the IsolineRoutingEngine instead.

4.20.0.0

2024-09-25

Map view: Fixed the rendering of SVG icons on the map when an SVG contains a <m> tag.

4.20.0.0

2024-09-25

Search: Removed the previously deprecated CategoryQuery constructor that takes only GeoCorridor. Please use the constructor that also accepts the coordinates. Removed SearchError.polylineTooLong, as the HERE SDK resolves too long polyline issues by itself.

4.20.0.0

2024-09-25

Routing: Removed already deprecated Unknown from RoadType. Unknown was never returned and null is used instead in specific cases.

4.20.0.0

2024-09-25

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.

4.20.0.0

2024-09-25

Map view: MapViewPin instances do not disappear after tilting and panning the map far away. The pins still show up above the horizon.

4.20.0.0

2024-09-25

The API Reference you can find on here.com/docs is currently not formatted as expected. Please try to use instead the API Reference we ship as part of the downloadable release package you can find here.

4.20.0.0

2024-09-25

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.19.5.0

2024-08-30

Upcoming breaking change: The minimum supported iOS version will be raised from iOS 13 to iOS 15 with the next major release HERE SDK 4.20.0.0 which is planned for end of September 2024.

4.19.5.0

2024-08-30

Map view: Deprecated MapScene.setPoiVisibility(). Use MapContentSettings.setPoiCategoriesVisibility() and MapContentSettings.resetPoiCategoriesVisibility() instead.

4.19.5.0

2024-08-30

Routing: Fixed insecure deletion of resources to prevent possible crashes when shutting down the RoutingEngine. Now, the HERE SDK will wait until all routing requests will finish before destructing affected objects.

4.19.5.0

2024-08-30

Search: Deprecated methods SearchEngine.search(TextQuery, SearchOptions, SearchCompletionHandler) and OfflineSearchEngine.search(TextQuery, SearchOptions, SearchCompletionHandler). Please use SearchInterface.searchByText instead. Deprecated methods SearchEngine.search(AddressQuery, SearchOptions, SearchCompletionHandler) and OfflineSearchEngine.search(AddressQuery, SearchOptions, SearchCompletionHandler). Please use SearchInterface.searchByAddress instead. Deprecated methods SearchEngine.search(CategoryQuery, SearchOptions, SearchCompletionHandler) and OfflineSearchEngine.search(CategoryQuery, SearchOptions, SearchCompletionHandler). Please use SearchInterface.searchByCategory instead. Deprecated methods SearchEngine.search(GeoCoordinates, SearchOptions, SearchCompletionHandler) and OfflineSearchEngine.search(GeoCoordinates, SearchOptions, SearchCompletionHandler). Please use SearchInterface.searchByCoordinates instead. Deprecated methods SearchEngine.search(PlaceIdQuery, LanguageCode, PlaceIdCompletionHandler) and OfflineSearchEngine.search(PlaceIdQuery, LanguageCode, PlaceIdCompletionHandler). Please use SearchInterface.searchByPlaceId instead. Deprecated methods SearchEngine.searchPickedPlace and OfflineSearchEngine.searchPickedPlace. Please use SearchInterface.searchByPickedPlace instead. Deprecated methods SearchEngine.suggest(TextQuery, SearchOptions, SuggestCompletionHandler) and OfflineSearchEngine.suggest(TextQuery, SearchOptions, SuggestCompletionHandler). Please use SearchInterface.suggestByText instead. Note that the OfflineSearchEngine is only supported by the Navigate Edition.

4.19.5.0

2024-08-30

Routing: Fixed wrong turn orientation that happened when multiple streets on a junction go straight ahead.

4.19.5.0

2024-08-30

SDKOptions.customEngineBaseUrls has been deprecated in favour of SDKOptions.customEngineOptions. The new API allows setting a specific URL for online services as well as custom authentication parameters.

4.19.5.0

2024-08-30

Routing: Added missing specification detail about corridor radius in AvoidanceOptions. In addition, the limit of segments in AvoidanceOptions has been updated to match the routing limits provided by the backend. Please consult the API Reference for more details.

4.19.5.0

2024-08-30

Map view: MapViewPin instances do not disappear after tilting and panning the map far away. The pins still show up above the horizon.

4.19.5.0

2024-08-30

The API Reference you can find on here.com/docs is currently not formatted as expected. Please try to use instead the API Reference we ship as part of the downloadable release package you can find here.

4.19.5.0

2024-08-30

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.19.4.0

2024-08-26

Upcoming breaking change: The minimum supported iOS version will be raised from iOS 13 to iOS 15 with the next major release HERE SDK 4.20.0.0 which is planned for end of September 2024.

4.19.4.0

2024-08-26

Search: 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. Note that this feature was already added with HERE SDK 4.19.3.0.

4.19.4.0

2024-08-26

Search: Added EMobilityServiceProvider that represents e-Mobility service provider. Added EVChargingPool.eMobilityServiceProviders. The feature is available as closed-alpha. Note that this feature was already added with HERE SDK 4.19.3.0.

4.19.4.0

2024-08-26

Map view: MapViewPin instances do not disappear after tilting and panning the map far away. The pins still show up above the horizon.

4.19.4.0

2024-08-26

The API Reference you can find on here.com/docs is currently not formatted as expected. Please try to use instead the API Reference we ship as part of the downloadable release package you can find here.

4.19.4.0

2024-08-26

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.19.3.0

2024-08-01

The upcoming major release of the HERE SDK 4.20.0.0, scheduled for the end of September 2024, will elevate the minimum supported iOS version from iOS 13 to iOS 15.

4.19.3.0

2024-08-01

Routing: Deprecated avoidBoundingBoxAreas and avoidPolygonAreas. Use avoidBoundingBoxAreasOptions.avoidBoundingBoxArea and avoidPolygonAreasOptions.avoidPolygonArea respectively instead.

4.19.3.0

2024-08-01

Routing: Added field avoidBoundingBoxAreasOptions and avoidPolygonAreasOptions to avoid rectangular and polygon shaped area during route calculation including exceptions area (rectangular and polygon shaped) for this calculation.

4.19.3.0

2024-08-01

Routing: Added properties axleCount, trailerCount, and trailerAxleCount to CarSpecifications.

4.19.3.0

2024-08-01

Routing: Added the field AvoidanceOptions.avoidCorridorAreasOptions to avoid corridor-shaped areas during route calculation, including exception areas (rectangular, polygonal, and corridor-shaped) for this calculation. Added corridor shape as an exception area for the AvoidanceOptions.avoidBoundingBoxAreasOptions and AvoidanceOptions.avoidPolygonAreasOptions fields. Added support for exception areas for offline routing, if supported by your edition.

4.19.3.0

2024-08-01

Map view: MapViewPin instances do not disappear after tilting and panning the map far away. The pins still show up above the horizon.

4.19.3.0

2024-08-01

The API Reference you can find on here.com/docs is currently not formatted as expected. Please try to use instead the API Reference we ship as part of the downloadable release package you can find here.

4.19.3.0

2024-08-01

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.19.2.0

2024-07-20

Map view: When using MapFeatureModes.terrain3D then some portions of the tiles may fail to load when a zoom operation is performed while tiles are still loading.

4.19.2.0

2024-07-20

Map view: 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. This allows you to display custom raster tiles loaded from the local file system or from a custom backend hosting a format that does not need to be known by the HERE SDK. Find a usage example in the "CustomRasterTileSource" example app. Note that this is a beta release of this feature.

4.19.2.0

2024-07-20

Consolidated HTTP error codes into badRequest and internalServerError and output actual codes as error log.

4.19.2.0

2024-07-20

Map style update: Increased road shield icon display density. Aligned start zoom level to show the icon.

4.19.2.0

2024-07-20

Upcoming breaking change: The minimum supported iOS version will be raised from iOS 13 to iOS 15 with the next major release HERE SDK 4.20.0.0 which is planned for end of September 2024.

4.19.2.0

2024-07-20

Routing: Added occupantsNumber to RouteOptions for bus.

4.19.2.0

2024-07-20

Map view: 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 that this is a beta release of this feature.

4.19.2.0

2024-07-20

Routing: Added transponders property to TollFare to publish transponder names with toll cost.

4.19.2.0

2024-07-20

Map style update: Improved the map schemes liteHybridDay and liteHybridNight to enhance the readability of street labels, POI labels, ski run and chair lift labels, and exit billboards. For the enriched Japan map, also road facilities billboards, traffic intersection billboards and other Japan specific billboards have been improved.

4.19.2.0

2024-07-20

Routing: Added property TruckSpecifications.trailerAxleCount for toll cost calculation.

4.19.2.0

2024-07-20

Map style update: Improved readability of ferry lines and labels.

4.19.2.0

2024-07-20

Map view: MapViewPin instances do not disappear after tilting and panning the map far away. The pins still show up above the horizon.

4.19.2.0

2024-07-20

The API Reference you can find on here.com/docs is currently not formatted as expected. Please try to use instead the API Reference we ship as part of the downloadable release package you can find here.

4.19.2.0

2024-07-20

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.19.1.0

2024-07-16

Map view: Added MapFeatures.lowSpeedZones and MapFeatureModes.lowSpeedZonesAll to show areas with reduced speed limits. Only available for Japan currently. For users of the Explore Edition, this feature will be available automatically with the next map update. For the Navigate Edition, this feature is already available.

4.19.1.0

2024-07-16

Map view: Added an option to specify an offset for map measure storage level mapping. Added class MapMeasureDependentStorageLevels. Added method MapLayerBuilder.withMapMeasureDependentStorageLevels() which provides a mapping between a MapLayer map measure to datasource storage level.

4.19.1.0

2024-07-16

Routing: Added CarSpecifications to specify vehicle dimensions for CarOptions, EVCarOptions, and TaxiOptions.

4.19.1.0

2024-07-16

Map style update: Implemented additional icons for grocery, clothing and shoe shopping POIs.

4.19.1.0

2024-07-16

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

4.19.1.0

2024-07-16

Map view: MapViewPin instances do not disappear after tilting and panning the map far away. The pins still show up above the horizon.

4.19.1.0

2024-07-16

Map view: When using MapFeatureModes.terrain3D then some portions of the tiles may fail to load when a zoom operation is performed while tiles are still loading.

4.19.1.0

2024-07-16

The API Reference you can find on here.com/docs is currently not formatted as expected. Please try to use instead the API Reference we ship as part of the downloadable release package you can find here.

4.19.1.0

2024-07-16

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.19.0.0

2024-06-28

Map view: MapMarker now 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. Added the following APIs to MapMarker: init(GeoCoordinates coordinates, MapImage image, String text), String text, MapMarker.TextStyle textStyle.

4.19.0.0

2024-06-28

Map view: It is now possible, to configure the 3D light settings in a MapScene. Added the following APIs: 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 that this is a beta release of this feature.

4.19.0.0

2024-06-28

Map view: Added MapScheme.logisticsHybridDay and MapScheme.logisticsHybridNight, hybrid map schemes with focus on fleet management content.

4.19.0.0

2024-06-28

Routing: Added textUsageOption to RouteTextOptions. Defines whether street name, route number and signpost direction should be used when generating maneuver text.

4.19.0.0

2024-06-28

Routing: Removed the previously deprecated AvoidanceOptions.avoidAreas property. Please use AvoidanceOptions.avoidBoundingBoxAreas instead.

4.19.0.0

2024-06-28

Routing: Removed the previously deprecated instructionFormat attribute from RouteTextOptions.

4.19.0.0

2024-06-28

Routing: Removed the previously deprecated TextFormat.

4.19.0.0

2024-06-28

Map view: Removed the previously deprecated class PickMapContentResult.PoiResult and property PickMapContentResult.pois. Use PickedPlace and PickMapContentResult.pickedPlaces instead.

4.19.0.0

2024-06-28

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

4.19.0.0

2024-06-28

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

4.19.0.0

2024-06-28

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

4.19.0.0

2024-06-28

Map view: Renamed the beta API attribute font-size to text-size for the icon-text style technique.

4.19.0.0

2024-06-28

Map view: Added a new text-outline-width attribute to the icon-text style technique to allow the customization of the text outline width in pixels. Note that this is a beta release of this feature.

4.19.0.0

2024-06-28

Map style update: Improved density configuration for administrative labels on the map.

4.19.0.0

2024-06-28

Map style update: Improved readability of map elements like city center and cartography labels by increasing size and applying stronger colors, also boundaries by styling brighter colors and darkening satellite imagery.

4.19.0.0

2024-06-28

Map view: MapViewPin instances do not disappear after tilting and panning the map far away. The pins still show up above the horizon.

4.19.0.0

2024-06-28

Routing: An inner city Route for trucks carrying dangerous goods may not result in a SectionNotice warning when no road sign is indicating such a restriction.

4.19.0.0

2024-06-28

Map view: When using MapFeatureModes.terrain3D then some portions of the tiles may fail to load when a zoom operation is performed while tiles are still loading.

4.19.0.0

2024-06-28

The API Reference you can find on here.com/docs is currently not formatted as expected. Please try to use instead the API Reference we ship as part of the downloadable release package you can find here.

4.19.0.0

2024-06-28

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.18.5.0

2024-06-10

As announced in the changelog for HERE SDK 4.18.4.0, we transitioned to a new backend for satellite-based map schemes (satellite, hybridDay, hybridNight, liteHybridDay, liteHybridNight):

4.18.5.0

2024-06-10

Map view: Updated the supported map measure value range for 'DashImageRepresentation' from [0-20] to [1-20].

4.18.5.0

2024-06-10

Map view: Added API to manage light settings in a MapScene with: MapScene.LightType enum to define a light type, MapScene.LightAttributeSettingError enum to define attribute errors on light APIs,
MapScene.LightDirection object to specify a light direction, MapScene.LightAttributeSettingCompletionHandler interface for handling errors on light APIs, MapScene.resetLightAttributesToDefaults() to reset the attributes of all lights to their default values, MapScene.setLightColor(type: LightType, color: Color, completion: LightAttributeSettingCompletionHandler), MapScene.setLightIntensity(type: LightType, intensity: Float, completion: LightAttributeSettingCompletionHandler), MapScene.setLightDirection(type: LightType, direction: LightDirection, completion: LightAttributeSettingCompletionHandler) to set the light attributes, MapScene.getLightColor(type: LightType), MapScene.getLightIntensity(type: LightType), MapScene.getLightDirection(type: LightType) to retrieve the light attributes. Note that this is a beta release of this feature.

4.18.5.0

2024-06-10

MapViewPin instances do not disappear after tilting and panning the map far away. The pins still show up above the horizon.

4.18.5.0

2024-06-10

An inner city Route for trucks carrying dangerous goods may not result in a SectionNotice warning when no road sign is indicating such a restriction.

4.18.5.0

2024-06-10

Map view: When using MapFeatureModes.terrain3D then some portions of the tiles may fail to load when a zoom operation is performed while tiles are still loading.

4.18.5.0

2024-06-10

The API Reference you can find on here.com/docs is currently not formatted as expected. Please try to use instead the API Reference we ship as part of the downloadable release package you can find here.

4.18.5.0

2024-06-10

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.18.4.0

2024-05-28

Upcoming major change: With HERE SDK 4.18.5.0, we plan to transition to a new backend for satellite-based map schemes (satellite, hybridDay, hybridNight, liteHybridDay, liteHybridNight). These new satellite map schemes are provided through our new Platform Raster Tile Service v3, and it is only accessible when your application is managed through the HERE platform. If you have not already done so, please migrate your account from your HERE developer account to the new HERE platform portal. Your HERE Sales representative or the HERE Support Team is available to assist you. If your account has not been migrated by then, satellite map schemes will no longer be rendered starting with HERE SDK 4.18.5.0. Need more time for the account migration to the HERE platform? Don’t worry! We also provide an option to switch back to our legacy Map Tile / Satellite service: For this, the following option needs to be set before initializing the HERE SDK: sdkOptions.customEngineBaseUrls = [.rasterTileService: "https://1.aerial.maps.ls.hereapi.com/maptile/2.1/maptile/newest/satellite.day/\{z\}/\{x\}/\{y\}/512/jpg"]. Note that this option will do nothing until HERE SDK 4.18.5.0.

4.18.4.0

2024-05-28

Added LayerConfiguration.implicitlyPrefetchedFeatures to define what features are downloaded during online usage - for example, when panning the map view or during navigation (if available for your edition). Previously, the same list of features had to be enabled for offline use via MapDownloader (if available for your edition) and online use. See our Optimization Guide for the list of features that are enabled, by default. Now it is possible to define a different list for offline use via LayerConfiguration.enabledFeatures versus online usage for map view via implicitlyPrefetchedFeatures. The features for the latter are implicitly prefetched. If an empty list is set, then implicit prefetching is disabled: Effectively, this means to enable the most minimal network consumption during online use, while for offline use downloaded regions are unaffected. Note that this is a beta release of this feature.

4.18.4.0

2024-05-28

Map view: Added MapContentType.point enum value. Added PointData, PointDataBuilder, PointDataAccessor, PointDataSource and PointDataSourceBuilder for creating and managing custom geodetic point data sources. Note that this is a beta release of this feature.

4.18.4.0

2024-05-28

Search: Added TripAdvisor support via SearchEngine.setCustomOption(). Note that this option is only available for customer who own a HERE license for rich content access including TripAdvisor.

4.18.4.0

2024-05-28

Added EngineBaseURL.rasterTileService enum value to set a custom base URL template for the raster tile service. The EngineBaseURL can be set via SDKOptions. This option can be used to switch back to our legacy Map Tile service starting with HERE SDK 4.18.5.0. Note that this option will do nothing until HERE SDK 4.18.5.0. For more details, see our changelog entry regarding the planned Map Tile backend switch.

4.18.4.0

2024-05-28

MapViewPin instances do not disappear after tilting and panning the map far away. The pins still show up above the horizon.

4.18.4.0

2024-05-28

An inner city Route for trucks carrying dangerous goods may not result in a SectionNotice warning when no road sign is indicating such a restriction.

4.18.4.0

2024-05-28

Map view: When using MapFeatureModes.terrain3D then some portions of the tiles may fail to load when a zoom operation is performed while tiles are still loading.

4.18.4.0

2024-05-28

The API Reference you can find on here.com/docs is currently not formatted as expected. Please try to use instead the API Reference we ship as part of the downloadable release package you can find here.

4.18.4.0

2024-05-28

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.18.3.0

2024-05-17

Upcoming major change: With HERE SDK 4.18.5.0, we plan to transition to a new backend for satellite-based map schemes (satellite, hybridDay, hybridNight, liteHybridDay, liteHybridNight). These new satellite map schemes are provided through our new Platform Raster Tile Service v3, and it is only accessible when your application is managed through the HERE platform. If you have not already done so, please migrate your account from your HERE developer account to the new HERE platform portal. Your HERE Sales representative or the HERE Support Team is available to assist you. If your account has not been migrated by then, satellite map schemes will no longer be rendered starting with HERE SDK 4.18.5.0. Need more time for the account migration to the HERE platform? Don’t worry! We also provide an option to switch back to our legacy Map Tile / Satellite service. This fallback option will be available with HERE SDK 4.18.4.0. More details will be shared in the upcoming changelogs.

4.18.3.0

2024-05-17

Map view: 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 that this feature is released as beta.

4.18.3.0

2024-05-17

Search: Added new place category ID constant PlaceCategory.facilitiesSchool.

4.18.3.0

2024-05-17

Routing: Added TollOptions to specify how tolls should be calculated by specifying co2Class, emissionType, transponders and vehicleCategory.

4.18.3.0

2024-05-17

Routing: Fixed RoutingEngine.returnToRoute(..) method where the returned route lacked stopovers when the lastTraveledSectionIndex parameter was zero.

4.18.3.0

2024-05-17

MapViewPin instances do not disappear after tilting and panning the map far away. The pins still show up above the horizon.

4.18.3.0

2024-05-17

An inner city Route for trucks carrying dangerous goods may not result in a SectionNotice warning when no road sign is indicating such a restriction.

4.18.3.0

2024-05-17

Map view: When using MapFeatureModes.terrain3D then some portions of the tiles may fail to load when a zoom operation is performed while tiles are still loading.

4.18.3.0

2024-05-17

The API Reference you can find on here.com/docs is currently not formatted as expected. Please try to use instead the API Reference we ship as part of the downloadable release package you can find here.

4.18.3.0

2024-05-17

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.18.2.0

2024-05-03

Map view: Added MapContentType.polygon enum value. Added PolygonData, PolygonDataBuilder, PolygonDataAccessor, PolygonDataSource and PolygonDataSourceBuilder for creating and managing custom geodetic polygon data sources. Note that this feature is released as beta.

4.18.2.0

2024-05-03

Added a privacy manifest file to the HERE SDK framework to describe the data collected by the HERE SDK and the purposes for this data collection. Starting May 1st, Apple will require such manifests in order to publish or update apps on the App Store.

4.18.2.0

2024-05-03

Map view: Added GeoPolygon(vertices: [GeoCoordinates], innerBoundaries: [[GeoCoordinates]]) to construct a GeoPolygon with inner boundaries (holes) and GeoPolygon.innerBoundaries member to store and access the inner boundaries of a GeoPolygon.

4.18.2.0

2024-05-03

Routing: Added displayLocation to Waypoint and RoutePlace to specify the GeoCoordiates of a POI to indicate its physical location.

4.18.2.0

2024-05-03

Deprecated TimeRule.asString. It will be removed in v4.21.0. Please use TimeRule.timeRuleString instead.

4.18.2.0

2024-05-03

Map style update: Added dedicated roadshield icon for Indonesia.

4.18.2.0

2024-05-03

MapViewPin instances do not disappear after tilting and panning the map far away. The pins still show up above the horizon.

4.18.2.0

2024-05-03

An inner city Route for trucks carrying dangerous goods may not result in a SectionNotice warning when no road sign is indicating such a restriction.

4.18.2.0

2024-05-03

The API Reference you can find on here.com/docs is currently not formatted as expected. Please try to use instead the API Reference we ship as part of the downloadable release package you can find here.

4.18.2.0

2024-05-03

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.18.1.0

2024-04-23

Routing: Fixed incorrect side of destination by exposing side of street information from routing response - if available and when Waypoint.sideOfStreetHint is provided when calculating a route.

4.18.1.0

2024-04-23

Map view: Fixed lost camera limits when setting MapCameraLimits.zoomRange.

4.18.1.0

2024-04-23

MapViewPin instances do not disappear after tilting and panning the map far away. The pins still show up above the horizon.

4.18.1.0

2024-04-23

An inner city Route for trucks carrying dangerous goods may not result in a SectionNotice warning when no road sign is indicating such a restriction.

4.18.1.0

2024-04-23

The API Reference you can find on here.com/docs is currently not formatted as expected. Please try to use instead the API Reference we ship as part of the downloadable release package you can find here.

4.18.1.0

2024-04-23

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.18.0.0

2024-04-16

As announced previously, with HERE SDK 4.18.0.0, we have raised the minimum supported iOS version from iOS 12.4 to iOS 13.0.

4.18.0.0

2024-04-16

Deprecated SearchError.polylineTooLong as it can no longer occur: The HERE SDK now resolves too long polyline automatically under the hood. SearchError.polylineTooLong will be removed with HERE SDK 4.20.0.

4.18.0.0

2024-04-16

Map style update: Enabled Z-Level road rendering.

4.18.0.0

2024-04-16

EV routing: Removed beta notice for EVChargingPool, EVChargingStation, EVChargingPoolDetails and EVSE. These APIs are now considered to be stable. A charging pool for electric vehicles is an area equipped with one or more charging stations. A charging station defines a group of connectors for electrical vehicles that share a common charging connector type and max power level.

4.18.0.0

2024-04-16

Map view: Renamed MapFeatureModes.terrainHillshading and MapFeatureModes.terrainHillshadingWith3d to MapFeatureModes.terrainHillshade and MapFeatureModes.terrain3d respectively. Note that the renamed modes are released as beta.

4.18.0.0

2024-04-16

Routing: Removed the previously deprecated Span.polyline. Use instead Span.geometry.

4.18.0.0

2024-04-16

Map view: Removed the previously deprecated LocationIndicator implementation of MapViewLifecycleDelegate. Use LocationIndicator.enable and LocationIndicator.disable to add or remove a LocationIndicator from a MapView.

4.18.0.0

2024-04-16

Search: Deprecated the CategoryQuery.Area constructor that only takes the corridor as parameter. Use instead the constructor that requires both the corridor and coordinates.

4.18.0.0

2024-04-16

Routing: Introduced IsolineRoutingEngine to support the existing routing isoline feature which was available through the RoutingEngine and that has been deprecated with this release.

4.18.0.0

2024-04-16

RoutingEngine: Deprecated method calculateIsoline(..). The functionality has been moved to the new IsolineRoutingEngine.

4.18.0.0

2024-04-16

Map view: Added MapContext.freeResource() to free resources used by map view objects. This feature is intended for use when system resource availability becomes low. For example, it allows to free memory when the application transitions to background.

4.18.0.0

2024-04-16

Routing: Removed the previously deprecated routingEngine.returnToRoute(...) method overload which required to calculate the traveled fraction to be set as parameter. Use instead the routingEngine.returnToRoute(...) overload which directly consumes the RouteDeviation parameters to provide the same information. routeDeviation.fractionTraveled has been removed for the same reason. Use instead routeDeviation.lastTraveledSectionIndex and routeDeviation.traveledDistanceOnLastSectionInMeters. Note that the RouteDeviation event is only available for the Navigate Edition.

4.18.0.0

2024-04-16

Map view: Removed previously deprecated properties for visual properties of a MapPolyline as well as the related constructors. Use instead MapPolyline.SolidRepresentation and MapPolyline.DashRepresentation with MapPolyline.setRepresentation(Representation) and the constructor MapPolyline(GeoPolyline, Representation).

4.18.0.0

2024-04-16

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.

4.18.0.0

2024-04-16

Removed beta status for RoutingEngine.refreshRoute(..) and RoutingEngine.importRoute(..)` and their overloads, except for taxi mode which remains beta.

4.18.0.0

2024-04-16

MapViewPin instances do not disappear after tilting and panning the map far away. The pins still show up above the horizon.

4.18.0.0

2024-04-16

An inner city Route for trucks carrying dangerous goods may not result in a SectionNotice warning when no road sign is indicating such a restriction.

4.18.0.0

2024-04-16

The API Reference you can find on here.com/docs is currently not formatted as expected. Please try to use instead the API Reference we ship as part of the downloadable release package you can find here.

4.18.0.0

2024-04-16

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.17.5.0

2024-03-20

Upcoming breaking change - with HERE SDK 4.18.0.0, our next major release, we plan to raise the minimum supported iOS version from iOS 12.4 to iOS 13.0.

4.17.5.0

2024-03-20

Map view: 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. This feature allows to consume less memory for large data sets - instead of using MapPolyline. It allows also finer control over the style and layer stacking, for example, to show a line before map labels. See also our style guide for custom map styles for more information - which is part of the Developer Guide. Note that this feature is a beta release of this feature.

4.17.5.0

2024-03-20

Map view: Added 'MapScheme.logisticsNight', the dark equivalent to 'MapScheme.logisticsDay' with focus on fleet management content.

4.17.5.0

2024-03-20

Map view: Removed the beta status for MapScene.enableFeatures(..), MapScene.disableFeatures(..), MapScene.getSupportedFeatures() and MapScene.getActiveFeatures(). The API is now considered to be stable.

4.17.5.0

2024-03-20

Map style update: Added additional localized bank POIs.

4.17.5.0

2024-03-20

Map view: Fixed density independent pixel scaling for 'MapMarker3d'.

4.17.5.0

2024-03-20

Routing: Added timeRule property to TollFare to indicate applicable times for toll costs.

4.17.5.0

2024-03-20

MapViewPin instances do not disappear after tilting and panning the map far away. The pins still show up above the horizon.

4.17.5.0

2024-03-20

An inner city Route for trucks carrying dangerous goods may not result in a SectionNotice warning when no road sign is indicating such a restriction.

4.17.5.0

2024-03-20

The API Reference you can find on here.com/docs is currently not formatted as expected. Please try to use instead the API Reference we ship as part of the downloadable release package you can find here.

4.17.5.0

2024-03-20

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.17.4.0

2024-03-05

Upcoming breaking change - with HERE SDK 4.18.0.0, our next major release, we plan to raise the minimum supported iOS version from iOS 12.4 to iOS 13.0.

4.17.4.0

2024-03-05

Map style update: Implemented dynamic label placement for embedded carto POIs. Depending on the available space, labels can appear top, left or right around the POI icon to improve readability.

4.17.4.0

2024-03-05

Map style update: Added outline display for polygonal roads in Japan.

4.17.4.0

2024-03-05

RoutingEngine: Added RoutingConnectionSettings option as overloaded constructor parameter to allow custom network connection settings, for example, to specify the retry logic when connecting the HERE routing backend. Note that this change was already introduced with HERE SDK 4.17.3.0.

4.17.4.0

2024-03-05

Added pitchInDegrees to Location class and deadReckoning to LocationTechnology enum. Note that these values are not set by the HERE SDK, but applications can now make use of such fields - for example, when special hardware is attached that is capable of providing such data. The new fields are also useful when recording GPX files with the HERE SDK - if available for your edition.

4.17.4.0

2024-03-05

MapViewPin instances do not disappear after tilting and panning the map far away. The pins still show up above the horizon.

4.17.4.0

2024-03-05

An inner city Route for trucks carrying dangerous goods may not result in a SectionNotice warning when no road sign is indicating such a restriction.

4.17.4.0

2024-03-05

The API Reference you can find on here.com/docs is currently not formatted as expected. Please try to use instead the API Reference we ship as part of the downloadable release package you can find here.

4.17.4.0

2024-03-05

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.17.3.0

2024-02-19

Upcoming breaking change - with HERE SDK 4.18.0.0, our next major release, we plan to raise the minimum supported iOS version from iOS 12.4 to iOS 13.0.

4.17.3.0

2024-02-19

Introduced visual improvements for the roads in a hybrid scheme on a zoom-in level. Now transparent roads are displayed without round cap artifacts at the intersection of road segments.

4.17.3.0

2024-02-19

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.

4.17.3.0

2024-02-19

MapViewPin instances do not disappear after tilting and panning the map far away. The pins still show up above the horizon.

4.17.3.0

2024-02-19

An inner city Route for trucks carrying dangerous goods may not result in a SectionNotice warning when no road sign is indicating such a restriction.

4.17.3.0

2024-02-19

The API Reference you can find on here.com/docs is currently not formatted as expected. Please try to use instead the API Reference we ship as part of the downloadable release package you can find here.

4.17.3.0

2024-02-19

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.17.2.0

2024-02-02

Added PlaceFilter.EV.minPowerInKilowatts that enables retrieving EV charging stations with the given minimum charging power. Note that this is released as closed-alpha for selected customers. By default, this feature results in a SearchError.forbidden when your credentials are not enabled.

4.17.2.0

2024-02-02

Map view: Changed the allowed range for the camera's field of view (FoV) for MapCameraKeyframeTrack.fieldOfView() and MapCameraUpdateFactory.setVerticalFieldOfView() - the value for the FoV will be clamped to the range [1deg, 150deg].

4.17.2.0

2024-02-02

Map style update: Enabled display of outlines for water polygons and polylines.

4.17.2.0

2024-02-02

Upcoming breaking change - with HERE SDK 4.18.0.0, our next major release, we plan to raise the minimum supported iOS version from iOS 12.4 to iOS 13.0.

4.17.2.0

2024-02-02

Map view: Added DrawOrderType to represent the type of a draw order. Added mapPolyline.drawOrderType property. For example, with mapSceneAdditionOrderIndependent you can specify that the draw order should not depend on the order of when an item is added. Instead, multiple map items of the same type with the same draw order can be drawn in an arbitrary order and map items with similar attributes like color can be grouped and drawn together all at once to improve the rendering performance.

4.17.2.0

2024-02-02

Routing: Added more route violation codes with SectionNoticeCode.violatedAvoidDifficultTurns, SectionNoticeCode.potentialCarpool, SectionNoticeCode.potentialTurnRestriction, SectionNoticeCode.potentialVehicleRestriction, SectionNoticeCode.potentialZoneRestriction, SectionNoticeCode.violatedChagingStationOpeningHours and SectionNoticeCode.tollsDataTemporarilyUnavailable.

4.17.2.0

2024-02-02

Routing: Added ViolatedRestriction.Details.timeRule to inform on the time intervals during which restrictions are enforced.

4.17.2.0

2024-02-02

MapViewPin instances do not disappear after tilting and panning the map far away. The pins still show up above the horizon.

4.17.2.0

2024-02-02

An inner city Route for trucks carrying dangerous goods may not result in a SectionNotice warning when no road sign is indicating such a restriction.

4.17.2.0

2024-02-02

The API Reference you can find on here.com/docs is currently not formatted as expected. Please try to use instead the API Reference we ship as part of the downloadable release package you can find here.

4.17.2.0

2024-02-02

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.17.1.0

2024-01-24

MapImageOverlay and related APIs are considered to be stable. Removed the beta status.

4.17.1.0

2024-01-24

Fixed an issue for the map schemes .roadNetworkDay and .roadNetworkNightwhereMapMarker` items are not rendered as expected.

4.17.1.0

2024-01-24

The HERE SDK is now built with Xcode 14.2 instead of Xcode 13.2.1.

4.17.1.0

2024-01-24

Map style update: Increased the density for city labels. City labels are now shown 1 or 2 zoom levels earlier.

4.17.1.0

2024-01-24

Added PickMapContentResult.pickedPlaces containing a list of PickedPlace results. A PickedPlace can be use more efficiently to search for a Place when an embedded map marker is picked from the map. Take a look at the CartoPOIPicking example app for a possible usage scenario.

4.17.1.0

2024-01-24

Deprecated PickMapContentResult.PoiResult and PickMapContentResult.pois. Use PickedPlace and PickMapContentResult.pickedPlaces instead.

4.17.1.0

2024-01-24

Search: Added PickedPlace.offlineSearchId that holds a place ID. Note that the parameter is meant to be consumed by the HERE SDK internally when passing a PickedPlace as argument to a search engine.

4.17.1.0

2024-01-24

Search: Added Address.stateCode that contains a state code for the address.

4.17.1.0

2024-01-24

Map style update: Added new embedded carto POIs for the following categories: Golf Shop, EV Dealership - New Vehicles, EV Dealership - Used Vehicles, EV Repair and Urgent Care Center.

4.17.1.0

2024-01-24

Upcoming breaking change - with HERE SDK 4.18.0.0, our next major release, we plan to raise the minimum supported iOS version from iOS 12.4 to iOS 13.0.

4.17.1.0

2024-01-24

MapViewPin instances do not disappear after tilting and panning the map far away. The pins still show up above the horizon.

4.17.1.0

2024-01-24

An inner city Route for trucks carrying dangerous goods may not result in a SectionNotice warning when no road sign is indicating such a restriction.

4.17.1.0

2024-01-24

The API Reference you can find on here.com/docs is currently not formatted as expected. Please try to use instead the API Reference we ship as part of the downloadable release package you can find here.

4.17.1.0

2024-01-24

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.17.0.0

2023-12-15

MapView: Added Easing class representing an easing function to be used with animations. This will deprecate the existing use of EasingFunction. 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).

4.17.0.0

2023-12-15

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.

4.17.0.0

2023-12-15

Custom raster tiles: 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. TileUrlProviderCallback and TileUrlProviderFactory are no longer beta APIs and are now considered to be stable.

4.17.0.0

2023-12-15

Routing: Fixed too long shield text for road shields in Japan when English language is used.

4.17.0.0

2023-12-15

Custom backends: Added enum EngineBaseURL.trafficVectorTileService to provide a custom traffic vector tile service URL. This impacts the traffic flow feature shown on the MapView.

4.17.0.0

2023-12-15

Added GeoBox.intersection(GeoBox) and static GeoBox.intersection(List<GeoBox>) to detect an intersection of two or more geo boxes - also known as collision check.

4.17.0.0

2023-12-15

TrafficEngine: Added queryForFlow() methods for querying traffic flow data within a bounding box, a circle, or a corridor. Via TrafficFlowQueryOptions you can specify the min/max jam factor. The callback provides a list of TrafficFlow objects that contain details on the traffic flow. The data may differ from the traffic flow feature shown on the map view. Note that this is a beta release of this feature.

4.17.0.0

2023-12-15

Deprecated RouteTextOptions.instructionFormat as it is not supported.

4.17.0.0

2023-12-15

Deprecated static function MapView.deinitialize(). Deprecated static function MapView.resume(). Use instead per map view instance the resume() method. Deprecated static function MapView.pause(). Use instead per map view instance the pause() method.

4.17.0.0

2023-12-15

Custom raster layer: Added a Style class to update visual properties of a raster layer at runtime - such as transparency. Added JsonStyleFactory to create a 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 is a beta release of this feature, so there could be a few bugs and unexpected behaviors. Related APIs may change for new releases without a deprecation process.

4.17.0.0

2023-12-15

Routing: Deprecated AvoidanceOptions.avoidAreas. Use AvoidanceOptions.avoidBoundingBoxAreas instead.

4.17.0.0

2023-12-15

Routing: Added property avoidPolygonAreas to AvoidanceOptions to enable avoiding polygon-shaped areas during route calculation.

4.17.0.0

2023-12-15

Routing: Removed the previously deprecated Span.routeNumber. Use instead Span.roadNumbers.

4.17.0.0

2023-12-15

Routing: Fixed missing Maneuver items that occurred sometimes for specific locations with highway splits.

4.17.0.0

2023-12-15

MapView: Added two new MapScheme layers: roadNetworkDay and roadNetworkNight which highlight roads without showing other content such as labels or buildings. It is designed for usage as an additional zoomed-in mini-maps display to help drivers to orientate during navigation and to focus on the maneuver arrows which can be highlighted on top of these new map schemes.

4.17.0.0

2023-12-15

MapViewPin instances do not disappear after tilting and panning the map far away. The pins still show up above the horizon.

4.17.0.0

2023-12-15

An inner city Route for trucks carrying dangerous goods may not result in a SectionNotice warning when no road sign is indicating such a restriction.

4.17.0.0

2023-12-15

The API Reference you can find on here.com/docs is currently not formatted as expected. Please try to use instead the API Reference we ship as part of the downloadable release package you can find here.

4.17.0.0

2023-12-15

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.16.4.0

2023-12-05

Routing: Added trafficOptimizationMode to RouteOptions to completely disable traffic optimization. Furthermore, the newly introduced TrafficOptimizationMode will replace the deprecated RouteOptions.enableTrafficOptimization flag.

4.16.4.0

2023-12-05

Deprecated RouteOptions.enableTrafficOptimization. Use RouteOptions.trafficOptimizationMode instead.

4.16.4.0

2023-12-05

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

4.16.4.0

2023-12-05

Map style update: Improved state and county capital label priority.

4.16.4.0

2023-12-05

Map style update: Added a new coach icon and improved the existing tram icon.

4.16.4.0

2023-12-05

Routing: Added builtUpArea and controlledAccessHighway to StreetAttributes enum.

4.16.4.0

2023-12-05

Deprecated controlledAccess enum value in StreetAttributes. Use instead controlledAccessHighway.

4.16.4.0

2023-12-05

Removed closed-alpha APIs sdk.search.EVPaymentMethod and sdk.search.PlaceFilter.EV.paymentMethods.

4.16.4.0

2023-12-05

Map style update: Improved toll tunnel styling in Japan for the day, night and logistics map schemes.

4.16.4.0

2023-12-05

MapViewPin instances do not disappear after tilting and panning the map far away. The pins still show up above the horizon.

4.16.4.0

2023-12-05

An inner city Route for trucks carrying dangerous goods may not result in a SectionNotice warning when no road sign is indicating such a restriction.

4.16.4.0

2023-12-05

The API Reference you can find on here.com/docs is currently not formatted as expected. Please try to use instead the API Reference we ship as part of the downloadable release package you can find here.

4.16.4.0

2023-12-05

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.16.3.0

2023-11-13

Added shadows constant to MapFeatures as well as shadowsAll constant to MapFeatureModes to enable/disable shadows for 3D buildings. Added enum ShadowQuality. Added MapView.shadowQuality property to set and get shadow quality. Note that this is a beta release of this feature.

4.16.3.0

2023-11-13

Routing: Added minChargetAtFirstChargingStationInKilowattHours to BatterySpecifications. It indicates the minimum charge in kWh when arriving at the first charging station.

4.16.3.0

2023-11-13

Routing: Added support for private bus routing. Private buses are vehicles that are operated by a private transport company and that do not have access to bus-only lanes reserved for public transit. Use BusSpecifications to determine the properties of a private bus. Added CalculationOptionsType.privateBus. Added CalculationOptions.privateBusOptions. Added PrivateBusOptions struct. Added RoutingInterface.calculateRoute(..) method for private bus transport mode. Added RoutingEngine.importRoute(..) method for private bus routing. Added RefreshRouteOptions constructor for private bus routing.

4.16.3.0

2023-11-13

Map style update: Added mountain peak elevation visualization.

4.16.3.0

2023-11-13

Routing: Added maxWeightPerAxleGroupInKilograms to ViolatedRestriction. Indicates where the max permitted weight per axle group during the trip in kilograms is exceeded.

4.16.3.0

2023-11-13

MapViewPin instances do not disappear after tilting and panning the map far away. The pins still show up above the horizon.

4.16.3.0

2023-11-13

An inner city Route for trucks carrying dangerous goods may not result in a SectionNotice warning when no road sign is indicating such a restriction.

4.16.3.0

2023-11-13

The API Reference you can find on here.com/docs is currently not formatted as expected. Please try to use instead the API Reference we ship as part of the downloadable release package you can find here. The API Reference you can find on here.com/docs is currently not formatted as expected. Please try to use instead the API Reference we ship as part of the downloadable release package you can find here.

4.16.3.0

2023-11-13

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.16.2.0

2023-10-27

Added BusOptions.BusSpecifications to specify the properties of a bus for route calculation, such as weight or vehicle dimensions.

4.16.2.0

2023-10-27

Added Details.foodTypes to show the available food types of a Place such as a restaurant while searching for a Place.

4.16.2.0

2023-10-27

Added ViolatedRestriction.Details.routingZoneReference to provide more details of a restricted routing zone that has been violated. It will be set when AvoidanceOptions.zoneCategories is not empty.

4.16.2.0

2023-10-27

Added ViolatedRestriction.Details.maxPayloadCapacityInKilograms to provide details of the maximum permitted payload capacity that has been violated.

4.16.2.0

2023-10-27

Added a green and white road shield icon to indicate a Trans-Canada highway on the MapView.

4.16.2.0

2023-10-27

Fixed missing maneuver generation when turning while navigation.

4.16.2.0

2023-10-27

Added new overloads to import bicycle, scooter and pedestrian routes to the RoutingEngine. There are two overloads - one without RouteStop and one with a RouteStop parameter.

4.16.2.0

2023-10-27

Added two new language codes for esAr (Argentinian Spanish) and nlBe (Flemish) to LanguageCode.

4.16.2.0

2023-10-27

Removed BuildConfig class.

4.16.2.0

2023-10-27

MapViewPin instances do not disappear after tilting and panning the map far away. The pins still show up above the horizon.

4.16.2.0

2023-10-27

An inner city Route for trucks carrying dangerous goods may not result in a SectionNotice warning when no road sign is indicating such a restriction.

4.16.2.0

2023-10-27

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.16.1.0

2023-10-18

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

4.16.1.0

2023-10-18

Removed deprecated log levels: LogLevel.logLevelTrace and LogLevel.logLevelDebug. Removed SDKNativeEngine.setLogAppender(LogAppender) method, use the LogControl API instead.

4.16.1.0

2023-10-18

Added SDKNativeEngine.passThroughFeature property to allow traffic services to access online data although the offlineMode is globally activated via SDKOptions or the shared instance of SDKNativeEngine.

4.16.1.0

2023-10-18

RoadTexts: Removed the previously deprecated numbers, towards members and constructors with arguments. Use the numbersWithDirection field instead.

4.16.1.0

2023-10-18

Added MapPolyline.SolidRepresentation and MapPolyline.DashRepresentation to encapsulate the visual properties of a MapPolyline.

4.16.1.0

2023-10-18

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 all deprecated methods/properties: MapPolyline​.init(geometry:widthInPixels:color:)), MapPolyline.init(geometry:widthInPixels:color:outlineWidthInPixels:outlineColor:), lineWidth, lineColor, lineCap, measureDependentLineWidth, outlineWidth, outlineColor, measureDependentOutlineWidth, dashPattern, dashFillColor.

4.16.1.0

2023-10-18

MapView: The MapMeasureDependentRenderSize API is now production-ready: Removed the beta status. The API represents a render size - described as map-measure dependent values.

4.16.1.0

2023-10-18

MapView: The APIs for MapPolyline.Representation and MapPoyline.setRepresentation(_:) are now production-ready. Removed the beta status.

4.16.1.0

2023-10-18

Routing: Added property id to TrafficIncidentOnRoute.

4.16.1.0

2023-10-18

SearchEngine: Added PlaceFoodType, CategoryQuery.includeFoodTypes and CategoryQuery.excludeFoodTypes to support food type filtering.

4.16.1.0

2023-10-18

Routing: Added payloadCapacityInKilograms to TruckSpecifications to specify the allowed payload capacity, including trailers. The provided value must be >= 0. By default, it is set to null, which means that the value will be ignored for route calculation with the RoutingEngine or the OfflineRoutingEngine (if available for your edition).

4.16.1.0

2023-10-18

Map style update: Improved visualization of truck restrictions icons related to the amount of axles, weight per axle group, weight per axle number and axle group restriction.

4.16.1.0

2023-10-18

Map style update: Reverted the font used for text rendering of carto POIs from bold to regular. This issue was introduced accidentally with HERE SDK 4.14.5.0.

4.16.1.0

2023-10-18

MapViewPin instances do not disappear after tilting and panning the map far away: The pins still show up above the horizon.

4.16.1.0

2023-10-18

An inner city Route for trucks carrying dangerous goods may not result in a SectionNotice warning when no road sign is indicating such a restriction.

4.16.1.0

2023-10-18

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.16.0.0

2023-10-16

Removed deprecated function CatalogVersionHint.latest(). Use instead CatalogVersionHint.latest(Bool).

4.16.0.0

2023-10-16

Removed deprecated Maneuver.ferry. This maneuver is not supported.

4.16.0.0

2023-10-16

Removed deprecated log levels: LogLevel.logLevelTrace and LogLevel.logLevelDebug. Removed SDKNativeEngine.setLogAppender(LogAppender) method, use the LogControl API instead.

4.16.0.0

2023-10-16

Map style update: Improved showing traffic icons for road closures, when a road is closed - independent of the actual incident type.

4.16.0.0

2023-10-16

Removed the deprecated option routeOptions.enableEnterHighwayManeuverAction(). The feature is now enabled, by default.

4.16.0.0

2023-10-16

Custom maps: Added enum EngineBaseURL.trafficData to provide a custom traffic backend URL.

4.16.0.0

2023-10-16

Removed deprecated method MapViewBase.setWatermarkPlacement(_ placement: WatermarkPlacement, bottomMargin: Int32).

4.16.0.0

2023-10-16

Added MapMeasureDependentRenderSize to represent a render size, described as map-measure dependent values. Note that this is a beta release of this feature.

4.16.0.0

2023-10-16

Changed beta API MapPolyline.DashImageRepresentation to be immutable. Use MapMeasureDependentRenderSize type as size input parameter instead of a map of (double, double).

4.16.0.0

2023-10-16

Added GeoBox.envelope(GeoBox) and static GeoBox.envelopeGeoBoxes(List<GeoBox>) to encompass two or more geo boxes into one box.

4.16.0.0

2023-10-16

Added MapContentSettings.setTrafficRefreshPeriod(_ value: TimeInterval) method to adjust the traffic refresh period and MapContentSettings.resetTrafficRefreshPeriod() to reset the applied traffic refresh period.

4.16.0.0

2023-10-16

MapViewPin instances do not disappear after tilting and panning the map far away: The pins still show up above the horizon.

4.16.0.0

2023-10-16

An inner city Route for trucks carrying dangerous goods may not result in a SectionNotice warning when no road sign is indicating such a restriction.

4.16.0.0

2023-10-16

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.15.5.0

2023-09-20

MapView: Added MapCameraUpdateFactory.compositeUpdate([MapCameraUpdate]) to support the creation of a composite MapCameraUpdate instance that allows to execute all given updates sequentially in the order they were provided in the list.

4.15.5.0

2023-09-20

Map style update: Added bathymetry ocean visualization for the normalDay and normalNight map schemes.

4.15.5.0

2023-09-20

Added two MapCameraUpdateFactory.lookToMatch(..) functions that match the given GeoCoordinates to a given viewPoint in order to position the map camera. This does not change the principal point. Note that this is a beta release of this feature.

4.15.5.0

2023-09-20

Truck routing: Added TruckRoadTypes enum that specifies the Swedish types BK1, BK2, BK3, BK4 and the Mexican types A2, A4, B2, B4, C, D, ET2, ET4. This is useful for truck-specific road networks that define complex restrictions. The listed types correlate to detailed LAT vehicle specifications which are usually known to truck drivers. For example, truck drivers in Sweden have to know the BK class of their truck to know on which roads they are allowed to drive. Set a avoidedTruckRoadTypes list via TruckOptions or EVTruckOptions. If these options are violated, find a warning in the SectionNotice of a Route: Added violatedAvoidTruckRoadType to SectionNoticeCode and forbiddenTruckRoadTypes to ViolatedRestriction.Details.

4.15.5.0

2023-09-20

Routing: Fixed cases where a wrong ManeuverAction is generated for forks on highways.

4.15.5.0

2023-09-20

Search: Added EVChargingPool.cpoId and EVChargingPool.evseInfo as closed-alpha. The fields contain info on the CPO ID (Charge Point Operator ID) and the Electric Vehicle Supply Equipment ID (EVSE ID). This is useful for drivers of electric vehicles to determine the charging infrastructure at a charging point. Note: The new fields are only set for participants of the closed-alpha group who got access from HERE to use this feature.

4.15.5.0

2023-09-20

Search: Added PlaceFilter.ev.paymentMethods and EVPaymentMethod as closed-alpha. This allows to filter search results based on the available payment methods at a charging station for electric vehicles. Currently, it is not possible to verify the payment methods for the resulting Place. Note: The new filter is only available for participants of the closed-alpha group who got access from HERE to use this feature. If your credentials are not enabled, a [SearchError.forbidden] will be propagated.

4.15.5.0

2023-09-20

Map style update: Improved the density of city labels. For this, the visibility range of certain city labels has been adjusted.

4.15.5.0

2023-09-20

MapViewPin instances do not disappear after tilting and panning the map far away: The pins still show up above the horizon.

4.15.5.0

2023-09-20

An inner city Route for trucks carrying dangerous goods may not result in an error message.

4.15.5.0

2023-09-20

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.15.4.0

2023-09-06

A Route object contains now a list of RouteRailwayCrossing elements which indicate the GeoCoordinates, a RouteOffset and the RouteRailwayCrossingType of a railway for a train or a tram line that is crossing the route. Note that this change was already introduced with HERE SDK 4.15.3.0.

4.15.4.0

2023-09-06

SearchEngine: Added PlaceFilter.ev.supplierNames and PlaceFilter.ev.connectorTypeIDs as closed-alpha: Participants of the closed-alpha group can get access from HERE to use this feature. If your credentials are not enabled, a [SearchError.FORBIDDEN] will be propagated.

4.15.4.0

2023-09-06

Map style update: The MapScheme.LITE_NIGHT was improved with dark street colors. Other map elements were styled accordingly to fit the new design.

4.15.4.0

2023-09-06

Map style update: Country borders are now visually improved - increasing the line width with a more saturated color. State borders will now change from a solid to a dashed line based on the current zoom level.

4.15.4.0

2023-09-06

RoutingEngine: Removed unsupported transport modes for importRoute(..) overloads for bicycles, pedestrians and scooters when importing routes from a list of Location objects. In addition, removed support for importRoute(..) overloads that use RefreshRouteOptions constructed from BicycleOptions, PedestrianOptions, or ScooterOptions.

4.15.4.0

2023-09-06

RoutingEngine: Added an overload of the importRoute(..) method to specify a list of RouteStop elements. When importing a route just from a list of coordinates, the information on stopover waypoints is usually lost. Use the RouteStop class to specify such stops. It allows to specify a locationIndex and a stopDuration. This will influence the overall ETA - and during navigation the RouteStop will be treated as a stopover waypoint so that it will be reported as a Milestone when passing-by (note that navigation is only supported for the Navigate Edition).

4.15.4.0

2023-09-06

Pick carto POIs: You can now use the SearchEngine or the OfflineSearchEngine (not available for all editions) to retrieve a Place object containing more details: Use the PickMapContentResult as data to create a PickedPlace object that can be used to search for the Place. Added PickedPlace that is accepted by the new methods SearchEngine.searchPickedPlace(..) and OfflineSearchEngine.searchPickedPlace(..) (not available for all editions).

4.15.4.0

2023-09-06

Map style update: Improved the visibility of icons shown in the logistics map scheme.

4.15.4.0

2023-09-06

Map style update: Improved map labels for political views.

4.15.4.0

2023-09-06

Map style update: Added carto POIs for the place category "Business Facility".

4.15.4.0

2023-09-06

Custom map styles: Added mapScene.reloadScene() to ensure that an entire scene is reloaded again without using any cached data. This can be useful, when local changes are done on a JSON style file and the same file should be loaded again. This method skips internal optimization checks and enforces a reload of the scene.

4.15.4.0

2023-09-06

MapViewPin instances do not disappear after tilting and panning the map far away: The pins still show up above the horizon.

4.15.4.0

2023-09-06

An inner city Route for trucks carrying dangerous goods may not result in an error message.

4.15.4.0

2023-09-06

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.15.3.0

2023-08-25

MapView: Using a LocationIndicator as a MapViewLifecycleListener has been deprecated. Instead, locationIndicator.enable(..) and locationIndicator.disable() can be used to add/remove a LocationIndicator to/from a MapViewBase.

4.15.3.0

2023-08-25

Routing: Deprecated 'Span.polyline'. Use 'Span.geometry' instead.

4.15.3.0

2023-08-25

Added NetworkEndpoint class to specify a DNS server. Note that this class can be ignored for now.

4.15.3.0

2023-08-25

MapViewPin instances do not disappear after tilting and panning the map far away: The pins still show up above the horizon.

4.15.3.0

2023-08-25

An inner city Route for trucks carrying dangerous goods may not result in an error message.

4.15.3.0

2023-08-25

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.15.2.0

2023-08-04

Search: Removed TextQuery.fuelTypes, TextQuery.truckFuelTypes, TextQuery.truckClass. Use instead TextQuery.placeFilter.

4.15.2.0

2023-08-04

Custom raster layers: Deprecated the Provider constructors for RasterDataSourceConfiguration in favor of newly added constructors that consume the new urlProvider parameter to set the newly added TileUrlProviderCallback. Deprecated also the field that holds the templateUrl member. Use the newly introduced urlProvider instead.

4.15.2.0

2023-08-04

Custom raster layers: Added a TileUrlProviderCallback that can be set to get notified when a new tile is requested from the specified tile data source. Added the convenience function TileUrlProviderFactory.fromXyzUrlTemplate() that can be set as urlProvider if the new callback feature is not needed. Take a look at the Developer Guide for a usage example. Note that this is a beta release of this feature.

4.15.2.0

2023-08-04

Search: Removed CategoryQuery.fuelTypes, CategoryQuery.truckFuelTypes, CategoryQuery.truckClass. Use instead CategoryQuery.placeFilter.

4.15.2.0

2023-08-04

Search: Added CategoryQuery.placeFilter, TextQuery.placeFilter and PlaceFilter that is used to specify place filtering options.

4.15.2.0

2023-08-04

RoutingEngine: Improved the routing algorithm for trucks. Now, roads with a FunctionalRoadClass of 3 or 4 are penalized more than before. As a result, smaller roads are a bit more often avoided. Overall, this will result in routes that are better suited for trucks.

4.15.2.0

2023-08-04

Map style update: Added public transit carto POIs specific for each country.

4.15.2.0

2023-08-04

MapViewPin instances do not disappear after tilting and panning the map far away: The pins still show up above the horizon.

4.15.2.0

2023-08-04

An inner city Route for trucks carrying dangerous goods may not result in an error message.

4.15.2.0

2023-08-04

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.15.1.0

2023-07-26

By default, SDKOptions.cachePath and SDKOptions.persistentMapStoragePath are now empty - even after the HERE SDK was initialized. Setting a new string, will overwrite the internally used default path, \{Application_Home\}/Library/Caches. Note that relative and absolute paths can be set. A relative path will use the internally used default path as parent.

4.15.1.0

2023-07-26

Map style updates: Restricted access aoads are now styled according to the properties of a road segment. The HERE Style Editor exposes the following values: Private, Service Road, or Public Access = no.

4.15.1.0

2023-07-26

Feature configurations and other properties can be no longer set via plist file. The OptionReader class has been removed.

4.15.1.0

2023-07-26

The shared instance of the SDKNativeEngine isn't created automatically on startup and instead it must be created explicitly as shown in the accompanying example apps.

4.15.1.0

2023-07-26

Improved readability of logs: Now, all HERE SDK log messages are prefixed with "hsdk-" to make it easier to identify which messages are coming from the HERE SDK.

4.15.1.0

2023-07-26

Map style updates: Improved polygone outline styling for environmental and congestion zones.

4.15.1.0

2023-07-26

MapViewPin instances do not disappear after tilting and panning the map far away: The pins still show up above the horizon.

4.15.1.0

2023-07-26

An inner city Route for trucks carrying dangerous goods may not result in an error message.

4.15.1.0

2023-07-26

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.15.0.0

2023-07-18

Added roadExitLabels constant to MapFeatures as well as roadExitLabelsNumbersOnly and roadExitLabelsAll constants to MapFeatureModes to enable/disable rendering of road exit labels on the map.

4.15.0.0

2023-07-18

Removed SDKOptions.enableIndexing flag. Use instead OfflineSearchEngine.setIndexOptions(). Note that the OfflineSearchEngine is not available for all editions.

4.15.0.0

2023-07-18

Routing: Added offsetStart and offsetEnd properties to SegmentReference class.

4.15.0.0

2023-07-18

Removed deprecated MapFeatureMode.trafficFlowRegionSpecific. Please use MapFeatureModes.trafficFlowJapanWithoutFreeFlow instead.

4.15.0.0

2023-07-18

MapView: It is now possible to show traffic flow and a route side-by-side at any zoom level. The line width for MapArrow and MapPolyline can now be specified per zoom level. 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. Note that this is a beta release of this feature.

4.15.0.0

2023-07-18

Added support for dashed polylines: 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 a polyline. Added contructor MapPolyline.init(geometry: GeoPolyline, representation: MapPolyline.Representation) that allows to create
a polyline that is using MapPolyline.Representation for defining the visual appearance of a line. Added public func MapPolyline.setRepresentation(_ representation: MapPolyline.Representation) to change the visual appearance of a polyline.

4.15.0.0

2023-07-18

Removed deprecated TextQuery.includeChains and TextQuery.includeChains. Please use CategoryQuery.includeChains and CategoryQuery.excludeChains instead.

4.15.0.0

2023-07-18

Pass-through waypoints can now be retrieved from a Route: Added class PassThroughWaypoint and Section.passthroughWaypoints property.

4.15.0.0

2023-07-18

Improved visual map styles: Added a new POI icon for EV charging stations.

4.15.0.0

2023-07-18

Removed depracated RoadFeatures.difficultTurns and SectionNoticeCode.violatedAvoidDifficultTurns enums. Use other available options instead such as uTurns.

4.15.0.0

2023-07-18

Removed the previously deprecated TruckSpecifications.type. Please use TruckSpecifications.truckType instead.

4.15.0.0

2023-07-18

Added 'MapScheme.logisticsDay', a day version map scheme with focus on fleet management content.

4.15.0.0

2023-07-18

Added UsageStats class that gathers statistics of the HERE SDK network usage to count all uploaded and downloaded data. Use SDKNativeEngine.getSdkUsageStats() and SDKNativeEngine.enableUsageStats() to retrieve the network statistics. Note that this is a beta release of this feature.

4.15.0.0

2023-07-18

Added isOffRoad method to the RoutePlace that indicates if a route place is off-road or not.

4.15.0.0

2023-07-18

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.

4.15.0.0

2023-07-18

Removed deprecated MapScene.Layers. MapScene.setLayerVisibility can no longer be used to enable/disable map features. Please use MapScene.enableFeatures and MapScene.disableFeatures instead.

4.15.0.0

2023-07-18

MapCamera: The altitude value (if set) of the lookAt target GeoCoordinates is ignored. Any subsequent camera updates and animations will consider the target coordinates as being located on the ground. Impacted methods (including overloads): MapCameraAnimationFactory.flyTo(), MapCamera.lookAt() and MapCameraUpdateFactory.lookAt().

4.15.0.0

2023-07-18

Improved visual map styles: City center labels for small villages (hamlets) are now already visible starting from zoom level 13 - instead of 14.

4.15.0.0

2023-07-18

Removed the previously deprecated MapCameraKeyframeTrack.focalLength() method. Use MapCameraKeyframeTrack.fieldOfView() instead.
Removed the previously deprecated MapCameraKeyframeTrack.setFocalLength() method. Use MapCameraKeyframeTrack.setVerticalFieldOfView() instead.

4.15.0.0

2023-07-18

Fixed missing support for place.boundingBox when serializing a Place via Place.serializeCompact().

4.15.0.0

2023-07-18

MapViewPin instances do not disappear after tilting and panning the map far away: The pins still show up above the horizon.

4.15.0.0

2023-07-18

An inner city Route for trucks carrying dangerous goods may not result in an error message.

4.15.0.0

2023-07-18

The global offline switch sdkNativeEngine.isOfflineMode() does not load map tiles after enabling the online mode again or after restoring a lost network connection. As a workaround the map view has to be panned & zoomed a bit to activate the online mode again.

4.14.5.0

2023-06-28

Added support for road shield icons. With iconProvider.createRoadShieldIcon(...) you can now asynchronously create a UIImage that depicts a road number such as "A7" or "US-101" - as it already appears on the map view. Added IconProvider.IconCallback to receive the resulting image or an error. The icon is generated offline from RoadShieldIconProperties that require parameters such as RouteType and LocalizedRoadNumber. These parameters can be retrieved from the Span of a Route object. Added span.getShieldText(..) to get the shieldText for use with RoadShieldIconProperties. Added span.getRoadNumbers() to get a list of LocalizedRoadNumber items with additional information such as RouteType (level 1 to 6, indicating whether a road is a major road or not) and CardinalDirection (such as in "101 West"). Note: This is a beta release of this feature.