Changelog
Most releases of the HERE Maps API for JavaScript include HARP engine style changes along with the added, changed, fixed, updated, and removed items, as listed in the following table.
For known issues and limitations, see the corresponding article in the Developer Guide.
Loading changelog...
| Date | Version | Type | Description |
|---|---|---|---|
| 2026-10-14 | 3.2.10.1 | UPDATED | Improved custom map objects rendering performance. |
| 2026-10-14 | 3.2.10.1 | UPDATED | Improved DOM markers picking. |
| 2026-10-14 | 3.2.10.1 | FIXED | Fixed a bug where MultiPoint geometries failed to display all associated markers. |
| 2026-10-14 | 3.2.10.1 | FIXED | Fixed a bug preventing the enginestatechange event from triggering in some cases. |
| 2026-08-27 | 3.2.10.0 | FIXED | Fixed a bug preventing labels from being rendered on zoom levels lower than 4 in some cases. |
| 2026-08-27 | 3.2.10.0 | CHANGED | Exported the mapsjs-ui.css in package.json to support importing the UI stylesheet directly by subpath. For a usage example, see Build HERE Maps with TypeScript. |
| 2026-08-27 | 3.2.10.0 | FIXED | Fixed an incompatibility between the index.d.ts declaration file and TypeScript 6.0. |
| 2026-08-03 | 3.2.9.0 | FIXED | Added initial support for the HERE Map Attributes API v8 service. |
| 2026-08-03 | 3.2.9.0 | UPDATED | Style changes: Filter extruded buildings and building footprints along bridges. |
| 2026-08-03 | 3.2.9.0 | ADDED | - H.service.Platform#getMapAttributesService- H.service.mapAttributes.Service#getAllAttributes- H.service.mapAttributes.Service#getAllLayers- H.service.mapAttributes.Service#getAllMaps- H.service.mapAttributes.Service#getAttributes- H.service.mapAttributes.Service#getAttributesAlongPath- H.service.mapAttributes.Service#getAttributesForRoute- H.service.mapAttributes.Service#getAttributesForSegments- H.service.mapAttributes.Service#getLayerIndexes |
| 2026-07-06 | 3.2.8.0 | ADDED | Added support for self-hosting use cases with the new @here/maps-api-for-javascript-assets NPM package containing styling assets. For usage and examples, see Self-Hosting. |
| 2026-07-06 | 3.2.8.0 | ADDED | Added the styleBaseUrl option to the H.service.Platform.DefaultLayersOptions class to specify a custom location for fetching map style configurations to create default layers. |
| 2026-07-06 | 3.2.8.0 | CHANGED | Improved CSP compliance for cases that prevent using WebAssembly. Only raster layers can be used in these cases. |
| 2026-07-06 | 3.2.8.0 | ADDED | Added political view support to earth vector data layer. |
| 2026-07-06 | 3.2.8.0 | FIXED | Fixed a bug causing the map to throw an error due to incorrect handling of the browser IndexedDB close event. |
| 2026-07-06 | 3.2.8.0 | ADDED | Style changes: Added a third outline to environmental and congestion zone polygons. |
| 2026-07-06 | 3.2.8.0 | UPDATED | Applied rendering performance improvements. |
| 2026-06-22 | 3.2.7.1 | UPDATED | Style changes: Improved the readability of truck restriction lines in hybrid scenes. |
| 2026-06-22 | 3.2.7.1 | UPDATED | Applied rendering performance improvements. |
| 2026-06-04 | 3.2.7.0 | ADDED | Added the new H.data.gpx.Reader API to render GPX data. For usage details and examples, see Display GPX data. |
| 2026-06-04 | 3.2.7.0 | FIXED | Fixed a bug that prevented data from an H.map.layer.ObjectLayer from rendering after the layer was removed and re-added to the data model. |
| 2026-06-04 | 3.2.7.0 | ADDED | Integrated the HERE Indoor Map module into the @here/maps-api-for-javascript NPM package. For a usage example, see Build HERE Maps with TypeScript developer guide. |
| 2026-06-04 | 3.2.7.0 | ADDED | Added the Configure Content Security Policy article docmenting the CSP directives required to use HERE Maps API for JavaScript. |
| 2026-06-04 | 3.2.7.0 | UPDATED | Reduced the size of the icon atlas assets. |
| 2026-06-04 | 3.2.7.0 | UPDATED | Style changes: Adapted style rule for Japanese passageway buildings to always draw them as flat building footprint. |
| 2026-06-04 | 3.2.7.0 | UPDATED | Style changes: Introduced an update preventing polyline gaps in the "truck-preferred roads" feature overlay. |
| 2026-06-04 | 3.2.7.0 | UPDATED | Applied rendering performance improvements. |
| 2026-04-27 | 3.2.6.2 | UPDATED | Updated external resource links in the API reference. |
| 2026-04-27 | 3.2.6.2 | UPDATED | Improved CSP compliance. |
| 2026-04-27 | 3.2.6.2 | ADDED | Style changes: Introduced specific display of public transit-related POIs when the public transit feature is enabled. |
| 2026-04-27 | 3.2.6.2 | UPDATED | Style changes: Fine-tuned night scene variants of vehicle restriction icons (USA & delivery add-on). |
| 2026-04-27 | 3.2.6.2 | FIXED | Style changes: Fixed missing city label display in Ukraine. |
| 2026-04-14 | 3.2.6.1 | REMOVED | Style changes: removed z-level based drawing rule for additional walkway baselines. |
| 2026-04-14 | 3.2.6.1 | UPDATED | Style changes: Updated iconography for traffic light assets (RoW only). |
| 2026-04-14 | 3.2.6.1 | UPDATED | Applied rendering performance improvements. |
| 2026-03-25 | 3.2.6.0 | ADDED | Added South Korea ( KR ) to the list of supported regions in the region property of H.service.Platform.Options. For more information on usage and limitations, see Configure region-specific maps. |
| 2026-03-25 | 3.2.6.0 | FIXED | Fixed a bug causing dashed lines to render as solid lines when the H.map.SpatialStyle.Options#lineDash pattern starts with a dash size of 0. |
| 2026-03-18 | 3.2.5.0 | ADDED | Added the optional baseUrl argument to the H.map.render.harp.Style constructor to specify a custom location from which the base style is fetched. |
| 2026-03-18 | 3.2.5.0 | ADDED | Added the H#getVersion() method that returms the API version. |
| 2026-03-18 | 3.2.5.0 | FIXED | Fixed the bug that caused errors when setting icons on H.map.Marker instances. |
| 2026-02-27 | 3.2.4.0 | UPDATED | Enhanced support for Heavy Goods Vehicle (HGV) weight specification in the Vehicle Profile API by introducing the currentWeightInKilograms attribute to H.service.omv.Provider.ITruckSpecs for filtering weight restrictions and distinguishing between gross weight and current weight. |
| 2026-02-27 | 3.2.4.0 | UPDATED | Improved CSP compliance. |
| 2026-02-27 | 3.2.4.0 | ADDED | Style changes: Implemented default features and modes per scheme. |
| 2026-02-27 | 3.2.4.0 | UPDATED | Style changes: Implemented the following night scheme adjustments:- beach polygon and label color - waterbreak polygon color (Japan only) |
| 2026-02-27 | 3.2.4.0 | UPDATED | Style changes: Implemented more prominent terrain hillshading colors in the topo scheme. |
| 2026-02-27 | 3.2.4.0 | CHANGED | Style changes: Changed the start zoom value of traffic light icons from 15 to 16 (Japan only). |
| 2026-02-16 | 3.2.3.1 | UPDATED | Improved dashed polyline rendering. |
| 2026-02-16 | 3.2.3.1 | FIXED | Fixed bug causing inconsistent extruded building rendering. |
| 2026-02-16 | 3.2.3.1 | FIXED | Fixed incorrect calculation of final target when calling H.map.ViewModel#setLookAtData with animation. |
| 2026-02-16 | 3.2.3.1 | UPDATED | Style changes: Implemented the following design adjustments to the normal.night scene:- brightened POI iconographies - updated colors of exit info icon and bilboard for night and night.logistics scenes- updated the water bathymetry color |
| 2026-02-16 | 3.2.3.1 | UPDATED | Style changes: Updated road shield icon mapping for route type 3 in Guatemala. |
| 2026-02-16 | 3.2.3.1 | CHANGED | Style changes: Changed the initial visibility of traffic incident road closures from zoom 9 to zoom 8. |
| 2026-02-16 | 3.2.3.1 | FIXED | Style changes: Fixed the unexpected display of oversized junction labels in Japan. |
| 2026-02-16 | 3.2.3.1 | ADDED | Style changes: Enabled label display for bus and trolley bus stops when the public transit feature is enabled. |
| 2026-02-16 | 3.2.3.1 | IMPROVED | Applied rendering performance improvements. |
| 2026-01-20 | 3.2.3.0 | CHANGED | Changed the behavior of primary lg and secondary lg2 language properties in H.service.Platform.DefaultLayersOptions to support dual-language label rendering. |
| 2026-01-20 | 3.2.3.0 | CHANGED | Changed the default value of the tileSize property in H.map.provider.ImageTileProvider.Options from 256 to 512. |
| 2026-01-20 | 3.2.3.0 | FIXED | Fixed a type mismatch between the API reference H.service.omv.Provider.ITruckSpecs#preferredTruckRouteTypes and the TypeScript declaration file. |
| 2026-01-20 | 3.2.3.0 | FIXED | Fixed map flickering issue on resize when using ResizeObserver. |
| 2026-01-20 | 3.2.3.0 | ADDED | Added a console warning when the H.ui.Overview UI control uses a layer already in use in the map. |
| 2026-01-20 | 3.2.3.0 | FIXED | The API avoid drawing unexpected elevation data for Japan traffic lights icons. |
| 2026-01-20 | 3.2.3.0 | ADDED | Implemented dual language support. |
| 2025-12-17 | 3.2.2.0 | UPDATED | Updated tile loading mechanism so that the tiles that are nearest to the viewport center are loaded first. |
| 2025-12-17 | 3.2.2.0 | ADDED | Added optional region property to H.service.Platform.Options (default ROW ; supports ROW and JP ) to control service configuration, endpoint selection, and map styling. |
| 2025-12-17 | 3.2.2.0 | CHANGED | Moved the label piority of the generic Government or Community Facility POI category lower than specific categories like City Hall & Embassy. |
| 2025-12-08 | 3.2.1.0 | UPDATED | Aligned the behaviour of the trucktype attribute in the Vehicle Profile API to match HERE Routing API v8. |
| 2025-12-08 | 3.2.1.0 | FIXED | Fixed a bug that caused line rendering artifacts on geometries with sharp angles. |
| 2025-12-08 | 3.2.1.0 | FIXED | Fixed a bug that prevented rendering of all labels after certain map interactions. |
| 2025-12-08 | 3.2.1.0 | FIXED | Fixed a bug that threw errors on map disposal when volatile map objects were used. |
| 2025-12-08 | 3.2.1.0 | UPDATED | Improved enginestatechange event to transition from H.Map.EngineState.BUSY to H.Map.EngineState.IDLE only after the map scene has fully rendered. |
| 2025-12-08 | 3.2.1.0 | ADDED | Style changes: Implemented a new map feature traffic lights that allows toggling the display of traffic light icons, enabledby default. |
| 2025-12-08 | 3.2.1.0 | CHANGED | Style changes: Consistently brightened the complete set of night schemes. All the elements of the map have been consistently brightened including the landuse, water, transport, streets, and overlays like icons including road shields, poi, traffic, exits, truck. |
| 2025-11-13 | 3.2.0.1 | UPDATED | Updated the map imprint copyright notice to display only the current year. |
| 2025-11-13 | 3.2.0.1 | FIXED | Fixed a bug that caused holes to be rendered on the map at certain locations and zoom levels. |
| 2025-11-13 | 3.2.0.1 | UPDATED | Updated HERE_NOTICE and LICENSE copyright years to the latest. |
| 2025-11-13 | 3.2.0.1 | UPDATED | Updated HERE Maps API for JavaScript examples to use version 3.2 with HARP as the rendering engine. |
| 2025-11-13 | 3.2.0.1 | UPDATED | Fixed a bug in documentation that prevented dispatched events and their types from being shown in the API reference. |
| 2025-11-13 | 3.2.0.1 | CHANGED | Raster layers created by H.service.Platform#createDefaultLayers now show POIs by default, when possible. The behavior between raster and vector layers is now aligned. |
| 2025-11-13 | 3.2.0.1 | ADDED | Enabled display of traffic light icons on zoomed in levels. |
| 2025-11-13 | 3.2.0.1 | ADDED | Introduced semi-transparent extruded building outlines. |
| 2025-11-13 | 3.2.0.1 | UPDATED | Improved zoom level transition for extruded buildings by taking building categories and building heights into account. |
| 2025-11-13 | 3.2.0.1 | CHANGED | The options argument to the H.service.Platform#getVenuesService constructor is no more optional. The constructor throws error if the argument is undefined. |
| 2025-09-30 | 3.2.0.0 | ADDED | Added new methods to the H.service.SearchService class:- H.service.SearchService#multiReverseGeocode- H.service.SearchService#postAutosuggest- H.service.SearchService#postDiscover- H.service.SearchService#postBrowse |
| 2025-09-30 | 3.2.0.0 | ADDED | Added new methods to the H.service.GeofencingService class:- H.service.SearchService#postGeofence- H.service.SearchService#getGeofenceAttributes |
| 2025-09-30 | 3.2.0.0 | ADDED | Added new methods to the H.service.traffic.Service7 class:- H.service.traffic.Service7#postRequestIncidentById- H.service.traffic.Service7#postRequestFlowByArea- H.service.traffic.Service7#postRequestIncidentsByArea |
| 2025-09-30 | 3.2.0.0 | ADDED | Added new methods to the H.service.RoutingService8 class:- H.service.RoutingService8#postCalculateRoute- H.service.RoutingService8#getRouteByHandle- H.service.RoutingService8#postGetRouteByHandle- H.service.RoutingService8#postCalculateIsoline- H.service.RoutingService8#postImportRouteFromTracePoints |
| 2025-09-30 | 3.2.0.0 | ADDED | Added new method to the H.service.WaypointsSequenceService class:- H.service.WaypointsSequenceService#postFindSequence |
| 2025-09-30 | 3.2.0.0 | CHANGED | Method H.service.Platform#createDefaultLayers doesn't expect ppi values specific to deprecated HERE Map Tile API v2 anymore, instead values relavant to HERE Raster Tile API v3 should be passed. |
| 2025-09-30 | 3.2.0.0 | CHANGED | H.map.Polygon.MAX_EXTRUDE_HEIGHT was renamed to H.map.Polygon.MAX_HEIGHT. |
| 2025-09-30 | 3.2.0.0 | CHANGED | Methods providesGeoJSON, providesOMV and providesRasters were moved from H.map.provider.Provider to H.map.provider.RemoteTileProvider and methods providesSpatials, providesMarkers, provideDOMMarkers and providesOverlays were moved to H.map.provider.ObjectProvider. |
| 2025-09-30 | 3.2.0.0 | REMOVED | Removed the following code related to the legacy browsers support: - Removed core-legacy (mapsjs-core-legacy.js) and service-legacy (mapsjs-service-legacy.js) modules. These modules contained code for the P2D rendering engine. As a result the entire H.map.render.p2d namespace was removed.- Removed option arrows from H.map.Polyline.Options, and related H.map.ArrowStyle class together with H.map.ArrowStyle.Options. It was applicable only to P2D rendering engine. |
| 2025-09-30 | 3.2.0.0 | REMOVED | Removed the following code related to the WEBGL rendering engine: - Removed the entire H.map.render.webgl namespace. |
| 2025-09-30 | 3.2.0.0 | REMOVED | Removed the separate harp (mapsjs-harp.js) module and mapsjs.bundle.harp.js bundle. The HARP engine is now the default and only rendering engine integrated into the core (mapsjs-core.js) module. |
| 2025-09-30 | 3.2.0.0 | REMOVED | Removed the entire H.service.extension namespace with all its classes. This namespace contained classes responsible for communication with the deprecated HERE Fleet Telematics API. Platform factory methods H.service.Platform#getCustomLocationService, H.service.Platform#getCustomRoutingService and H.service.Platform#getPlatformDataService were removed as well. |
| 2025-09-30 | 3.2.0.0 | REMOVED | Removed classes that relied on deprecated backend endpoints. Their corresponding platform factory methods were either removed or changed: - H.service.GeocodingService class and H.service.Platform#getGeocodingService method were removed.- H.service.PlacesService class and H.service.Platform#getPlacesService method were removed.- H.service.RoutingService class was removed.- H.service.Platform#getRoutingService was changed, now it doesn't accept opt_version parameter and always returns an instance of H.service.RoutingService8.- H.service.traffic.Service class was removed.- H.service.Platform#getTrafficService was changed, now it doesn't accept opt_version parameter and always returns an instance of H.service.traffic.Service7.- H.service.MapTileService class and H.service.Platform#getMapTileService method were removed. |
| 2025-09-30 | 3.2.0.0 | REMOVED | The result of H.service.Platform#createDefaultLayers was changed. These layers were removed from the default layers collection because they relied on deprecated backend endpoints: - raster.normal.xbase- raster.normal.xbasenight- raster.normal.trafficincidents- raster.normal.transit- raster.normal.metaInfo- raster.terrain.xbase- vector.normal.truck- vector.normal.traffic- vector.normal.trafficincidents |
| 2025-09-30 | 3.2.0.0 | REMOVED | Removed support of pois mask in H.service.Platform#createDefaultLayers options. That pois option of type string was specific to deprecated HERE Map Tile API v2. |
| 2025-09-30 | 3.2.0.0 | REMOVED | Removed the following code related to the Venues service:- Removed the deprecated H.venues.Level#getId method- Removed the deprecated H.venues.Route class- Removed H.venues.Service2 class, its content was moved to H.venues.Service class and replaced with previously deprecated code.- Removed the opt_version parameter from the H.service.Platform#getVenuesService method. |
| 2025-09-30 | 3.2.0.0 | REMOVED | Removed H.service.omv.Service#getMapVersion method and H.service.omv.Service.Options#mapVersion option because HERE Vector Tile API v2 supports only one map version at a time. |
| 2025-09-30 | 3.2.0.0 | REMOVED | Removed deprecated properties of H.map.ChangeEvent: SIZE, POSITION, HEADING, TILT, INCLINE, ZOOM, BOUNDS. |
| 2025-09-30 | 3.2.0.0 | REMOVED | Removed deprecated H.map.Style class. |
| 2025-09-30 | 3.2.0.0 | REMOVED | Removed deprecated H.map.provider.LocalObjectProvider#removeObject method. |
| 2025-09-30 | 3.2.0.0 | REMOVED | Removed deprecated H.map.Overlay#setBoundingBox and H.map.Overlay#getBoundingBox methods. |
| 2025-09-30 | 3.2.0.0 | REMOVED | Removed unused style option from H.service.Platform.DefaultLayersOptions. |
| 2025-09-30 | 3.2.0.0 | REMOVED | Removed options lineTailCap and lineHeadCap from H.map.SpatialStyle and H.map.SpatialStyle.Options, as well as arrow-head and arrow-tail values from H.map.SpatialStyle.LineCap. In case of HARP rendering engine arrows of the dashed lines can be drawn via lineDashImage option. |
| 2025-09-30 | 3.2.0.0 | REMOVED | Removed options lineJoin, miterLimit and lineDashOffset from H.map.SpatialStyle and H.map.SpatialStyle.Options. |
| 2025-09-30 | 3.2.0.0 | REMOVED | Removed H.map.layer.CanvasLayer, H.map.layer.DomLayer and H.map.layer.MarkerTileLayer classes. |
| 2025-09-30 | 3.2.0.0 | REMOVED | Removed disableLegacyMode option from H.data.geojson.Reader.Options, now GeoJSON geometry types MultiPoint, MultiLineString, MultiPolygon will be always represented by H.geo.MultiPoint, H.geo.MultiLineString and H.geo.MultiPolygon instances respectively. |
| 2025-09-30 | 3.2.0.0 | REMOVED | Removed support of H.geo.LineString in H.map.Polygon constructor, H.geo.Polygon can be passed instead. |
| 2025-09-30 | 3.2.0.0 | REMOVED | Removed H.map.provider.MarkerTileProvider class. |
| 2025-09-30 | 3.2.0.0 | ADDED | The initial release of HERE Maps API for JavaScript version 3.2. The primary change between HERE Maps API for JavaScript versions 3.1 and 3.2 involves changing the default engine for map rendering.In version 3.1, you could select between the functionally overlapping P2D, WEBGL, or HARP engines. In version 3.2, the P2D and WEBGL engines were removed with the HARP engine now being the default and only rendering engine integrated into the core (mapsjs-core.js) module. As a result, the separate harp (mapsjs-harp.js) module and mapsjs.bundle.harp.js bundle were removed.Apart from making HARP the default engine, some legacy functionality was removed. |
Updated 4 hours ago
Did this page help you?