HERE SDK for iOS (Explore)

Version

Date

Change

Description

4.25.5.0

2026-04-14

ADDED

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

4.25.5.0

2026-04-14

ADDED

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

4.25.5.0

2026-04-14

CHANGED

Map view: Renamed MapContext.setMemoryManagementOptions(MemoryManagementOptions, 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

ADDED

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

4.25.5.0

2026-04-14

CHANGED

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

4.25.5.0

2026-04-14

ADDED

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

4.25.5.0

2026-04-14

ADDED

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

4.25.5.0

2026-04-14

ADDED

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

4.25.5.0

2026-04-14

CHANGED

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

4.25.5.0

2026-04-14

ADDED

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

4.25.5.0

2026-04-14

CHANGED

Deprecated the TransportProfile class. Use TransportSpecification instead.

4.25.4.0

2026-03-10

ADDED

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

4.25.4.0

2026-03-10

CHANGED

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

4.25.4.0

2026-03-10

CHANGED

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

4.25.4.0

2026-03-10

CHANGED

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

4.25.4.0

2026-03-10

ADDED

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

4.25.4.0

2026-03-10

CHANGED

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

4.25.4.0

2026-03-10

ADDED

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

4.25.3.0

2026-02-19

ADDED

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

CHANGED

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

4.25.3.0

2026-02-19

ADDED

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

4.25.2.0

2026-02-06

ADDED

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

4.25.2.0

2026-02-06

CHANGED

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

4.25.2.0

2026-02-06

ADDED

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

4.25.2.0

2026-02-06

CHANGED

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

CHANGED

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

4.25.2.0

2026-02-06

CHANGED

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

4.25.1.0

2026-01-20

ADDED

Map view: Added the following new classes and methods: MapSceneLoadOptions: Represents the complete configuration for loading a map scene, combining the scene source (MapScheme or configurationFile) and optional settings like enabledFeatures, disabledFeatures, watermarkStyle, and overridingMapStyle. Added MapSceneLoadOptionsBuilder: Builder class for creating MapSceneLoadOptions instances. The builder enforces that exactly one mapScheme or configurationFile is set. Added MapScene.loadScene(_: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

ADDED

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

4.25.1.0

2026-01-20

ADDED

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

4.25.1.0

2026-01-20

CHANGED

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

4.25.1.0

2026-01-20

CHANGED

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

4.25.1.0

2026-01-20

ADDED

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

4.25.1.0

2026-01-20

ADDED

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

4.25.1.0

2026-01-20

CHANGED

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

4.25.1.0

2026-01-20

ADDED

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

4.25.1.0

2026-01-20

ADDED

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

CHANGED

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

4.25.1.0

2026-01-20

ADDED

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

4.25.1.0

2026-01-20

CHANGED

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

4.25.1.0

2026-01-20

ADDED

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

4.25.1.0

2026-01-20

ADDED

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

4.25.0.0

2025-12-19

CHANGED

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

4.25.0.0

2025-12-19

CHANGED

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

CHANGED

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

4.25.0.0

2025-12-19

ADDED

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

4.25.0.0

2025-12-19

CHANGED

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

4.25.0.0

2025-12-19

CHANGED

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

4.25.0.0

2025-12-19

ADDED

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

4.25.0.0

2025-12-19

CHANGED

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

4.24.5.0

2025-11-27

FIXED

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

CHANGED

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

FIXED

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

4.24.4.0

2025-11-12

FIXED

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

4.24.3.0

2025-11-03

ADDED

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

CHANGED

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

ADDED

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

CHANGED

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

ADDED

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

4.24.1.0

2025-10-01

CHANGED

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

4.24.1.0

2025-10-01

ADDED

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

4.24.1.0

2025-10-01

CHANGED

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

4.24.1.0

2025-10-01

CHANGED

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

4.24.1.0

2025-10-01

FIXED

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

4.24.1.0

2025-10-01

ADDED

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

4.24.1.0

2025-10-01

ADDED

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

4.24.0.0

2025-09-17

CHANGED

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

4.24.0.0

2025-09-17

CHANGED

Routing: Removed evDetails from Route. Use consumptionInKilowattHours instead.

4.24.0.0

2025-09-17

CHANGED

Routing: Removed evDetails from Section. Use consumptionInKilowattHours instead.

4.24.0.0

2025-09-17

CHANGED

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

4.24.0.0

2025-09-17

CHANGED

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

4.24.0.0

2025-09-17

CHANGED

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

4.23.5.0

2025-09-03

ADDED

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

4.23.4.0

2025-08-21

FIXED

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

4.23.4.0

2025-08-21

FIXED

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

4.23.4.0

2025-08-21

FIXED

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

4.23.3.0

2025-08-05

CHANGED

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

ADDED

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

4.23.3.0

2025-08-05

ADDED

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

4.23.3.0

2025-08-05

FIXED

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

4.23.2.0

2025-07-23

ADDED

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

4.23.2.0

2025-07-23

ADDED

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

4.23.2.0

2025-07-23

ADDED

Routing: Added ViolatedRestriction.Details.maxNumberOfTires, 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

ADDED

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

4.23.1.0

2025-07-15

CHANGED

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

4.23.1.0

2025-07-15

ADDED

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

4.23.1.0

2025-07-15

CHANGED

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

4.23.1.0

2025-07-15

CHANGED

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

4.23.1.0

2025-07-15

CHANGED

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

4.23.1.0

2025-07-15

ADDED

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

4.23.1.0

2025-07-15

CHANGED

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

4.23.0.0

2025-07-08

CHANGED

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

4.23.0.0

2025-07-08

CHANGED

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

4.23.0.0

2025-07-08

CHANGED

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

4.23.0.0

2025-07-08

ADDED

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

4.23.0.0

2025-07-08

CHANGED

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

4.23.0.0

2025-07-08

CHANGED

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

4.23.0.0

2025-07-08

CHANGED

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

4.23.0.0

2025-07-08

FIXED

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

4.23.0.0

2025-07-08

ADDED

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

4.23.0.0

2025-07-08

CHANGED

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

4.23.0.0

2025-07-08

CHANGED

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

4.23.0.0

2025-07-08

CHANGED

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

4.23.0.0

2025-07-08

ADDED

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

4.23.0.0

2025-07-08

ADDED

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

4.22.5.0

2025-06-10

ADDED

No new features for this release of the Explore Edition.

4.22.4.0

2025-05-28

ADDED

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

4.22.3.0

2025-05-13

ADDED

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

4.22.3.0

2025-05-13

ADDED

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

4.22.3.0

2025-05-13

ADDED

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

4.22.3.0

2025-05-13

ADDED

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

4.22.3.0

2025-05-13

ADDED

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

4.22.2.0

2025-04-30

ADDED

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

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

4.22.2.0

2025-04-30

ADDED

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

4.22.2.0

2025-04-30

ADDED

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

4.22.2.0

2025-04-30

ADDED

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

4.22.1.0

2025-04-16

ADDED

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

4.22.1.0

2025-04-16

FIXED

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

4.22.1.0

2025-04-16

FIXED

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

4.22.1.0

2025-04-16

CHANGED

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

4.22.0.0

2025-04-03

ADDED

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

CHANGED

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

CHANGED

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

ADDED

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

CHANGED

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

4.22.0.0

2025-04-03

CHANGED

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

4.22.0.0

2025-04-03

CHANGED

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

4.22.0.0

2025-04-03

CHANGED

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

CHANGED

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

4.22.0.0

2025-04-03

FIXED

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

4.22.0.0

2025-04-03

ADDED

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

CHANGED

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

4.21.5.0

2025-03-17

ADDED

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

CHANGED

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

4.21.5.0

2025-03-17

ADDED

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

4.21.5.0

2025-03-17

ADDED

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

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

ADDED

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

ADDED

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

CHANGED

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

4.21.5.0

2025-03-17

FIXED

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

FIXED

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

4.21.4.0

2025-05-13

ADDED

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

4.21.4.0

2025-05-13

ADDED

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

4.21.3.0

2025-02-18

ADDED

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

ADDED

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

CHANGED

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

CHANGED

Deprecated BusSpecifications.lastCharacterOfLicensePlate. Use instead BusOptions.lastCharacterOfLicensePlate.

4.21.3.0

2025-02-18

ADDED

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

KNOWN ISSUE

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

ADDED

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

ADDED

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

ADDED

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

ADDED

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

ADDED

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

FIXED

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

ADDED

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

4.21.2.0

2025-02-03

ADDED

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

ADDED

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

4.21.2.0

2025-02-03

ADDED

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

ADDED

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

4.21.2.0

2025-02-03

ADDED

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

4.21.2.0

2025-02-03

ADDED

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

4.21.2.0

2025-02-03

KNOWN ISSUE

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

FIXED

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

FIXED

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

ADDED

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

CHANGED

Routing: Deprecated maxGrossWeightInKilograms. Use instead maxWeight.

4.21.1.0

2025-01-22

CHANGED

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

4.21.1.0

2025-01-22

ADDED

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

4.21.1.0

2025-01-22

CHANGED

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

ADDED

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

ADDED

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

ADDED

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

FIXED

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

4.21.1.0

2025-01-22

ADDED

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

4.21.1.0

2025-01-22

ADDED

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

CHANGED

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

4.21.1.0

2025-01-22

KNOWN ISSUE

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

ADDED

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

CHANGED

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

FIXED

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

FIXED

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

4.21.0.0

2024-12-18

CHANGED

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

4.21.0.0

2024-12-18

CHANGED

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

4.21.0.0

2024-12-18

ADDED

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

4.21.0.0

2024-12-18

CHANGED

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

CHANGED

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

ADDED

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

ADDED

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

FIXED

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

ADDED

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

4.21.0.0

2024-12-18

FIXED

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

FIXED

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

KNOWN ISSUE

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

KNOWN ISSUE

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

KNOWN ISSUE

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

CHANGED

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

ADDED

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

CHANGED

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

4.20.5.0

2024-11-26

CHANGED

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

FIXED

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

KNOWN ISSUE

4.20.4.0

2024-11-12

ADDED

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

KNOWN ISSUE

4.20.3.0

2024-10-28

ADDED

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

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

CHANGED

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

4.20.3.0

2024-10-28

ADDED

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

ADDED

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

ADDED

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

ADDED

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

ADDED

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

KNOWN ISSUE

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

KNOWN ISSUE

4.20.2.0

2024-10-15

FIXED

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

4.20.2.0

2024-10-15

ADDED

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

CHANGED

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

4.20.2.0

2024-10-15

ADDED

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

CHANGED

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

ADDED

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

ADDED

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

FIXED

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

KNOWN ISSUE

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

KNOWN ISSUE

4.20.1.0

2024-09-30

ADDED

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

CHANGED

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

4.20.1.0

2024-09-30

ADDED

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

4.20.1.0

2024-09-30

ADDED

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

CHANGED

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

ADDED

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

CHANGED

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

KNOWN ISSUE

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

KNOWN ISSUE

4.20.0.0

2024-09-25

CHANGED

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

ADDED

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

ADDED

Routing: Added calculateJamFactor() method to DynamicSpeedInfo structure.

4.20.0.0

2024-09-25

CHANGED

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

CHANGED

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

4.20.0.0

2024-09-25

FIXED

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

CHANGED

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

CHANGED

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

CHANGED

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

KNOWN ISSUE

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

KNOWN ISSUE

4.20.0.0

2024-09-25

KNOWN ISSUE

4.19.5.0

2024-08-30

CHANGED

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

CHANGED

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

4.19.5.0

2024-08-30

FIXED

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

CHANGED

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

FIXED

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

4.19.5.0

2024-08-30

CHANGED

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

FIXED

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

KNOWN ISSUE

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

KNOWN ISSUE

4.19.5.0

2024-08-30

KNOWN ISSUE

4.19.4.0

2024-08-26

CHANGED

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

ADDED

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

ADDED

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

KNOWN ISSUE

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

KNOWN ISSUE

4.19.4.0

2024-08-26

KNOWN ISSUE

4.19.3.0

2024-08-01

CHANGED

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

CHANGED

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

4.19.3.0

2024-08-01

ADDED

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

ADDED

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

4.19.3.0

2024-08-01

ADDED

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

KNOWN ISSUE

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

KNOWN ISSUE

4.19.3.0

2024-08-01

KNOWN ISSUE

4.19.2.0

2024-07-20

FIXED

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

ADDED

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

FIXED

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

4.19.2.0

2024-07-20

ADDED

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

4.19.2.0

2024-07-20

CHANGED

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

ADDED

Routing: Added occupantsNumber to RouteOptions for bus.

4.19.2.0

2024-07-20

CHANGED

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

ADDED

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

4.19.2.0

2024-07-20

CHANGED

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

ADDED

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

4.19.2.0

2024-07-20

FIXED

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

4.19.2.0

2024-07-20

KNOWN ISSUE

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

KNOWN ISSUE

4.19.2.0

2024-07-20

KNOWN ISSUE

4.19.1.0

2024-07-16

ADDED

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

ADDED

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

ADDED

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

4.19.1.0

2024-07-16

ADDED

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

4.19.1.0

2024-07-16

ADDED

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

4.19.1.0

2024-07-16

KNOWN ISSUE

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

KNOWN ISSUE

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

KNOWN ISSUE

4.19.1.0

2024-07-16

KNOWN ISSUE

4.19.0.0

2024-06-28

ADDED

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

ADDED

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

ADDED

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

4.19.0.0

2024-06-28

ADDED

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

CHANGED

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

4.19.0.0

2024-06-28

CHANGED

Routing: Removed the previously deprecated instructionFormat attribute from RouteTextOptions.

4.19.0.0

2024-06-28

CHANGED

Routing: Removed the previously deprecated TextFormat.

4.19.0.0

2024-06-28

CHANGED

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

CHANGED

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

ADDED

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

CHANGED

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

CHANGED

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

ADDED

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

FIXED

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

4.19.0.0

2024-06-28

ADDED

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

KNOWN ISSUE

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

KNOWN ISSUE

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

KNOWN ISSUE

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

KNOWN ISSUE

4.19.0.0

2024-06-28

KNOWN ISSUE

4.18.5.0

2024-06-10

CHANGED

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

CHANGED

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

4.18.5.0

2024-06-10

ADDED

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

KNOWN ISSUE

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

KNOWN ISSUE

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

KNOWN ISSUE

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

KNOWN ISSUE

4.18.5.0

2024-06-10

KNOWN ISSUE

4.18.4.0

2024-05-28

CHANGED

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

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

ADDED

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

ADDED

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

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

KNOWN ISSUE

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

KNOWN ISSUE

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

KNOWN ISSUE

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

KNOWN ISSUE

4.18.4.0

2024-05-28

KNOWN ISSUE

4.18.3.0

2024-05-17

CHANGED

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

ADDED

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

ADDED

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

4.18.3.0

2024-05-17

ADDED

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

4.18.3.0

2024-05-17

FIXED

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

4.18.3.0

2024-05-17

KNOWN ISSUE

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

KNOWN ISSUE

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

KNOWN ISSUE

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

KNOWN ISSUE

4.18.3.0

2024-05-17

KNOWN ISSUE

4.18.2.0

2024-05-03

ADDED

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

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

ADDED

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

ADDED

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

CHANGED

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

4.18.2.0

2024-05-03

ADDED

Map style update: Added dedicated roadshield icon for Indonesia.

4.18.2.0

2024-05-03

KNOWN ISSUE

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

KNOWN ISSUE

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

KNOWN ISSUE

4.18.2.0

2024-05-03

KNOWN ISSUE

4.18.1.0

2024-04-23

FIXED

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

FIXED

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

4.18.1.0

2024-04-23

KNOWN ISSUE

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

KNOWN ISSUE

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

KNOWN ISSUE

4.18.1.0

2024-04-23

KNOWN ISSUE

4.18.0.0

2024-04-16

CHANGED

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

CHANGED

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

ADDED

Map style update: Enabled Z-Level road rendering.

4.18.0.0

2024-04-16

ADDED

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

CHANGED

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

CHANGED

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

4.18.0.0

2024-04-16

CHANGED

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

CHANGED

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

ADDED

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

CHANGED

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

4.18.0.0

2024-04-16

ADDED

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

CHANGED

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

CHANGED

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

FIXED

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

ADDED

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

KNOWN ISSUE

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

KNOWN ISSUE

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

KNOWN ISSUE

4.18.0.0

2024-04-16

KNOWN ISSUE

4.17.5.0

2024-03-20

CHANGED

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

ADDED

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

ADDED

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

4.17.5.0

2024-03-20

CHANGED

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

ADDED

Map style update: Added additional localized bank POIs.

4.17.5.0

2024-03-20

FIXED

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

4.17.5.0

2024-03-20

ADDED

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

4.17.5.0

2024-03-20

KNOWN ISSUE

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

KNOWN ISSUE

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

KNOWN ISSUE

4.17.5.0

2024-03-20

KNOWN ISSUE

4.17.4.0

2024-03-05

CHANGED

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

ADDED

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

ADDED

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

4.17.4.0

2024-03-05

ADDED

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

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

KNOWN ISSUE

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

KNOWN ISSUE

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

KNOWN ISSUE

4.17.4.0

2024-03-05

KNOWN ISSUE

4.17.3.0

2024-02-19

CHANGED

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

ADDED

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

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

KNOWN ISSUE

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

KNOWN ISSUE

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

KNOWN ISSUE

4.17.3.0

2024-02-19

KNOWN ISSUE

4.17.2.0

2024-02-02

ADDED

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

CHANGED

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

ADDED

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

4.17.2.0

2024-02-02

CHANGED

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

ADDED

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

ADDED

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

ADDED

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

4.17.2.0

2024-02-02

KNOWN ISSUE

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

KNOWN ISSUE

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

KNOWN ISSUE

4.17.2.0

2024-02-02

KNOWN ISSUE

4.17.1.0

2024-01-24

ADDED

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

4.17.1.0

2024-01-24

FIXED

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

4.17.1.0

2024-01-24

ADDED

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

4.17.1.0

2024-01-24

CHANGED

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

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

CHANGED

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

4.17.1.0

2024-01-24

ADDED

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

ADDED

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

4.17.1.0

2024-01-24

ADDED

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

CHANGED

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

KNOWN ISSUE

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

KNOWN ISSUE

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

KNOWN ISSUE

4.17.1.0

2024-01-24

KNOWN ISSUE

4.17.0.0

2023-12-15

ADDED

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

CHANGED

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

CHANGED

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

FIXED

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

4.17.0.0

2023-12-15

ADDED

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

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

ADDED

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

CHANGED

Deprecated RouteTextOptions.instructionFormat as it is not supported.

4.17.0.0

2023-12-15

CHANGED

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

ADDED

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

CHANGED

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

4.17.0.0

2023-12-15

ADDED

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

4.17.0.0

2023-12-15

CHANGED

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

4.17.0.0

2023-12-15

FIXED

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

4.17.0.0

2023-12-15

ADDED

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

KNOWN ISSUE

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

KNOWN ISSUE

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

KNOWN ISSUE

4.17.0.0

2023-12-15

KNOWN ISSUE

4.16.4.0

2023-12-05

ADDED

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

CHANGED

Deprecated RouteOptions.enableTrafficOptimization. Use RouteOptions.trafficOptimizationMode instead.

4.16.4.0

2023-12-05

ADDED

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

ADDED

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

4.16.4.0

2023-12-05

ADDED

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

4.16.4.0

2023-12-05

ADDED

Routing: Added builtUpArea and controlledAccessHighway to StreetAttributes enum.

4.16.4.0

2023-12-05

CHANGED

Deprecated controlledAccess enum value in StreetAttributes. Use instead controlledAccessHighway.

4.16.4.0

2023-12-05

CHANGED

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

4.16.4.0

2023-12-05

ADDED

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

4.16.4.0

2023-12-05

KNOWN ISSUE

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

KNOWN ISSUE

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

KNOWN ISSUE

4.16.4.0

2023-12-05

KNOWN ISSUE

4.16.3.0

2023-11-13

ADDED

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

ADDED

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

ADDED

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

ADDED

Map style update: Added mountain peak elevation visualization.

4.16.3.0

2023-11-13

ADDED

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

KNOWN ISSUE

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

KNOWN ISSUE

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

KNOWN ISSUE

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

KNOWN ISSUE

4.16.2.0

2023-10-27

ADDED

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

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

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

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

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

Fixed missing maneuver generation when turning while navigation.

4.16.2.0

2023-10-27

ADDED

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

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

4.16.2.0

2023-10-27

CHANGED

Removed BuildConfig class.

4.16.2.0

2023-10-27

KNOWN ISSUE

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

KNOWN ISSUE

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

KNOWN ISSUE

4.16.1.0

2023-10-18

FIXED

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

4.16.1.0

2023-10-18

CHANGED

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

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

CHANGED

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

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

4.16.1.0

2023-10-18

ADDED

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

ADDED

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

ADDED

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

4.16.1.0

2023-10-18

ADDED

Routing: Added property id to TrafficIncidentOnRoute.

4.16.1.0

2023-10-18

ADDED

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

4.16.1.0

2023-10-18

ADDED

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

ADDED

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

FIXED

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

KNOWN ISSUE

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

KNOWN ISSUE

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

KNOWN ISSUE

4.16.0.0

2023-10-16

CHANGED

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

4.16.0.0

2023-10-16

CHANGED

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

4.16.0.0

2023-10-16

CHANGED

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

ADDED

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

CHANGED

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

4.16.0.0

2023-10-16

ADDED

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

4.16.0.0

2023-10-16

CHANGED

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

4.16.0.0

2023-10-16

ADDED

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

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

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

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

KNOWN ISSUE

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

KNOWN ISSUE

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

KNOWN ISSUE

4.15.5.0

2023-09-20

ADDED

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

ADDED

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

4.15.5.0

2023-09-20

ADDED

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

ADDED

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

FIXED

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

4.15.5.0

2023-09-20

ADDED

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

ADDED

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

ADDED

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

KNOWN ISSUE

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

KNOWN ISSUE

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

4.15.5.0

2023-09-20

KNOWN ISSUE

4.15.4.0

2023-09-06

ADDED

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

ADDED

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

ADDED

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

ADDED

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

CHANGED

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

ADDED

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

ADDED

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

ADDED

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

4.15.4.0

2023-09-06

FIXED

Map style update: Improved map labels for political views.

4.15.4.0

2023-09-06

ADDED

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

4.15.4.0

2023-09-06

ADDED

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

KNOWN ISSUE

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

KNOWN ISSUE

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

4.15.4.0

2023-09-06

KNOWN ISSUE

4.15.3.0

2023-08-25

CHANGED

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

CHANGED

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

4.15.3.0

2023-08-25

ADDED

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

4.15.3.0

2023-08-25

KNOWN ISSUE

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

KNOWN ISSUE

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

4.15.3.0

2023-08-25

KNOWN ISSUE

4.15.2.0

2023-08-04

CHANGED

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

4.15.2.0

2023-08-04

CHANGED

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

ADDED

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

CHANGED

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

4.15.2.0

2023-08-04

ADDED

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

4.15.2.0

2023-08-04

ADDED

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

ADDED

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

4.15.2.0

2023-08-04

KNOWN ISSUE

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

KNOWN ISSUE

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

4.15.2.0

2023-08-04

KNOWN ISSUE

4.15.1.0

2023-07-26

CHANGED

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

ADDED

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

CHANGED

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

CHANGED

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

ADDED

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

ADDED

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

4.15.1.0

2023-07-26

KNOWN ISSUE

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

KNOWN ISSUE

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

4.15.1.0

2023-07-26

KNOWN ISSUE

4.15.0.0

2023-07-18

ADDED

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

CHANGED

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

ADDED

Routing: Added offsetStart and offsetEnd properties to SegmentReference class.

4.15.0.0

2023-07-18

CHANGED

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

4.15.0.0

2023-07-18

ADDED

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

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

CHANGED

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

4.15.0.0

2023-07-18

ADDED

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

4.15.0.0

2023-07-18

ADDED

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

4.15.0.0

2023-07-18

CHANGED

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

4.15.0.0

2023-07-18

CHANGED

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

4.15.0.0

2023-07-18

ADDED

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

4.15.0.0

2023-07-18

ADDED

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

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

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

CHANGED

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

CHANGED

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

ADDED

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

CHANGED

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

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

4.15.0.0

2023-07-18

KNOWN ISSUE

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

KNOWN ISSUE

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

4.15.0.0

2023-07-18

KNOWN ISSUE

4.14.5.0

2023-06-28

ADDED

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.

4.14.5.0

2023-06-28

ADDED

Added WeightPerAxleGroup to TruckSpecifications. Allows specification of axle weights in a more fine-grained way than weightPerAxleInKilograms.

4.14.5.0

2023-06-28

ADDED

Updated map styles: Improved the visual styling of tunnels.

4.14.5.0

2023-06-28

ADDED

Updated map styles: Changed the visual appearance of roads: The outline width for roads has been adjusted. Note: For styles that have been customized with the HERE Style Editor where the default outline widths have been overwritten for roads, the road outlines may now appear thinner.

4.14.5.0

2023-06-28

ADDED

Feature configurations are now expressed in code. Exposed LayerConfiguration to specify the list of features to enable. As before, by disabling map features that are not essential for the application it is possible to optimize the size of the map to download. Note that with next release it will be no longer possible to define feature configurations via Plist.

4.14.5.0

2023-06-28

CHANGED

With next release it will be no longer possible to define feature configurations via Plist. Use the new LayerConfiguration instead.

4.14.5.0

2023-06-28

KNOWN ISSUE

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

4.14.5.0

2023-06-28

KNOWN ISSUE

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

4.14.5.0

2023-06-28

KNOWN ISSUE

4.14.4.0

2023-06-12

FIXED

3DMapMarker: Loading textures is now working as expected and 3DMapMarker items are visible again. Under the hood, the libpng library from Apple is used again. No more workarounds are needed on app side.

4.14.4.0

2023-06-12

ADDED

MapView: It is now possible to hide icons from the MapFeatures.vehicleRestrictions layer when they cross the path of a MapPolyline: Added an API for a map polyline to block vehicle restriction icons. Added MapPolyline.mapContentCategoriesToBlock: [MapContentCategory] property. Added MapContentCategory enum.

4.14.4.0

2023-06-12

ADDED

MapView: Improved the visual style of the embedded carto POI used for the "Art Museum" category.

4.14.4.0

2023-06-12

KNOWN ISSUE

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

4.14.4.0

2023-06-12

KNOWN ISSUE

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

4.14.4.0

2023-06-12

KNOWN ISSUE

4.14.3.0

2023-05-25

ADDED

Added 'MapScheme.liteDay', 'MapScheme.liteNight', 'MapScheme.liteHybridDay', 'MapScheme.liteHybridNight' schemes, which are the simplified versions of the respective normal map schemes. These simplified scheme variants serve well as background for more complex content such as public transit lines.

4.14.3.0

2023-05-25

KNOWN ISSUE

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

4.14.3.0

2023-05-25

KNOWN ISSUE

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

4.14.3.0

2023-05-25

KNOWN ISSUE

4.14.2.0

2023-05-12

ADDED

MapView: Improved the visualization and the hierarchy of city labels for the preconfigured map styles.

4.14.2.0

2023-05-12

ADDED

MapView: Added more mountain range labels for all preconfigured MapScheme styles.

4.14.2.0

2023-05-12

KNOWN ISSUE

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

4.14.2.0

2023-05-12

KNOWN ISSUE

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

4.14.2.0

2023-05-12

KNOWN ISSUE

4.14.1.0

2023-05-09

ADDED

Custom catalogs: Added AuthenticationMode in SDKOptions. This feature is useful when customEngineBaseUrls are used to self-host backend services. Use AuthenticationMode.withToken(accessToken: String) to set a custom bearer token as string. If AuthenticationMode.withExternal() is called, the authentication must be done fully by the client. With AuthenticationMode.withKeySecret(accessKeyId: String, accessKeySecret: String) you bring back the default behavior, where for each online request a bearer token is set in the header of a request - consisting of the provided credentials. Usually, this is done by the HERE SDK internally. Note: This is a beta release of this feature.

4.14.1.0

2023-05-09

ADDED

MapView: Improved map design by adding public transit access icons as embedded carto POIs based on the General Transit Feed Specification (GTFS). Entrances to transit stations are indicated with a small entrance symbol. These icons are clustered, based on the zoom level, together with the transit station icons we added in our last release. Note that this map feature requires OCM version 79 or higher.

4.14.1.0

2023-05-09

CHANGED

Removed deprecated geo fields and constructors of sdk.search.TextQuery and sdk.search.CategoryQuery. Use newly added constructors taking sdk.search.TextQuery.Area and sdk.search.CategoryQuery.Area instead.

4.14.1.0

2023-05-09

CHANGED

Removed deprecated CategoryQuery.withExcludeCategories. Please set excludeCategories directly using categoryQueryObject.excludeCategories.

4.14.1.0

2023-05-09

FIXED

MapView: Improved visualization and names for traffic styles.

4.14.1.0

2023-05-09

CHANGED

SDKNativeEngine: Changed ProxySettings.port type from UInt32 to UInt16.

4.14.1.0

2023-05-09

KNOWN ISSUE

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

4.14.1.0

2023-05-09

KNOWN ISSUE

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

4.14.1.0

2023-05-09

KNOWN ISSUE

4.14.0.0

2023-05-03

FIXED

Outlines for MapPolyline lines no longer show a minimal gap at certain zoom levels.

4.14.0.0

2023-05-03

CHANGED

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

4.14.0.0

2023-05-03

ADDED

RoutingEngine: RoadFeatures.uTurns are now supported for cars, taxis and buses and can be avoided.

4.14.0.0

2023-05-03

CHANGED

Removed deprecated method MapView.pickMapFeatures and class PickMapFeaturesResult. Use MapView.pickMapContent and PickMapContentResult instead.

4.14.0.0

2023-05-03

FIXED

When MapFeatures.vehicleRestrictions is activated, the map view will no longer show an icon for truck speed limits - also the related purple line is no longer shown.

4.14.0.0

2023-05-03

CHANGED

Search: Removed deprecated accomodation, accomodationHotelMotel and accomodationLodging constants from PlaceCategory. accommodation, accommodationHotelMotel and accommodationLodging should be used instead.

4.14.0.0

2023-05-03

CHANGED

Routing: Removed deprecated Section.trafficSpeeds property. Use instead the Span.trafficSpeed property. Removed deprecated TrafficSpeed.offset. Use instead the Span.sectionPolylineOffset property.

4.14.0.0

2023-05-03

CHANGED

Removed the previously deprecated mapView.setWatermarkPosition() method. Use instead mapView.setWatermarkLocation().

4.14.0.0

2023-05-03

FIXED

RoutingEngine: Fixed a RoutingError that happens for the Slovenian language definition when calling importRoute().

4.14.0.0

2023-05-03

ADDED

MapPolygon: Added outlineColor and outlineWidth properties to enable polygon outlines.

4.14.0.0

2023-05-03

ADDED

MapView: Improved the map design by adding public transit embedded carto POIs based on the General Transit Feed Specification (GTFS). The icons are automatically clustered based on the zoom level. Note that this map feature requires OCM version 78 or higher.

4.14.0.0

2023-05-03

ADDED

MapView: Improved the map design with an updated style for unpaved roads. The fill and outline color and the labels of unpaved roads are now styled with a brownish tint.

4.14.0.0

2023-05-03

ADDED

MapView: Improved the map design for deserts with a polygon display. Note that this is only available for OCM based maps.

4.14.0.0

2023-05-03

KNOWN ISSUE

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

4.14.0.0

2023-05-03

KNOWN ISSUE

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

4.14.0.0

2023-05-03

KNOWN ISSUE

4.13.5.0

2023-03-30

ADDED

Added read-only property signpost to get signpost information. SignpostLabel.direction will replace RoadTexts.towards for getting information about directions.

4.13.5.0

2023-03-30

ADDED

Enhanced information on route restrictions: Added violatedRestrictions: [ViolatedRestriction] property to class SectionNotice. ViolatedRestriction.Details contains, for example, height restrictions or forbidden TruckType values. This feature works online, but is also supported for use with the OfflineRoutingEngine - if supported by your HERE SDK edition. Note: This is a beta release of this feature.

4.13.5.0

2023-03-30

ADDED

Routing: Added Span.countryCode property to obtain a country code per span.

4.13.5.0

2023-03-30

FIXED

ManeuverAction.enterHighwayFromLeft and ManeuverAction.enterHighwayFromRight are now properly generated when RouteOptions.enableEnterHighwayManeuverAction is set.

4.13.5.0

2023-03-30

ADDED

Added LocationIndicator.opacity property to set and get the opacity of a location indicator.

4.13.5.0

2023-03-30

ADDED

Routing: Enhanced RoadTexts accessible from a Maneuver. RoadTexts contains now a list of LocalizedRoadNumbers and a numbersWithDirection field to contain road numbers with direction. The latter replaces the deprecated numbers field.

4.13.5.0

2023-03-30

CHANGED

The numbers field in RoadTexts has been deprecated and will be removed with HERE SDK version 4.16.0. Use the newly introduced numbersWithDirection field instead.

4.13.5.0

2023-03-30

ADDED

This version of the HERE SDK is delivered with map version 73 and map version 67 for the extended Japan map.

4.13.5.0

2023-03-30

ADDED

Added LogControl to filter HERE SDK log messages. This allows to disable HERE SDK related console logs or to set a custom LogAppender to receive only selected log messages from the HERE SDK.

4.13.5.0

2023-03-30

CHANGED

Deprecated setLogAppender() in SDKNativeEngine. Use the newly introduced LogControl API instead. Deprecated Debug and Trace log levels as such messages are not relevant.

4.13.5.0

2023-03-30

ADDED

Routing: Added turnAngleInDegrees (-180 to 180) and roundaboutAngleInDegrees (-360 to 360) to Maneuver class to indicate information on the turn angle for all turn related actions. If not applicable for the maneuver, the value will be nil. roundaboutAngleInDegrees indicates the amount of the roundabout that needs to be traversed - it is positive in right-driving countries and negative in left-driving countries.

4.13.5.0

2023-03-30

KNOWN ISSUE

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

4.13.5.0

2023-03-30

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.13.5.0

2023-03-30

KNOWN ISSUE

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

4.13.5.0

2023-03-30

KNOWN ISSUE

4.13.4.0

2023-03-02

ADDED

MapMarker3D objects can now be picked from the map view: Added PickMapItemsResult.markers3d read-only property that holds the list of picked MapMarker3D instances.

4.13.4.0

2023-03-02

ADDED

Added MapMarker3D.visibilityRanges : [MapMeasureRange] property.

4.13.4.0

2023-03-02

ADDED

Added zoom visibilityRanges property to MapPolyline.

4.13.4.0

2023-03-02

ADDED

Added offlineMode to SDKOptions to initialize the HERE SDK in offline mode. This complements the existing global offline switch via the shared instance of the SDKNativeEngine to switch at runtime.

4.13.4.0

2023-03-02

ADDED

This version of the HERE SDK is delivered with map data v71 for the main (ROW) map catalog and v67 for the extended Japan catalog.

4.13.4.0

2023-03-02

ADDED

Added MapMarker.visibilityRanges : [MapMeasureRange] property.

4.13.4.0

2023-03-02

ADDED

Added SDKNativeEngine.proxySettings property to get/set the ProxySettings that will be used by the HERE SDK for all network requests. By setting a proxy server, you can specify, for example, the IP address and port number of your proxy. By default, no proxy is set. Note: This is a beta release of this feature.

4.13.4.0

2023-03-02

FIXED

MapView: Fixed handling of MapFeatures when an invalid MapFeatureModes value has been set. Now features with an invalid mode are silently ignored.

4.13.4.0

2023-03-02

KNOWN ISSUE

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

4.13.4.0

2023-03-02

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.13.4.0

2023-03-02

KNOWN ISSUE

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

4.13.4.0

2023-03-02

KNOWN ISSUE

4.13.3.0

2023-02-17

FIXED

MapScene.Layers.trafficFlow and MapScene.Layers.trafficIncidents are now visible on the map. This was a license issue which affected all Navigate and Explore Edition users.

4.13.3.0

2023-02-17

ADDED

Added designated constructor to MapView: MapView.init(frame: CGRect, withSdkEngine: SDKNativeEngine, withOptions: MapViewOptions?).

4.13.3.0

2023-02-17

FIXED

Polylines are now pickable independent of alpha color values: MapViewBase.pickMapItems() now can pick MapPolyline items with fillColor.alpha = 0.

4.13.3.0

2023-02-17

ADDED

Added property to control the visibility of a MapPolygon dependent on a given zoom range: Added MapPolygon.visibilityRanges: [MapMeasureRange] property.

4.13.3.0

2023-02-17

ADDED

Added opacity factor which specifies the translucency of a MapMarker3D. The factor is applied to the alpha channel of the resulting texture of the marker: Added opacity and renderInternalsEnabled properties. The renderInternalsEnabled flag indicates whether to render the internal geometry of a 3D map marker occluded by its front facing polygons.

4.13.3.0

2023-02-17

CHANGED

Bitcode optimization has been deprecated by Apple. Consequently, as of now the HERE SDK no longer supports bitcode optimization and apps can no longer be built with bitcode. For older projects it may be required to explicitely disable bitcode - especially, when you build your app for release and you see in the logs that -embed-bitcode is executed. In that case, add ENABLE_BITCODE = NO; to your debug / release Xcode build settings.

4.13.3.0

2023-02-17

ADDED

Debug symbols are now included in the heresdk.xcframework for iOS: Look for the dSYM files that are added for each device architecture. For iOS apps that are deployed to App Store or via TestFlight you can find in Apple's Connect Portal the crash reports: Instead of downloading the crash report click on Open in Xcode and you should see the symbolicated stack trace using the dSYM files. This should also work with Firebase Crashlytics and related solutions. Keep in mind, that the heresdk.xcframework is a fat binary and that its file size is optimized by Xcode at deployment time. More details you can find in the Key Concepts guide.

4.13.3.0

2023-02-17

ADDED

This version of the HERE SDK is shipped with map data version 69 (OCM).

4.13.3.0

2023-02-17

ADDED

Added property to control the visibility of a MapMarker3D dependent on a given zoom range: Added MapMarker3D.visibilityRanges: [MapMeasureRange] property.

4.13.3.0

2023-02-17

KNOWN ISSUE

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

4.13.3.0

2023-02-17

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.13.3.0

2023-02-17

KNOWN ISSUE

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

4.13.3.0

2023-02-17

KNOWN ISSUE

4.13.2.0

2023-02-06

FIXED

MapView.pause() and MapView.resume() are now called internally, when an application switches between background and foreground and thus, they no longer need to be called in applicationWillResignActive(_ application:) and applicationDidBecomeActive(_ application:), unless an application calls MapView.pause() and MapView.resume() on it's own, for example, when pausing inactive map views that are shown on different tabs, or when hiding an invisible map for a list of scrollable map views. In such cases, it is now recommended to call MapView.pause() and MapView.resume() in applicationDidEnterBackground(_ application:) and applicationWillEnterForeground(_ application:) instead of applicationWillResignActive(_ application:) and applicationDidBecomeActive(_ application:). Look at the Get Started guide for more details.

4.13.2.0

2023-02-06

ADDED

The HERE watermark can now be freely positioned on the map view: Added mapView.setWatermarkLocation(anchor: Anchor2D, offset: Point2D) and added the read-only property watermarkSize to MapView class.

4.13.2.0

2023-02-06

CHANGED

Deprecated MapView.setWatermarkPlacement(_ placement: WatermarkPlacement, bottomMargin: Int32). Use the new APIs instead.

4.13.2.0

2023-02-06

ADDED

Detailed map for Japan: Improved the visibility of labels by reducing duplicated labels for POIs and landuse labels.

4.13.2.0

2023-02-06

ADDED

Applied several map style improvements (no API changes involved): Updated the road shield icon for Turkey & Jamaica. Adjusted the visibility of public transport POIs and subway and tram lines in Japan. Improved visibility of intersections and traffic lights in Japan. Added dedicated traffic incident marker for type 'lane-restriction'. Visualized land parcels in Victoria, Australia (applies only to Navigate Edition). Added map data attribute 'National Importance' for priority and visibility settings of POIs (applies only to Explore Edition). Note that these changes have been already applied for HERE SDK 4.13.1.0.

4.13.2.0

2023-02-06

CHANGED

Deprecated FERRY from ManeuverAction enum. It was never used.

4.13.2.0

2023-02-06

ADDED

Route calculation: Added more error codes to RoutingError to provide more detailed failure reasons.

4.13.2.0

2023-02-06

ADDED

Added hasShower attribute in TruckAmenities struct and changed showerCount attribute to optional.

4.13.2.0

2023-02-06

FIXED

Map view: pickMapItems() now also picks MapPolygons with fillColor.alpha = 0.

4.13.2.0

2023-02-06

KNOWN ISSUE

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

4.13.2.0

2023-02-06

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.13.2.0

2023-02-06

KNOWN ISSUE

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

4.13.2.0

2023-02-06

KNOWN ISSUE

By default, MapScene.Layers.trafficFlow and MapScene.Layers.trafficIncidents are no longer visible on the map. This is a license issue which affects all Navigate and Explore Edition users. Please contact us and ask for a HERE SDK license update to get traffic flow data. Your credentials will then be enabled to get access. Explore users can go directly to developer.here.com (instead of the HERE platform self-serve portal) as only the self-serve portal is affected.

4.13.2.0

2023-02-06

KNOWN ISSUE

4.13.1.0

2023-01-25

ADDED

Added optional billingTag field to SDKOptions to track your HERE platform usage across the various HERE services your application may contact. For more information on the billing tag, see our cost management guide. The tag needs to follow the format as described in the guide or it will be ignored. The parameter defaults to nil, which also means that the tag is ignored for all requests. Note: The billing tag is optional, but when set, it can help you to understand how often your app uses certain services, for example, the number of hits to our HERE backend routing services. For more details on tracking such details, please consult the cost management guide or get in touch with the HERE billing team.

4.13.1.0

2023-01-25

ADDED

Added businessAndServicesEvChargingStation enum value to PlaceCategory to allow searching for EV charging stations via a CategoryQuery.

4.13.1.0

2023-01-25

ADDED

Added MapMarkerCluster.opacity property to set and get the opacity of the cluster image.

4.13.1.0

2023-01-25

KNOWN ISSUE

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

4.13.1.0

2023-01-25

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.13.1.0

2023-01-25

KNOWN ISSUE

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

4.13.1.0

2023-01-25

KNOWN ISSUE

4.13.1.0

2023-01-25

KNOWN ISSUE

4.13.0.0

2022-12-13

CHANGED

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

4.13.0.0

2022-12-13

CHANGED

Removed previously deprecated enum sdk.routing.HazardousGood. Please use sdk.transport.HazardousMaterialinstead. Removed previously deprecated variable sdk.routing.TruckOptions.hazardousGoods. Please use sdk.routing.TruckOptions.hazardousMaterialsinstead.
Removed previously deprecated variable sdk.routing.EVTruckOptions.hazardousGoods. Please use sdk.routing.EVTruckOptions.hazardousMaterialsinstead.

4.13.0.0

2022-12-13

CHANGED

Removed previously deprecated sdk.routing.TruckOptions.tunnelCategory. Please use sdk.routing.TruckOptions.linkTunnelCategoryinstead. Removed previously deprecated sdk.routing.EVTruckOptions.tunnelCategory. Please use sdk.routing.EVTruckOptions.linkTunnelCategoryinstead.

4.13.0.0

2022-12-13

CHANGED

Removed MapCameraUpdateFactory.setPrincipalPointOffset(_ principalPointOffset: Point2D) method. Use MapCameraUpdateFactory.normalizedPrincipalPoint instead.

4.13.0.0

2022-12-13

CHANGED

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

4.13.0.0

2022-12-13

FIXED

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

4.13.0.0

2022-12-13

ADDED

Added global offline switch to make the HERE SDK radio-silent. This offline mode prevents the HERE SDK from initiating any online connection. sdkNativeEngine.isOfflineMode() method added to enable/disable this functionality. Note that this setting is not persisted. This is a beta release of this feature.

4.13.0.0

2022-12-13

CHANGED

Removed deprecated enum entries of MapError: duplicateLayer, invalidDataSource, invalidContent, unknownLayer, unknown.

4.13.0.0

2022-12-13

CHANGED

Removed deprecated and unsupported method RasterDataSource.changeConfiguration(_ configFile: String).

4.13.0.0

2022-12-13

CHANGED

Removed deprecated MapCamera.cancelAnimation() method. Use MapCamera.cancelAnimations() instead.

4.13.0.0

2022-12-13

CHANGED

Removed deprecated methods MapCameraLimits.setMinTilt and MapCameraLimits.setMinTilt, use MapCameraLimits.tiltRange instead. Removed deprecated methods MapCameraLimits.setMinZoomLevel and MapCameraLimits.setMaxZoomLevel, use MapCameraLimits.zoomRange instead. Removed enum 'MapCameraLimits.ErrorCode' and exception MapCameraLimitsException.MapCameraLimitsException which have become obsolete.

4.13.0.0

2022-12-13

ADDED

Added methods MapScene.addMapImageOverlay(_ MapImageOverlay) and MapScene.removeMapImageOverlay(_ MapImageOverlay).

4.13.0.0

2022-12-13

ADDED

Added class MapImageOverlay that allows to show icons on top of the map view that do not move, scale or tilt together with the map. You can use this to show, for example, informative icons on a map view or a map surface view for in-car use.

4.13.0.0

2022-12-13

CHANGED

Removed the previously deprecated SearchOptions constructor. Use default constructor instead.

4.13.0.0

2022-12-13

CHANGED

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

4.13.0.0

2022-12-13

CHANGED

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

4.13.0.0

2022-12-13

CHANGED

Remove deprecated 'sdk.routing.Route.polyline'. Use 'sdk.routing.Route.geometry' instead. Remove deprecated 'sdk.routing.Section.polyline'. Use 'sdk.routing.Section.geometry' instead.

4.13.0.0

2022-12-13

ADDED

You can now overwrite the base speeds on a Route per segment. After route calculation, you can use the segment reference IDs to set new values per route span and then calculate a new route with the updated values: Added collection of MaxSpeedOnSegment instances to all motor-vehicle based route calculation options (BusOptions, CarOptions, EVCarOptions, EVTruckOptions, ScooterOptions, TaxiOptions, and TruckOptions) to set restrictions for segments which affects route calculation and the ETA. For the SegmentReference parameter, beside the segmentId, the travelDirection can be optionally set, other values are ignored. Note that this feature is not available for offline use.

4.13.0.0

2022-12-13

ADDED

Add segmentHint and onRoadThreshold properties to Waypoint struct to improve waypoint matching.

4.13.0.0

2022-12-13

ADDED

Adding support for transparent MapMarker items: Added MapMarker.opacity property to set and get opacity of the map markers.

4.13.0.0

2022-12-13

ADDED

This version of the HERE SDK is delivered with map data version 60.

4.13.0.0

2022-12-13

CHANGED

Removed deprecated Location.timestamp_since_boot_in_milliseconds. Use Location.timestamp_since_boot instead.

4.13.0.0

2022-12-13

CHANGED

Removed deprecated AuthenticationData.expiry_time_in_seconds. Use AuthenticationData.expiry_time instead.

4.13.0.0

2022-12-13

CHANGED

Removed the previously deprecated Maneuver.durationInSeconds. Use instead Maneuver.duration.

4.13.0.0

2022-12-13

CHANGED

Removed the previously deprecated PostAction.durationInSeconds. Use instead PostAction.duration.

4.13.0.0

2022-12-13

CHANGED

Removed the previously deprecated PreAction.durationInSeconds. Use instead PreAction.duration.

4.13.0.0

2022-12-13

CHANGED

Removed the previously deprecated Route.durationInSeconds. Use instead Route.duration.

4.13.0.0

2022-12-13

CHANGED

Removed the previously deprecated Section.durationInSeconds. Use instead Section.duration.

4.13.0.0

2022-12-13

CHANGED

Removed the previously deprecated Span.durationInSeconds. Use instead Span.duration.

4.13.0.0

2022-12-13

CHANGED

Removed the previously deprecated TransitStop.durationInSeconds. Use instead TransitStop.duration.

4.13.0.0

2022-12-13

CHANGED

Removed the previously deprecated Waypoint.durationInSeconds. Use instead Waypoint.duration.

4.13.0.0

2022-12-13

CHANGED

Removed the previously deprecated Route.trafficDelayInSeconds. Use instead Route.trafficDelay.

4.13.0.0

2022-12-13

CHANGED

Removed the previously deprecated Section.trafficDelayInSeconds. Use instead Section.trafficDelay.

4.13.0.0

2022-12-13

CHANGED

Removed the previously deprecated BatterySpecifications.chargingSetupDurationInSeconds. Use instead BatterySpecifications.chargingDetupDuration.

4.13.0.0

2022-12-13

CHANGED

Removed the previously deprecated FarePrice.validityPeriodInSeconds. Use instead FarePrice.validityPeriod.

4.13.0.0

2022-12-13

ADDED

Added MapViewBase.isValid property to check the validity of the corresponding MapView instance. This will return false, when the instance is in an invalid state because it was, for example, destroyed.

4.13.0.0

2022-12-13

KNOWN ISSUE

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

4.13.0.0

2022-12-13

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.13.0.0

2022-12-13

KNOWN ISSUE

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

4.13.0.0

2022-12-13

KNOWN ISSUE

The jamFactor indicating TrafficSpeed is currently calculated linear without taking road types and other parameters into account.

4.13.0.0

2022-12-13

KNOWN ISSUE

4.13.0.0

2022-12-13

KNOWN ISSUE

4.12.10.0

2022-11-10

ADDED

This version of the HERE SDK is delivered with map data version 57.

4.12.10.0

2022-11-10

KNOWN ISSUE

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

4.12.10.0

2022-11-10

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.12.10.0

2022-11-10

KNOWN ISSUE

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

4.12.10.0

2022-11-10

KNOWN ISSUE

The jamFactor indicating TrafficSpeed is currently calculated linear without taking road types and other parameters into account.

4.12.10.0

2022-11-10

KNOWN ISSUE

4.12.9.0

2022-10-27

ADDED

MapMarker clusters: The beta status for MapMarkerCluster.ImageStyle, MapMarkerCluster.CounterStyle and the related MapMarkerCluster constructor has been removed: The feature has become stable.

4.12.9.0

2022-10-27

CHANGED

MapPolyline: Removed the beta feature AlphaBlendType enum and the related property.

4.12.9.0

2022-10-27

ADDED

Added bulk operation support for MapPolylines: Multiple lines can now be added / removed with addMapPolylines(_ mapPolylines: [MapPolyline]) and removeMapPolylines(_ mapPolylines: [MapPolyline]).

4.12.9.0

2022-10-27

CHANGED

MapCamera: When setting GeoCoordinates for any camera operation such as lookAt() or flyTo(), then the altitude value will be ignored starting with release of HERE SDK 4.15.0 - for now, the value has been deprecated.

4.12.9.0

2022-10-27

ADDED

SDKOptions.customEngineBaseUrls: Added support for configurable URLs with the new enum value EngineBaseURL.authentication that can be used to specify custom URLs for authentication instead of the default URLs. Example URL (do not add endpoints): "https://account.api.yourcompany.com".

4.12.9.0

2022-10-27

ADDED

SDKOptions.customEngineBaseUrls: Added support for configurable endpoints with the new enum value EngineBaseURL.DS_PROXY that can be used to specify custom endpoints to set a DS Proxy instead of the default endpoints. Example URL (with added endpoints): "https://data.api.platform.yourcompany.com/direct/v1/test".

4.12.9.0

2022-10-27

ADDED

Added VehicleProfile class to define the properties of a vehicle. In the future, this profile is planned to be used for routing. Right now, the profile is only relevant for users of the Navigate Edition.

4.12.9.0

2022-10-27

KNOWN ISSUE

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

4.12.9.0

2022-10-27

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.12.9.0

2022-10-27

KNOWN ISSUE

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

4.12.9.0

2022-10-27

KNOWN ISSUE

The jamFactor indicating TrafficSpeed is currently calculated linear without taking road types and other parameters into account.

4.12.9.0

2022-10-27

KNOWN ISSUE

4.12.8.0

2022-10-14

ADDED

Added animation support for MapPolyline instances. Now, they can be moved and the progress can be animated (for example, to animate a route-eat-up progress) - added MapPolylineAnimation class to represent an animation that can be applied to a MapPolyline object. Added static startAnimation(_ animation: MapPolylineAnimation, animationDelegate listener: AnimationDelegate) to MapPolyline to start an animation. Added cancelAnimation(_ animation: MapPolylineAnimation) to MapPolyline to cancel an animation. Added polylineProgress(keyframes: [ScalarKeyframe], easingFunction: EasingFunction, interpolationMode: KeyframeInterpolationMode) -> MapItemKeyFrameTrack to create a keyframe track for the progress property of a 'MapPolyline'.

4.12.8.0

2022-10-14

CHANGED

The minimum supported Xcode version was raised from Xcode 12.4 to Xcode 13.2.1. The minimum supported Mac OS version was raised from Catalina to Big Sur. Lower versions may still work, but are no longer guaranteed to work. Note that the minimum supported iOS version stays on 12.4. Effectively, this change was already introduced with HERE SDK 4.12.7.0.

4.12.8.0

2022-10-14

KNOWN ISSUE

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

4.12.8.0

2022-10-14

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.12.8.0

2022-10-14

KNOWN ISSUE

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

4.12.8.0

2022-10-14

KNOWN ISSUE

The jamFactor indicating TrafficSpeed is currently calculated linear without taking road types and other parameters into account.

4.12.8.0

2022-10-14

KNOWN ISSUE

4.12.7.0

2022-09-29

FIXED

When using Xcode 13 or higher you no longer get a warning that certain files in heresdk.swiftmodule are either malformed or generated by a different Swift version. The HERE SDK is now compiled with Xcode 13.2.1.

4.12.7.0

2022-09-29

ADDED

Added MapPolyline.progressOutlineColor property to style the outline of the progress part of a polyline.

4.12.7.0

2022-09-29

ADDED

SearchEngine: Added connectorTypeId to EVChargingStation. More information on the IDs and the corresponding type can be found here.

4.12.7.0

2022-09-29

ADDED

Added MapView.secondaryLanguage property to set and get a secondary map language to support places that can show dual labels. If the text for primary and secondary language is the same, then only the primary language will be shown. If a requested language is not supported, then the local language is used. For example, some cities in India show a dual label with Latin (English) & Hindi text - at the same time.

4.12.7.0

2022-09-29

ADDED

This version of the HERE SDK is delivered with map data version 54.

4.12.7.0

2022-09-29

ADDED

Added support for custom map data: Added CatalogConfiguration, which can be used to access default catalogs on the HERE platform, as well as custom catalogs such as for self-hosted or BYOD (bring your own data) use cases. Added DesiredCatalog, which provides an interface to identify a catalog on the HERE platform. A developer can specify the HERE Resource Name (HRN) for the catalog along with a CatalogVersionHint for the desired version. A custom CatalogConfiguration needs to be specified via SDKOptions before initializing the HERE SDK. 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.12.7.0

2022-09-29

FIXED

MapPolyline instances no longer interprete an alpha color setting of 0.0 as fully opaque.

4.12.7.0

2022-09-29

KNOWN ISSUE

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

4.12.7.0

2022-09-29

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.12.7.0

2022-09-29

KNOWN ISSUE

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

4.12.7.0

2022-09-29

KNOWN ISSUE

The jamFactor indicating TrafficSpeed is currently calculated linear without taking road types and other parameters into account.

4.12.7.0

2022-09-29

KNOWN ISSUE

4.12.6.0

2022-09-16

FIXED

RoutingEngine: The importRoute() feature via a list of Locations can be used now as expected.

4.12.6.0

2022-09-16

FIXED

MapPolyline instances no longer ignore alpha color settings.

4.12.6.0

2022-09-16

ADDED

Search: Added CategoryQuery.fuelTypes and TextQuery.fuelTypes, which can be used to filter FuelStation results based on available fuel types. Added also TextQuery.truckFuelTypes and CategoryQuery.truckFuelTypes, which can be used to filter FuelStation results based on available truck fuel types.

4.12.6.0

2022-09-16

ADDED

Added CategoryQuery.truckClass and TextQuery.truckClass, which can be used to filter FuelStation results with the minimum supported TruckClass. This filter is only available for use with the SearchEngine. The OfflineSearchEngine (not available for all editions) ignores this filter.

4.12.6.0

2022-09-16

CHANGED

Deprecated MapFeatureModes.trafficFlowRegionSpecific, it will be removed in version 4.15.0. Use the newly introduced MapFeatureModes.trafficFlowJapanWithoutFreeFlow instead, if you are using the rich map for Japan. This is the adapted mode for Japan based on trafficFlowWithoutFreeFlow to exclude green lines for no traffic.

4.12.6.0

2022-09-16

ADDED

Added AlphaBlendType enum and the property MapPolyline.alphaBlendType: AlphaBlendType. The AlphaBlendType specifies how translucent MapPolyline instances are rendered on top of each other. The default type is OVERWRITE. Note that this is a beta release of this feature.

4.12.6.0

2022-09-16

ADDED

Added RoutePlace.sideOfDestination to identify the side of a street where the destination waypoint resides.

4.12.6.0

2022-09-16

ADDED

Added MapPolyline.progress and MapPolyline.progressColor properties to style two parts of a polyline with different colors.

4.12.6.0

2022-09-16

CHANGED

Deprecated SDKInitializer and related functionality, it will be removed with HERE SDK 4.15.0. Use SDKNativeEngine.makeSharedInstance() instead.

4.12.6.0

2022-09-16

ADDED

Map style update: Optimized the map view representation for MapScheme.hybridDay and MapScheme.hybridNight: The day and night schemes have been unified and the readability has been improved.

4.12.6.0

2022-09-16

KNOWN ISSUE

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

4.12.6.0

2022-09-16

KNOWN ISSUE

When using Xcode 13 or higher you may get a warning that certain files in heresdk.swiftmodule are either malformed or generated by a different Swift version. It is safe to ignore this warning. The reason for this warning is that the HERE SDK is compiled with Xcode 12.4.

4.12.6.0

2022-09-16

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.12.6.0

2022-09-16

KNOWN ISSUE

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

4.12.6.0

2022-09-16

KNOWN ISSUE

The jamFactor indicating TrafficSpeed is currently calculated linear without taking road types and other parameters into account.

4.12.6.0

2022-09-16

KNOWN ISSUE

MapPolyline instances interprete an alpha color setting of 0.0 as fully opaque. As a workaround, set an alpha value of 0.01 to make the polyline translucent. Non-zero alpha values work as expected.

4.12.6.0

2022-09-16

KNOWN ISSUE

4.12.5.0

2022-09-01

ADDED

Optimized the map view representation for extruded buildings and building footprints across zoom levels.

4.12.5.0

2022-09-01

ADDED

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

4.12.5.0

2022-09-01

ADDED

All map view features now have a named default mode. Constants for those were added to MapFeatureModes: buildingFootprintsAll, extrudedBuildingsAll, environmentalZonesAll, trafficIncidentsAll, safetyCamerasAll (only available for the Navigate Edition).

4.12.5.0

2022-09-01

ADDED

Added MapFeatures.congestionZones and MapFeatureModes.congestionZonesAll.

4.12.5.0

2022-09-01

ADDED

Added MapFeatures.environmentalZones and MapFeatureModes.environmentalZonesAll.

4.12.5.0

2022-09-01

KNOWN ISSUE

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

4.12.5.0

2022-09-01

KNOWN ISSUE

4.12.5.0

2022-09-01

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.12.5.0

2022-09-01

KNOWN ISSUE

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

4.12.5.0

2022-09-01

KNOWN ISSUE

The jamFactor indicating TrafficSpeed is currently calculated linear without taking road types and other parameters into account.

4.12.5.0

2022-09-01

KNOWN ISSUE

RoutingEngine: The importRoute() feature via a list of Locations cannot be used yet commercially and requires custom access credentials. Please contact your sales representative to get access.

4.12.5.0

2022-09-01

KNOWN ISSUE

MapPolyline instances ignore alpha color settings and will appear fully opaque.

4.12.5.0

2022-09-01

KNOWN ISSUE

By default, MapScene.Layers.trafficFlow is no longer visible on the map. This is a license issue which affects all Navigate and Explore Edition users. Please contact us and ask for a HERE SDK license update to get traffic flow data. Your credentials will then be enabled to get access. Explore users can go directly to developer.here.com (instead of the HERE platform self-serve portal) as only the self-serve portal is affected.

4.12.4.0

2022-08-19

ADDED

Added AreaType enum which represents the type of an area such as country, state or district. Added property Place.areaType which gets the area type for the respective Place.

4.12.4.0

2022-08-19

FIXED

Increased size limit from 10000 to 50000 for routingEngine.importRoute() when setting a list of Location points.

4.12.4.0

2022-08-19

ADDED

Added EVChargingStation.hasFixedCable field to know if a charging station for electric vehicles supports fixed cables.

4.12.4.0

2022-08-19

FIXED

RoutingEngine: Fixed missing toll information for bus or taxi online routes.

4.12.4.0

2022-08-19

ADDED

Added enterHighwayFromLeft and enterHighwayFromRight values to ManeuverAction enum. They indicate the maneuver action for a driver to perfom on entering a highway either from the left or right side. These enum values are only generated when setting the enableEnterHighwayManeuverAction flag in RouteOptions to true. By default, the flag is set to false. With HERE SDK 4.14.0 we plan to set it to true, by default.

4.12.4.0

2022-08-19

FIXED

RoutingEngine: Improved the time to calculate Route results for very large routes.

4.12.4.0

2022-08-19

KNOWN ISSUE

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

4.12.4.0

2022-08-19

KNOWN ISSUE

4.12.4.0

2022-08-19

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.12.4.0

2022-08-19

KNOWN ISSUE

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

4.12.4.0

2022-08-19

KNOWN ISSUE

The jamFactor indicating TrafficSpeed is currently calculated linear without taking road types and other parameters into account.

4.12.4.0

2022-08-19

KNOWN ISSUE

RoutingEngine: The importRoute() feature via a list of Locations cannot be used yet commercially and requires custom access credentials. Please contact your sales representative to get access.

4.12.4.0

2022-08-19

KNOWN ISSUE

MapPolyline instances ignore alpha color settings and will appear fully opaque.

4.12.4.0

2022-08-19

KNOWN ISSUE

4.12.3.0

2022-08-05

ADDED

The properties for EVChargingPoolDetails and EVChargingStation have been extended. Such information is available when using the online SearchEngine and the OfflineSearchEngine (for users of the Navigate Edition).

4.12.3.0

2022-08-05

ADDED

Introduced a new MapMarkerCluster.CounterStyle that indicates the number of contained MapMarker items in a cluster. The style allows various options to customize how this will be rendered on top of a cluster image. A new MapMarkerCluster() constructer has been added to set the style. In addition, an Anchor2D can be used to position the counter and the cluster image. An usage example can be found in the MapItems example app. Note that this is a beta release of this feature.

4.12.3.0

2022-08-05

ADDED

SearchEngine: Added TruckAmenities to the Details of a Place to inform on amenities such as truck wash or the number of available showers. Currently, this is supported only for online search. For now, this can be enabled by calling searchEngine.setCustomOption() with "show" as name and "truck" as value. This is a beta release of this feature.

4.12.3.0

2022-08-05

CHANGED

Deprecated TextQuery.includeChains and TextQuery.excludeChains. Please use CategoryQuery.includeChains and CategoryQuery.excludeChains instead.

4.12.3.0

2022-08-05

ADDED

Added CategoryQuery.includeChains and CategoryQuery.excludeChains that support search filtering by chains.

4.12.3.0

2022-08-05

CHANGED

Search for EV charging stations: Moved and renamed Place.Details.EVChargingStationAttributes to Place.Details.EVChargingPool.EVChargingPoolDetails.

4.12.3.0

2022-08-05

CHANGED

MapFeatureModes.trafficFlowRegionSpecific is only rendered for credentials that enable detailed map data for Japan. By default, use MapFeatureModes.trafficFlowWithFreeFlow instead.

4.12.3.0

2022-08-05

FIXED

Fixed an issue with MapView gestures inside a UIScrollView: The issue occurred when a MapView is placed inside a UIScrollView (directly or indirectly) which may prevent scrolling if a user interacts with the map while map gestures are allowed to work.

4.12.3.0

2022-08-05

KNOWN ISSUE

The newly introduced TruckAmenities feature is not highlighted as a beta API in the API Reference.

4.12.3.0

2022-08-05

KNOWN ISSUE

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

4.12.3.0

2022-08-05

KNOWN ISSUE

4.12.3.0

2022-08-05

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.12.3.0

2022-08-05

KNOWN ISSUE

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

4.12.3.0

2022-08-05

KNOWN ISSUE

The jamFactor indicating TrafficSpeed is currently calculated linear without taking road types and other parameters into account.

4.12.3.0

2022-08-05

KNOWN ISSUE

RoutingEngine: The route import feature via a list of Locations cannot be used yet commercially and requires custom access credentials. Please contact your sales representative to get access.

4.12.3.0

2022-08-05

KNOWN ISSUE

MapPolyline instances ignore alpha color settings and will appear fully opaque.

4.12.3.0

2022-08-05

KNOWN ISSUE

4.12.2.0

2022-07-21

FIXED

SearchEngine: Corrected the allowed range of SearchOptions.maxItems to [1, 100]. When not set, results will be limited to 20, by default. This applies also to auto suggestion results.

4.12.2.0

2022-07-21

ADDED

Search Details now contain EVChargingStationAttributes - if applicable for a Place.

4.12.2.0

2022-07-21

CHANGED

Removed connectorTypeId from the search type EVChargingStation. The API is still in beta state.

4.12.2.0

2022-07-21

KNOWN ISSUE

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

4.12.2.0

2022-07-21

KNOWN ISSUE

4.12.2.0

2022-07-21

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.12.2.0

2022-07-21

KNOWN ISSUE

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

4.12.2.0

2022-07-21

KNOWN ISSUE

The jamFactor indicating TrafficSpeed is currently calculated linear without taking road types and other parameters into account.

4.12.2.0

2022-07-21

KNOWN ISSUE

RoutingEngine: The route import feature via a list of Locations cannot be used yet commercially and requires custom access credentials. Please contact your sales representative to get access.

4.12.2.0

2022-07-21

KNOWN ISSUE

MapPolyline instances ignore alpha color settings and will appear fully opaque.

4.12.2.0

2022-07-21

KNOWN ISSUE

4.12.1.0

2022-07-11

ADDED

Replaced MapScene.Layers with a more flexible solution: All map layers can now be enabled or disabled as MapFeatures specifying one ore more MapFeatureModes. Pass a map of key / value pairs to the new MapScene method enableFeatures(_ features: [String: String]) -> Void. Hide a layer via disableFeatures(_ features: [String]) -> Void. Query supported map features via getSupportedFeatures() -> [String: [String]] and check currently active map features with getActiveFeatures() -> [String: String]. Note that this is a beta release of this feature.

4.12.1.0

2022-07-11

CHANGED

Online RoutingEngine: Deprecated RoadFeatures.DIFFICULT_TURNS. Use instead RoadFeatures.U_TURNS.

4.12.1.0

2022-07-11

ADDED

EV routing: Added PostAction.chargingDetails to get ChargingActionDetails, which supports additional parameters for EV charging such as arrivalChargeInKilowattHours and targetChargeInKilowattHours. The latter indicates the kWh level to which a vehicle's battery should be charged at a stop.

4.12.1.0

2022-07-11

ADDED

Search: Added TextQuery.includeChains and TextQuery.excludeChains that support search filtering by adding a list of PlaceChain items. More information on chain IDs that correlate to specific places such as shops or stores can be found here.

4.12.1.0

2022-07-11

ADDED

Added support for our new web-based unified HERE Style Editor that is available on the HERE platform. With the HERE Style Editor you can create highly customizable map styles. Note that custom map styles that have been made with the legacy desktop editor need to be migrated to the new HERE Style Editor format. Get in touch with your HERE representative to convert your existing styles. The HERE Style Editor is available via self-serve on the HERE platform.

4.12.1.0

2022-07-11

ADDED

Added a simplified way to initialize the HERE SDK manually. Using the default automatic initialization is still possible, but has been deprecated. Added SDKNativeEngine.makeSharedInstance() to safely initialize a shared instance of the SDKNativeEngine. Calling this method also gracefully destroys any previous instance (if any). In order to deactivate auto-init, it is also required to remove credentials from plist and to set them instead via SDKOptions. As a result, the HERE SDK SDK will not be created automatically at startup.

4.12.1.0

2022-07-11

FIXED

The response time to calculate routes with the RoutingEngine has been heavily improved.

4.12.1.0

2022-07-11

CHANGED

Deprecated all constants defined in MapScene.Layers. Instead of using those constants with MapScene.setLayerVisibility(), use the newly introduced MapScene.enableFeatures() and MapScene.disableFeatures() with the constants from MapFeatures and MapFeatureModes. Note that unlike layer visibility state, a map feature state is reset on loadScene().

4.12.1.0

2022-07-11

KNOWN ISSUE

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

4.12.1.0

2022-07-11

KNOWN ISSUE

4.12.1.0

2022-07-11

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.12.1.0

2022-07-11

KNOWN ISSUE

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

4.12.1.0

2022-07-11

KNOWN ISSUE

The jamFactor indicating TrafficSpeed is currently calculated linear without taking road types and other parameters into account.

4.12.1.0

2022-07-11

KNOWN ISSUE

RoutingEngine: The route import feature via a list of Locations cannot be used yet commercially and requires custom access credentials. Please contact your sales representative to get access.

4.12.1.0

2022-07-11

KNOWN ISSUE

MapPolyline instances ignore alpha color settings and will appear fully opaque.

4.12.1.0

2022-07-11

KNOWN ISSUE

4.12.0.0

2022-07-07

CHANGED

Monthly active users (MAU) are no longer counted when the HERE SDK is initialized. Instead, only usage counts, for example, when a MapView is shown, or when any engine like SearchEngine, RoutingEngine or any other engine - including MapDownloader, RoutePrefetcher, Navigator and VisualNavigator (for users of the Navigate Edition) - is instantiated. If credentials are changed at runtime, then usage is counted again.

4.12.0.0

2022-07-07

CHANGED

Deprecated Accomodation, AccomodationHotelMotel and AccomodationLodging constants in PlaceCategory. Use the newly added Accommodation, AccommodationHotelMotel and AccommodationLodging constants instead.

4.12.0.0

2022-07-07

CHANGED

Removed previously deprecated MapScene.setLayerState(layerName: String, newState: MapScene.LayerState). Use MapScene.setLayerVisibility(...﹚ instead. Removed previously deprecated enum MapScene.LayerState, use VisibilityState instead.

4.12.0.0

2022-07-07

ADDED

This version of the HERE SDK is delivered with map data version 45.

4.12.0.0

2022-07-07

CHANGED

The style for MapScheme.normalNight has been updated to improve readability: Increased brightness, saturation and contrast and reduced the number of different color tones.

4.12.0.0

2022-07-07

CHANGED

A new web-based unified HERE Style Editor was made available on the HERE platform. The editor will be available for use with the upcoming release of HERE SDK 4.12.1.0. It is compatible with the Maps API for JavaScript (JSAPI) and the HERE SDK. Custom map styles that have been made with the legacy desktop editor need to be migrated to the new HERE Style Editor format. Get in touch with your HERE representative to discuss potential style updates until then. HERE SDK 4.12.0.0 is the last release that supports the old desktop format.

4.12.0.0

2022-07-07

KNOWN ISSUE

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

4.12.0.0

2022-07-07

KNOWN ISSUE

4.12.0.0

2022-07-07

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.12.0.0

2022-07-07

KNOWN ISSUE

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

4.12.0.0

2022-07-07

KNOWN ISSUE

The jamFactor indicating TrafficSpeed is currently calculated linear without taking road types and other parameters into account.

4.12.0.0

2022-07-07

KNOWN ISSUE

RoutingEngine: The route import feature via a list of Locations cannot be used yet commercially and requires custom access credentials. Please contact your sales representative to get access.

4.12.0.0

2022-07-07

KNOWN ISSUE

MapPolyline instances ignore alpha color settings and will appear fully opaque.

4.12.0.0

2022-07-07

KNOWN ISSUE

4.11.4.0

2022-06-10

ADDED

A Route contains now indexes for traffic incidents: Added getTrafficIncidentIndexes() to Span. The indexes are related to the traffic incidents in the parent Section. This helps to find the exact positions of traffic incidents on a route.

4.11.4.0

2022-06-10

FIXED

A Route created with the RoutingEngine differentiates now between sections for stops and sections created due to a transport mode change: The waypointIndex of the first departure place and the last arrival place are now set according to the waypoints indexes.

4.11.4.0

2022-06-10

CHANGED

The zoom level behavior of the MapCamera has been aligned: Internally, the HERE SDK calculates now a zoom level with a pixel scale as reference instead of ppi. As a result, when the default camera settings are used, the MapView is zoomed in a bit closer than previously.

4.11.4.0

2022-06-10

ADDED

Added setGeoCoordinates() and getGeoCoordinates() to Metadata.

4.11.4.0

2022-06-10

ADDED

EV routing: Added availableConnectorCount to EVChargingStation. It represents the number of available physical connectors at a charging station.

4.11.4.0

2022-06-10

CHANGED

Aligned the return value of PickMapContentResult.TrafficIncidentResult.getOriginalId() to return a String instead of an integer.

4.11.4.0

2022-06-10

ADDED

This version of the HERE SDK is delivered with map data version 44.

4.11.4.0

2022-06-10

KNOWN ISSUE

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

4.11.4.0

2022-06-10

KNOWN ISSUE

4.11.4.0

2022-06-10

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.11.4.0

2022-06-10

KNOWN ISSUE

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

4.11.4.0

2022-06-10

KNOWN ISSUE

The jamFactor indicating TrafficSpeed is currently calculated linear without taking road types and other parameters into account.

4.11.4.0

2022-06-10

KNOWN ISSUE

RoutingEngine: The route import feature via a list of Locations cannot be used yet commercially and requires custom access credentials. Please contact your sales representative to get access.

4.11.4.0

2022-06-10

KNOWN ISSUE

MapPolyline instances ignore alpha color settings and will appear fully opaque.

4.11.4.0

2022-06-10

KNOWN ISSUE

4.11.3.0

2022-05-18

CHANGED

Deprecated MapCamera.lookAt(point: GeoCoordinates, distanceInMeters: Double) and MapCamera.lookAt(point: GeoCoordinates, orientation: GeoOrientationUpdate, distanceInMeters: Double). Use instead the newly added lookAt() methods to set a MapMeasure, which allows now to specify if distance, scale or zoom level should be changed.

4.11.3.0

2022-05-18

ADDED

Added MapCamera.lookAt(point: GeoCoordinates, zoom: MapMeasure) and MapCamera.lookAt(point: GeoCoordinates, orientation: GeoOrientationUpdate, zoom: MapMeasure).

4.11.3.0

2022-05-18

ADDED

Added class PickMapContentResult.TrafficIncidentResult containing all data of a picked traffic incident. Added PickMapContentResult.trafficIncidents property for retrieving picked traffic incidents.

4.11.3.0

2022-05-18

ADDED

This version of the HERE SDK is delivered with map data version 41.

4.11.3.0

2022-05-18

KNOWN ISSUE

MapViewPin instances cannot be removed after tilting and panning the map.

4.11.3.0

2022-05-18

KNOWN ISSUE

4.11.3.0

2022-05-18

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.11.3.0

2022-05-18

KNOWN ISSUE

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

4.11.3.0

2022-05-18

KNOWN ISSUE

The jamFactor indicating TrafficSpeed is currently calculated linear without taking road types and other parameters into account.

4.11.3.0

2022-05-18

KNOWN ISSUE

RoutingEngine: The route import feature via a list of Locations cannot be used yet commercially and requires custom access credentials. Please contact your sales representative to get access.

4.11.3.0

2022-05-18

KNOWN ISSUE

MapPolyline instances ignore alpha color settings and will appear fully opaque.

4.11.3.0

2022-05-18

KNOWN ISSUE

4.11.2.0

2022-04-29

CHANGED

Deprecated MapViewBase.pickMapFeatures(in: Rectangle2D, completion: @escaping (PickMapFeaturesResult?) -> Void), MapView.pickMapFeatures(in: Rectangle2D, completion: @escaping (PickMapFeaturesResult?) -> Void), PickMapFeaturesResult. Use instead the newly introduced MapViewBase.pickMapContent(in: Rectangle2D, completion: @escaping (PickMapContentResult?) -> Void), MapView.pickMapContent(in: Rectangle2D, completion: @escaping (PickMapContentResult?) -> Void), PickMapContentResult.

4.11.2.0

2022-04-29

CHANGED

Deprecated Section.departureTime and Section.arrivalTime properties. Use Section.departureLocationTime and Section.arrivalLocationTime properties instead. Added LocationTime struct which which provides the local time, UTC time and the UTC offset, including DST time variations.

4.11.2.0

2022-04-29

CHANGED

SearchEngine: Deprecated existing constructors of TextQuery and CategoryQuery.
Use newly added constructors taking TextQuery.Area and CategoryQuery.Area instead.

4.11.2.0

2022-04-29

ADDED

Added method setCustomOptions() to RoutingEngine which allows adding custom options to each routing query. Use this feature at your own risk to experiment with Routing API v8 backend features that are not yet supported by the HERE SDK.

4.11.2.0

2022-04-29

FIXED

Fixed failing traffic incident queries for TrafficEngine.

4.11.2.0

2022-04-29

FIXED

Bus routes may not be fully accurate and the TransportMode of such routes is incorrectly changed to car. Fixed value returned by the getSectionTransportMode() method of a Section for bus routes.

4.11.2.0

2022-04-29

KNOWN ISSUE

MapViewPin instances cannot be removed after tilting and panning the map.

4.11.2.0

2022-04-29

KNOWN ISSUE

4.11.2.0

2022-04-29

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.11.2.0

2022-04-29

KNOWN ISSUE

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

4.11.2.0

2022-04-29

KNOWN ISSUE

The jamFactor indicating TrafficSpeed is currently calculated linear without taking road types and other parameters into account.

4.11.2.0

2022-04-29

KNOWN ISSUE

RoutingEngine: The route import feature via a list of Locations cannot be used yet commercially and requires custom access credentials. Please contact your sales representative to get access.

4.11.2.0

2022-04-29

KNOWN ISSUE

MapPolyline instances ignore alpha color settings and will appear fully opaque.

4.11.1.0

2022-04-19

ADDED

Added 'MapImage(imageData: Data, imageFormat: ImageFormat, width: UInt32, height: UInt32)' to set a custom size. It will also accept PNG image data.

4.11.1.0

2022-04-19

FIXED

Fixed: Finding traffic on a route via trafficEngine.queryForIncidents fails unexpectedly for GeoCorridor objects that are much shorter than 500 km.

4.11.1.0

2022-04-19

ADDED

Added a method to MapView to set a HERE watermark margin with mapView.setWatermarkPlacement(_ placement: WatermarkPlacement, bottomMargin: Int32).

4.11.1.0

2022-04-19

CHANGED

Deprecated the method MapView.setWatermarkPosition(placement: WatermarkPlacement, bottomCenterMargin: UInt32). Use the related setWatermarkPlacement() method instead.

4.11.1.0

2022-04-19

FIXED

Dark background issue fixed for MapView when using a webMercator projection.

4.11.1.0

2022-04-19

ADDED

Search: Added Suggestion.id that holds an auto suggest item ID.

4.11.1.0

2022-04-19

CHANGED

Removed the previously deprecated field Location.timestamp. Use the time field instead.

4.11.1.0

2022-04-19

KNOWN ISSUE

MapViewPin instances cannot be removed after tilting and panning the map.

4.11.1.0

2022-04-19

KNOWN ISSUE

When using Xcode 13 you may get a warning that certain files in heresdk.swiftmodule are either malformed or generated by a different Swift version. It is safe to ignore this warning. The reason for this warning is that the HERE SDK is compiled with Xcode 12.4.

4.11.1.0

2022-04-19

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.11.1.0

2022-04-19

KNOWN ISSUE

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

4.11.1.0

2022-04-19

KNOWN ISSUE

The jamFactor indicating TrafficSpeed is currently calculated linear without taking road types and other parameters into account.

4.11.1.0

2022-04-19

KNOWN ISSUE

RoutingEngine: The route import feature via a list of Locations cannot be used yet commercially and requires custom access credentials. Please contact your sales representative to get access.

4.11.1.0

2022-04-19

KNOWN ISSUE

MapPolyline instances ignore alpha color settings and will appear fully opaque.

4.11.1.0

2022-04-19

KNOWN ISSUE

Bus routes may not be fully accurate and the TransportMode of such routes is incorrectly changed to car.

4.11.1.0

2022-04-19

KNOWN ISSUE

MapDownloader: The sizeOnDiskInBytes property of Region and InstalledRegion slightly differs.

4.11.0.0

2022-04-08

ADDED

Added fade animations for MapMarker by setting fadeDuration: TimeInterval. The marker will automatically fade-in when being added to the MapView and fade-out when being removed. By default, this feature is disabled and the fadeDuration property defaults to 0.

4.11.0.0

2022-04-08

ADDED

Added low-level 3D support to programmatically add custom 3D objects on the map. Added MeshBuilder, TriangleMeshBuilder and QuadMeshBuilder to construct different kinds of meshes from points in 3D space via Point3D. The resulting Mesh container can be used with a texture graphic to create MapMarker3D objects.

4.11.0.0

2022-04-08

ADDED

Added support for online Bus route calculation via RoutingEngine. Added TransportMode.bus and BusOptions.

4.11.0.0

2022-04-08

CHANGED

Deprecated MapCamera.FlyToOptions`` and all MapCamera.flyToAPIs. UseMapCameraAnimationFactory.flyTo` APIs instead.

4.11.0.0

2022-04-08

ADDED

Added enhanced camera animations with MapCameraAnimationFactory.flyTo(target: GeoCoordinatesUpdate, bowFactor: double, duration: TimeInterval), MapCameraAnimationFactory.flyTo(target: GeoCoordinatesUpdate, orintation: GeoOrientationUpdate, bowFactor: double, duration: TimeInterval), MapCameraAnimationFactory.flyTo(target: GeoCoordinatesUpdate, zoom: MapMeasure, bowFactor: double, duration: TimeInterval), MapCameraAnimationFactory.flyTo(target: GeoCoordinatesUpdate, orintation: GeoOrientationUpdate, zoom: MapMeasure, bowFactor: double, duration: TimeInterval).

4.11.0.0

2022-04-08

FIXED

The returnToRoute() feature of the RoutingEngine now routes back to the first untravelled waypoint and the routeFractionTraveled parameter is no longer ignored.

4.11.0.0

2022-04-08

FIXED

The TrafficEngine can handle now GeoCorridor objects without a radius. When the radius via halfWidthInMeters is unset, a default value of 30 meters is used.

4.11.0.0

2022-04-08

CHANGED

Removed the previously deprecated InstantiationErrorCode.failedToLockPersistentMapStorageFolder. Nothing to use instead: The persistent storage directory is no longer locked.

4.11.0.0

2022-04-08

CHANGED

Removed the previously deprecated SectionNoticeCode.violatedPedestrianOption symbol. Nothing to use instead as this is is no longer supported.

4.11.0.0

2022-04-08

ADDED

Added enhanced animation support for MapMarker objects via the new MapMarkerAnimation class. Such animations are based on a MapItemKeyFrameTrack that stores keyframes for interpolation of a map item property. It can be constructed by calling MapItemKeyFrameTrack.moveTo(keyframes: [GeoCoordinatesKeyframe], easingFunction: EasingFunction, interpolationMode: KeyframeInterpolationMode). The animation can be started or cancelled via mapMarker.startAnimation(_ animation:)/cancelAnimation(_ animation:).

4.11.0.0

2022-04-08

ADDED

Added CategoryQuery.excludeCategories to add a list of PlaceCategory items that should be excluded from a category search for places. These categories can be set with CategoryQuery.withExcludeCategories.

4.11.0.0

2022-04-08

ADDED

MapMarker3D objects can now be scaled using a RenderSize.Unit in meters, pixels and
densityIndependentPixels.

4.11.0.0

2022-04-08

ADDED

Added explicit support for flat MapMarker3D objects. Added a convenience constructor for MapMarker3D with a MapImage parameter to create a flat map marker. Use RenderSize.Unit with densityIndependentPixels to create flat marker with a fixed size - independent of zoom level.

4.11.0.0

2022-04-08

CHANGED

Deprecated Section.trafficSpeeds property. Use instead Span.trafficSpeed property.

4.11.0.0

2022-04-08

KNOWN ISSUE

MapViewPin instances cannot be removed after tilting and panning the map.

4.11.0.0

2022-04-08

KNOWN ISSUE

4.11.0.0

2022-04-08

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.11.0.0

2022-04-08

KNOWN ISSUE

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

4.11.0.0

2022-04-08

KNOWN ISSUE

The jamFactor indicating TrafficSpeed is currently calculated linear without taking road types and other parameters into account.

4.11.0.0

2022-04-08

KNOWN ISSUE

RoutingEngine: The route import feature via a list of Locations cannot be used yet commercially and requires custom access credentials. Please contact your sales representative to get access.

4.11.0.0

2022-04-08

KNOWN ISSUE

MapPolyline instances ignore alpha color settings and will appear fully opaque.

4.11.0.0

2022-04-08

KNOWN ISSUE

MapDownloader: The sizeOnDiskInBytes property of Region and InstalledRegion slightly differs.

4.11.0.0

2022-04-08

KNOWN ISSUE

Finding traffic on a route via trafficEngine.queryForIncidents fails unexpectedly for GeoCorridor objects that are much shorter than 500 km.

4.10.5.0

2022-03-17

CHANGED

Deprecated Location.timestampSinceBootInMilliseconds. Use Location.timestampSinceBoot instead.

4.10.5.0

2022-03-17

CHANGED

Deprecated MapCameraObserver protocol, MapCamera.addObserver(_ observer: MapCameraObserver) and MapCamera.removeObserver(_ observer: MapCameraObserver) methods. Use MapCamera.addDelegate(_ delegate: MapCameraDelegate) and MapCamera.removeDelegate(_ delegate: MapCameraDelegate) instead.

4.10.5.0

2022-03-17

ADDED

Route alternatives are now fully supported for electric vehicles. EV route alternatives are enabled when routeOptions.alternatives is in the range [1, 6]. Note that this feature is already available since v4.10.4.0.

4.10.5.0

2022-03-17

ADDED

Added MapCameraDelegate protocol, MapCamera.addDelegate(_ delegate: MapCameraDelegate), MapCamera.removeDelegate(+ delegate: MapCameraDelegate) and MapCamera.removeDelegates methods.

4.10.5.0

2022-03-17

CHANGED

Deprecated MapCamera.cancelAnimation method. Use MapCamera.cancelAnimations instead.

4.10.5.0

2022-03-17

ADDED

Added MapCamera.cancelAnimation(_ cameraAnimation: MapCameraAnimation) and MapCamera.cancelAnimations methods.

4.10.5.0

2022-03-17

CHANGED

Deprecated MapCameraLimits.setMinTilt(degreesFromNadir: double) and MapCameraLimits.setMaxTilt(degreesFromNadir: double). Use MapCameraLimits.tiltRange(AngleRange) property instead.

4.10.5.0

2022-03-17

ADDED

Added MapCameraLimits.tiltRange(AngleRange) property.

4.10.5.0

2022-03-17

CHANGED

Deprecated MapCameraLimits.setMinZoomLevel(double), MapCameraLimits.setMaxZoomLevel(double), MapCameraLimits.ErrorCode, MapCameraLimits.MapCameraLimitsException. Use MapCameraLimits.zoomRange: MapMeasureRange property instead.

4.10.5.0

2022-03-17

ADDED

Added MapMeasureRange class to hold a MapMeasure range, MapCameraLimits.zoomRange: MapMeasureRange property.

4.10.5.0

2022-03-17

ADDED

Added MapCameraLimits.setBearingRangeAtZoom(_ zoom: MapMeasure, bearingRange: AngleRange), MapCameraLimits.clearBearingRanges, MapCameraLimits.setTiltRangeAtZoom(_ zoom: MapMeasure, tiltRange: AngleRange) and MapCameraLimits.clearTiltRanges.

4.10.5.0

2022-03-17

FIXED

Fixed incorrect handling of RouteOptions.occupantsNumber while requesting a route.

4.10.5.0

2022-03-17

FIXED

Routing: Fixed incorrect offset calculation for departure/arrival time that happens when converting to UTC time.

4.10.5.0

2022-03-17

ADDED

Added support for custom backends with the new EngineBaseURL enum and the customEngineBaseUrls field in SDKOptions.

4.10.5.0

2022-03-17

KNOWN ISSUE

MapViewPin instances cannot be removed after tilting and panning the map.

4.10.5.0

2022-03-17

KNOWN ISSUE

4.10.5.0

2022-03-17

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.10.5.0

2022-03-17

KNOWN ISSUE

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

4.10.5.0

2022-03-17

KNOWN ISSUE

The jamFactor indicating TrafficSpeed is currently calculated linear without taking road types and other parameters into account.

4.10.5.0

2022-03-17

KNOWN ISSUE

RoutingEngine: The route import feature via a list of Locations cannot be used yet commercially and requires custom access credentials. Please contact your sales representative to get access.

4.10.5.0

2022-03-17

KNOWN ISSUE

MapPolyline instances ignore alpha color settings and will appear fully opaque.

4.10.5.0

2022-03-17

KNOWN ISSUE

MapDownloader: The sizeOnDiskInBytes property of Region and InstalledRegion slightly differs.

4.10.5.0

2022-03-17

KNOWN ISSUE

Finding traffic on a route via trafficEngine.queryForIncidents fails unexpectedly for GeoCorridor objects that are much shorter than 500 km.

4.10.4.0

2022-03-02

CHANGED

Deprecated sdk.routing.HazardousGood enum. Use 'sdk.transport.HazardousMaterial' instead.

4.10.4.0

2022-03-02

ADDED

Added sdk.transport.HazardousMaterial enum. It is meant to replace the deprecated sdk.routing.HazardousGood.

4.10.4.0

2022-03-02

CHANGED

Deprecated EVTruckOptions.hazardous_goods. Use EVTruckOptions.hazardous_materials instead.

4.10.4.0

2022-03-02

CHANGED

Deprecated TruckOptions.hazardous_goods enum. Use 'TruckOptions.hazardous_materials' instead.

4.10.4.0

2022-03-02

ADDED

Traffic incident queries can now be canceled by calling the cancel() method of the TaskHandle object returned by the TrafficEngine.

4.10.4.0

2022-03-02

KNOWN ISSUE

MapViewPin instances cannot be removed after tilting and panning the map.

4.10.4.0

2022-03-02

KNOWN ISSUE

4.10.4.0

2022-03-02

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.10.4.0

2022-03-02

KNOWN ISSUE

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

4.10.4.0

2022-03-02

KNOWN ISSUE

The jamFactor indicating TrafficSpeed is currently calculated linear without taking road types and other parameters into account.

4.10.4.0

2022-03-02

KNOWN ISSUE

RoutingEngine: The route import feature via a list of Locations cannot be used yet commercially and requires custom access credentials. Please contact your sales representative to get access.

4.10.4.0

2022-03-02

KNOWN ISSUE

MapPolyline instances ignore alpha color settings and will appear fully opaque.

4.10.4.0

2022-03-02

KNOWN ISSUE

MapDownloader: The sizeOnDiskInBytes property of Region and InstalledRegion slightly differs.

4.10.3.0

2022-02-23

ADDED

Added MapIdleDelegate to detect whether the map is idle or busy.. Added HereMap.addMapIdledelegate(MapIdleDelegate) to start receiving idle state notifications and HereMap.removeMapIdleListener(MapIdleDelegate) to stop receiving idle state notifications.

4.10.3.0

2022-02-23

CHANGED

Deprecated unsupported method RasterDataSource.changeConfiguration(_ configFile: String). Use the another constructor instead.

4.10.3.0

2022-02-23

CHANGED

Deprecated TransitStop.durationInSeconds. Use TransitStop.duration instead. Deprecated TransitStop(departure, durationInSeconds) constructor with parameters. Use the default constructor instead.

4.10.3.0

2022-02-23

CHANGED

Deprecated Maneuver.durationInSeconds. Use Maneuver.duration instead.
- Deprecated Section.durationInSeconds. Use Section.duration instead.
- Deprecated Section.trafficDelayInSeconds. Use Section.trafficDelay instead.

4.10.3.0

2022-02-23

ADDED

Added altitude handling for offline routing.

4.10.3.0

2022-02-23

CHANGED

Deprecated PostAction.durationInSeconds. Use PostAction.duration instead.
- Deprecated PostAction constructor with parameters. Use the default constructor instead.
- Deprecated PreAction.durationInSeconds. Use PreAction.duration instead.
- Deprecated PreAction constructor with parameters. Use the default constructor instead.

4.10.3.0

2022-02-23

CHANGED

Deprecated Route.durationInSeconds. Use Route.duration instead.
- Deprecated Route.trafficDelayInSeconds. Use Route.trafficDelay instead.

4.10.3.0

2022-02-23

ADDED

Added support for UNKNOWN value from TrafficIncidentImpact and TrafficIncidentType enums to enable filtering for traffic incidents. This value indicates that all types/impacts are requested from the backend and filtering will be applied thereafter by the HERE SDK.

4.10.3.0

2022-02-23

CHANGED

Deprecated BatterySpecifications.changingSetupDurationInSeconds. Use BatterySpecifications.changingSetupDuration instead.

4.10.3.0

2022-02-23

CHANGED

Deprecated links in sdk.routing.Section. Use spans instead.

4.10.3.0

2022-02-23

CHANGED

Deprecated Waypoint.durationInSeconds. Use Waypoint.duration instead.

4.10.3.0

2022-02-23

FIXED

Adding custom raster layers no longer hides the HERE logo.

4.10.3.0

2022-02-23

ADDED

Updated colors related to street network elements for the night scheme.

4.10.3.0

2022-02-23

ADDED

Added colors related to landuse area polygons in the night scheme have been updated.

4.10.3.0

2022-02-23

ADDED

Visibility of embedded default carto POIs on the map has been improved.

4.10.3.0

2022-02-23

CHANGED

Deprecated MapCameraUpdateFactory.setPrincipalPointOffset(_ principalPointOffset: Point2D) method. Use MapCameraUpdateFactory.setNormalizedPrincipalPoint(_ principalPoint: Anchor2D) instead.

4.10.3.0

2022-02-23

ADDED

Added MapCameraUpdateFactory.setNormalizedPrincipalPoint(_ principalPoint: Anchor2D) method to animate camera's principal point using normalized screen coordinates.

4.10.3.0

2022-02-23

ADDED

Added Anchor2DKeyframe class to be used in animation of normalized principal point. Added MapCameraKeyframeTrack.normalizedPrincipalPoint(keyframes: [Anchor2DKeyframe], easingFunction: EasingFunction, interpolationMode: KeyframeInterpolationMode) that creates keyframe track for animating normalized principal point. Added MapCameraKeyframeTrack.getAnchor2DKeyframes() method. Added MapCameraUpdateFactory.setNormalizedPrincipalPoint(Anchor2D) method.

4.10.3.0

2022-02-23

ADDED

Added property isDepthCheckEnabled to MapMarker3D class. This improves rendering for complex 3D objects such as a torus.

4.10.3.0

2022-02-23

ADDED

Added initialBackgroundColor to MapViewOptions and constructor to set initial background color. Initial background color will be shown until the first map scene has been loaded.

4.10.3.0

2022-02-23

KNOWN ISSUE

MapViewPin instances cannot be removed after tilting and panning the map.

4.10.3.0

2022-02-23

KNOWN ISSUE

4.10.3.0

2022-02-23

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.10.3.0

2022-02-23

KNOWN ISSUE

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

4.10.3.0

2022-02-23

KNOWN ISSUE

The jamFactor indicating TrafficSpeed is currently calculated linear without taking road types and other parameters into account.

4.10.3.0

2022-02-23

KNOWN ISSUE

RoutingEngine: The route import feature via a list of Locations cannot be used yet commercially and requires custom access credentials. Please contact your sales representative to get access.

4.10.3.0

2022-02-23

KNOWN ISSUE

MapPolyline instances ignore alpha color settings and will appear fully opaque.

4.10.2.0

2022-02-07

CHANGED

Deprecated AuthenticationData.expiryTimeInSeconds. Use AuthenticationData.expiryTime instead.

4.10.2.0

2022-02-07

ADDED

Added isTruckLight flag to TruckSpecifications. It indicates that the truck can be classified as a car and that it is therefore excluded from legal restrictions (such as truck speed limits) for normal trucks when calculating the route. Note that specifications such as the physical dimensions, cargo, and others, are still taken into account.

4.10.2.0

2022-02-07

CHANGED

Deprecated FarePrice.validityPeriodInSeconds. Use FarePrice.validityPeriod instead.

4.10.2.0

2022-02-07

ADDED

Find traffic along a route: Added class TrafficIncidentOnRoute and read-only property Section.trafficIncidents. It represents traffic incidents on the route that are relevant for the section.

4.10.2.0

2022-02-07

ADDED

The RoutingEngine is now able to provide routes that contain altitude values along the route.

4.10.2.0

2022-02-07

ADDED

Added support for project scopes: With the new plist key option to specify a Scope an app can set the HRN value as defined by your project ID. Each app belongs to at least one or multiple projects. A possible use case can be to define a debugScope. See SDKOptions and the IAM Guide for more details.

4.10.2.0

2022-02-07

KNOWN ISSUE

MapViewPin instances cannot be removed after tilting and panning the map.

4.10.2.0

2022-02-07

KNOWN ISSUE

4.10.2.0

2022-02-07

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.10.2.0

2022-02-07

KNOWN ISSUE

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

4.10.2.0

2022-02-07

KNOWN ISSUE

The jamFactor indicating TrafficSpeed is currently calculated linear without taking road types and other parameters into account.

4.10.2.0

2022-02-07

KNOWN ISSUE

Transparency for MapPolylines is not supported.

4.10.2.0

2022-02-07

KNOWN ISSUE

RoutingEngine: The route import feature via a list of Locations cannot be used yet commercially and requires custom access credentials. Please contact your sales representative to get access.

4.10.2.0

2022-02-07

KNOWN ISSUE

MapPolyline instances ignore alpha color settings and will appear fully opaque.

4.10.1.0

2022-01-24

ADDED

Added global ParameterConfiguration that holds default values for HERE SDK features. For now, this allows to specify a walkingSpeedInMetersPerSecond to define a default pedestrian movement. Added TransitRouteOptions.fromDefaultParameterConfiguration() and PedestrianOptions.fromDefaultParameterConfiguration() that allow to create TransitRouteOptions and PedestrianOptions that will use the values set via ParameterConfiguration. The created options can then be used as usual for route calculation. Note that this is a beta feature.

4.10.1.0

2022-01-24

FIXED

Fixed: When cachePath and persistentMapStoragePath are changed via SDKOptions, then it may not change the default path.

4.10.1.0

2022-01-24

FIXED

Fixed: Updating an existing MapMarker with a completely new image causes the marker to disappear for a brief moment before being drawn with the new image.

4.10.1.0

2022-01-24

FIXED

Fixed: Truck routes that are imported via importRoute() may be result in a RoutingError.NO_ROUTE_FOUND error as certain truck restrictions may be violated along the road. This is incorrect and instead the resulting route should contain the violated restrictions as part of the route's SectionNotice.

4.10.1.0

2022-01-24

ADDED

Routing: Route calculations can now be canceled via the returned TaskHandle when calling calculateRoute() or related methods on engines such as the RoutingEngine.

4.10.1.0

2022-01-24

ADDED

Added RouteOptions.occupantsNumber: An option reflecting the number of occupants in a vehicle. Supported for car and truck transport modes. When it is higher than 1 it affects a vehicles ability to use HOV/carpool lanes. Defaults to 1.

4.10.1.0

2022-01-24

ADDED

Added matchSideOfStreet property to Waypoint class. It specifies how the location set by sideOfStreetHint should be handled when reaching a destination.

4.10.1.0

2022-01-24

FIXED

Fixed: The newly introduced zoom level behaves inconsistent across different devices as the shown level of detail depends on the physical screen size of a device.

4.10.1.0

2022-01-24

ADDED

Added a new TrafficEngine that allows querying for current traffic incidents. Check the Traffic example app to see how it works. The TrafficEngine supports querying for traffic incidents in a bounding box, a circle, or a corridor. Querying for the exact traffic incident by ID. Traffic incidents can contain an incident type, an incident impact, an incident location (currently, a polyline with length), incident codes, an active time range, localized by the queried language description and summary, relevant vehicle restrictions, and more. It supports representations of traffic incident vehicle restrictions as a set of restricted vehicle properties of some vehicle category and filtering queried incidents by an incident type, an incident impact and an active time range.

4.10.1.0

2022-01-24

CHANGED

Routing: Deprecated a route's Link. Use Span instead.

4.10.1.0

2022-01-24

ADDED

BYOD: Extended GeoPlace to hold more information: Added ExternalID, LocationDetails, WebDetails, BusinessDetails, TaskCompletionHandler as lambda.

4.10.1.0

2022-01-24

KNOWN ISSUE

MapViewPin instances cannot be removed after tilting and panning the map.

4.10.1.0

2022-01-24

KNOWN ISSUE

4.10.1.0

2022-01-24

KNOWN ISSUE

Outlines for MapPolyline lines can show a minimal gap at certain zoom levels. As a workaround use a round LineCap style.

4.10.1.0

2022-01-24

KNOWN ISSUE

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

4.10.1.0

2022-01-24

KNOWN ISSUE

The jamFactor indicating TrafficSpeed is currently calculated linear without taking road types and other parameters into account.

4.10.1.0

2022-01-24

KNOWN ISSUE

Transparency for MapPolylines is not supported.

4.10.1.0

2022-01-24

KNOWN ISSUE

RoutingEngine: The route import feature via a list of Locations cannot be used yet commercially and requires custom access credentials. Please contact your sales representative to get access.

4.10.1.0

2022-01-24

KNOWN ISSUE

MapPolyline instances ignore alpha color settings and will appear fully opaque.