Data SDK for Java & Scala
Changes released before 2025-09-28 are on the archived changelog.
Data APIs:
interactive-map-v1:1.3.4 blob-v2:1.3.4 config:1.3.4
they are re-established after restoring from a checkpoint or savepoint.
Added support for uploading IML payloads directly as JSON strings through the
Data Client Library using the following methods:
here.platform.data-client.ssl-config.pin-here-certificates configurationsetting from
true to false. Certificate pinning to the bundled HERE root CAcertificates is now opt-in; by default, the Data Client Library relies on the
JVM's default trust store for TLS connections. Set
ssl-config.pin-here-certificates = true to restore the previous pinningbehavior.
Data APIs:
index:1.3.4 stream:1.3.4 interactive-map-v1:1.3.4 config:1.3.4
4.1.135.Final to 4.1.136.Final to fix the following vulnerabilities: CVE-2026-44891, CVE-2026-55851, CVE-2026-56745, CVE-2026-55831, CVE-2026-55833, CVE-2026-56817, CVE-2026-59901, CVE-2026-56820, CVE-2026-56821, CVE-2026-56822, CVE-2026-56819.4.1.135.Final to 4.1.136.Final to fix the following vulnerabilities: CVE-2026-44891, CVE-2026-55851, CVE-2026-56745, CVE-2026-55831, CVE-2026-55833, CVE-2026-56817, CVE-2026-59901, CVE-2026-56820, CVE-2026-56821, CVE-2026-56822, CVE-2026-56819.4.1.135.Final to 4.1.136.Final to fix the following vulnerabilities: CVE-2026-44891, CVE-2026-55851, CVE-2026-56745, CVE-2026-55831, CVE-2026-55833, CVE-2026-56817, CVE-2026-59901, CVE-2026-56820, CVE-2026-56821, CVE-2026-56822, CVE-2026-56819.Data APIs:
interactive-map-v1:1.3.4 metadata:1.3.4 config:1.3.4
referencing. It lets users provide information that the first and/or last
reference points are at junctions, which allows the decoder to snap those points
more aggressively to junctions in the HERE map.
This helps when a junction is represented with significantly different
coordinates across maps, for example on highway ramps where the junction may be
modeled anywhere along the acceleration lane.
The API also allows users to provide precise coordinates for the first and last
reference points, which reduces gaps caused by OLR coordinate imprecision.
FilteredObservation has been moved fromcom.here.platform.location.core.mapmatching tocom.here.platform.location.core.mapmatching.model. Update your importsaccordingly.
Changed the minimum required Java version from 17 to 21 for the following schemas:
Real Time Traffic Incident's Schemas2.1.22RIB Schemas2.201.2SDII Schemas4.2.37SDII Archive Schemas2.2.56Sensoris Schemas1.1.23Optimizedmap Schemas4.2.0
17 to 21.2.18.6 to 2.18.8 to fix CVE-2026-54512 and CVE-2026-54513 vulnerabilities.4.1.133.Final to 4.1.135.Final to fix the following vulnerabilities: CVE-2026-44893, CVE-2026-48059, CVE-2026-44890, CVE-2026-48006, CVE-2026-44250, CVE-2026-50011, CVE-2026-50010, CVE-2026-44249, CVE-2026-45416, CVE-2026-45674, CVE-2026-47691, CVE-2026-46340.cz.jirutka.rsql:rsql-parser to io.github.nstdio:rsql-parser:2.4.0 dependency to fix the CVE-2016-6814 vulnerability.17 to 21.2.18.6 to 2.18.8 to fix CVE-2026-54512 and CVE-2026-54513 vulnerabilities.4.1.133.Final to 4.1.135.Final to fix the following vulnerabilities: CVE-2026-44893, CVE-2026-48059, CVE-2026-44890, CVE-2026-48006, CVE-2026-44250, CVE-2026-50011, CVE-2026-50010, CVE-2026-44249, CVE-2026-45416, CVE-2026-45674, CVE-2026-47691, CVE-2026-46340.cz.jirutka.rsql:rsql-parser to io.github.nstdio:rsql-parser:2.4.0 dependency to fix the CVE-2016-6814 vulnerability.17 to 21.2.2.0 to 2.2.1.2.18.6 to 2.18.8 to fix CVE-2026-54512 and CVE-2026-54513 vulnerabilities.org.lz4:lz4-java:1.8.0 to at.yawk.lz4:lz4-java:1.10.3 dependency to fix the CVE-2025-12183, CVE-2025-66566 vulnerabilities.4.1.133.Final to 4.1.135.Final to fix the following vulnerabilities: CVE-2026-44893, CVE-2026-48059, CVE-2026-44890, CVE-2026-48006, CVE-2026-44250, CVE-2026-50011, CVE-2026-50010, CVE-2026-44249, CVE-2026-45416, CVE-2026-45674, CVE-2026-47691, CVE-2026-46340.cz.jirutka.rsql:rsql-parser to io.github.nstdio:rsql-parser:2.4.0 dependency to fix the CVE-2016-6814 vulnerability.Cache-Control HTTPresponse header.
hasKnownIssues property to the VersionInfo model which indicatespotential issues with certain catalog version.
io.netty:netty-transport-native-epoll:4.1.132.Final library to align the managed Netty version and prevent dependency conflicts caused by transitive Netty dependencies.org.slf4j:slf4j-log4j12 with org.slf4j:slf4j-reload4j as the SLF4J binding, since slf4j-log4j12 has been superseded by slf4j-reload4j in newer SLF4J releases.io.netty libraries from the 4.1.132.Final version to the 4.1.133.Final to fix CVE-2026-42579, CVE-2026-42587, CVE-2026-42584, CVE-2026-42583, CVE-2026-42577 vulnerability.org.codehaus.woodstox:stax2-api:4.2.1 library to resolve a transitive dependency version conflict introduced by theorg.apache.hadoop:hadoop-client library.org.bouncycastle:bcprov-jdk18on library from the 1.78.1 version to the 1.84 to fix CVE-2026-5598 vulnerability.io.netty libraries from the 4.1.132.Final version to the 4.1.133.Final to fix CVE-2026-42579, CVE-2026-42587, CVE-2026-42584, CVE-2026-42583, CVE-2026-42577 vulnerability.io.netty libraries from the 4.1.132.Final version to the 4.1.133.Final to fix CVE-2026-42579, CVE-2026-42587, CVE-2026-42584, CVE-2026-42583, CVE-2026-42577 vulnerability.Data APIs:
interactive-map-v1:1.3.4 config:1.3.4
ClosestResultPerElement, a ProximitySearch decorator keeping only theclosest result for each element. Please note that the similar variant
ClosestResultPerKey is now deprecated.ProximitySearches.vertices and ProximitySearches.vertexGeometrySegments nowreturn results in a stable, deterministic order and are 10% faster on average.
HereTileResolver now returns tiles sorted in ascending tile ID order usingSortedSetData APIs:
interactive-map-v1:1.3.4 config:1.3.4
Added Data Subsets API to create, retrieve, or delete data subsets.
Create one or more data subsets for the given catalog:
com.here.platform.data.client.scaladsl.DataSubsetsApi.createDataSubsets(catalogHrn, dataSubsets)com.here.platform.data.client.javadsl.DataSubsetsApi.createDataSubsets(catalogHrn, dataSubsets)
Retrieve the details of accessible data subsets with filtering by areas or
layers:
com.here.platform.data.client.scaladsl.DataSubsetsApi.getDataSubsets(catalogHrn, limit, areas, layers)com.here.platform.data.client.scaladsl.DataSubsetsApi.getDataSubsetsAsSource(catalogHrn, limit, areas, layers)com.here.platform.data.client.javadsl.DataSubsetsApi.getDataSubsets(catalogHrn, limit, areas, layers)com.here.platform.data.client.javadsl.DataSubsetsApi.getDataSubsetsAsSource(catalogHrn, limit, areas, layers)
Retrieve the details of a specific data subset:
com.here.platform.data.client.scaladsl.DataSubsetsApi.getDataSubset(catalogHrn, dataSubsetId)com.here.platform.data.client.javadsl.DataSubsetsApi.getDataSubset(catalogHrn, dataSubsetId)
Delete a specific data subset:
com.here.platform.data.client.scaladsl.DataSubsetsApi.deleteDataSubset(catalogHrn, dataSubsetId)com.here.platform.data.client.javadsl.DataSubsetsApi.deleteDataSubset(catalogHrn, dataSubsetId)
Retrieve a fingerprint that represents the accessible data subset configuration
of the calling user:
com.here.platform.data.client.scaladsl.DataSubsetsApi.getDataSubsetsFingerprint(catalogHrn)com.here.platform.data.client.javadsl.DataSubsetsApi.getDataSubsetsFingerprint(catalogHrn)
Old, Subsets API is deprecated:
com.here.platform.data.client.scaladsl.AdminApi.getSubsets(hrn, limit, areas)com.here.platform.data.client.scaladsl.AdminApi.getSubsetsAsSource(hrn, limit, areas)com.here.platform.data.client.scaladsl.AdminApi.getSubset(hrn, subsetId)com.here.platform.data.client.scaladsl.AdminApi.getSubsetsFingerprint(hrn)
areaScheme is deprecated on the catalog level. Use DataSubsetsApi to setareaScheme in the data subset instead.subsetRestrictions is deprecated on the catalog level. UsesubsetRestrictions on the layer level only.
DeltaSet transformation filterByKey which caused serialization errors when used with theBroadcast resolution strategy.DeltaSet transformation persist which might cause resolution errors when used with the Broadcastresolution strategy.
OptimizedMapLayers instead or rely on data-client for fetching data from
versioned layers.
PropertyMaps.rangeBasedProperty andPropertyMaps.overlappingRangeBasedProperty deprecated methods. Please useplain Here Map Content or rely on
com.here.platform.location.compilation.heremapcontent.AttributeAccessor.apply.Removed also the overloads related to
roadAttributes, navigationAttributes,and
advancedNavigationAttributes.OptimizedMapLayers.RoutingGraphConfiguration. Please useRoutingGraphLayerConfiguration instead.Removed deprecated
OptimizedMapLayers.RestrictedManoeuvreConfiguration. Pleaseuse
RestrictedManoeuvreLayerConfiguration instead.withVersionedLayerReadersCache methodfrom the
OptimizedMapCatalogDsl class. Please use the non-deprecated overload,which accepts
VersionedLayerReadersConfiguration, instead.Added the following HMC schema artifacts to the SDK Bom files:
com.here.schema.rib:speed-limit-warning-signs_v2com.here.schema.rib:speed-limit-warning-signs_v2_dscom.here.schema.rib:speed-limit-warning-signs_v2_javacom.here.schema.rib:speed-limit-warning-signs_v2_protocom.here.schema.rib:speed-limit-warning-signs_v2_scala_2.13
Removed the following deprecated data loaders:
com.here.platform.location:location-data-loader-core_2.13com.here.platform.location:location-data-loader-standalone_2.13com.here.platform.location:location-data-loader-spark_2.13
Added the following HMC schema artifacts to the SDK Bom files:
com.here.schema.rib:speed-limit-warning-signs_v2com.here.schema.rib:speed-limit-warning-signs_v2_dscom.here.schema.rib:speed-limit-warning-signs_v2_javacom.here.schema.rib:speed-limit-warning-signs_v2_protocom.here.schema.rib:speed-limit-warning-signs_v2_scala_2.13
Removed the following deprecated data loaders:
com.here.platform.location:location-data-loader-core_2.13com.here.platform.location:location-data-loader-standalone_2.13com.here.platform.location:location-data-loader-flink_2.13
Added the following HMC schema artifacts to the SDK Bom files:
com.here.schema.rib:speed-limit-warning-signs_v2com.here.schema.rib:speed-limit-warning-signs_v2_dscom.here.schema.rib:speed-limit-warning-signs_v2_javacom.here.schema.rib:speed-limit-warning-signs_v2_protocom.here.schema.rib:speed-limit-warning-signs_v2_scala_2.13
Removed the following deprecated data loaders:
com.here.platform.location:location-data-loader-core_2.13com.here.platform.location:location-data-loader-standalone_2.13com.here.platform.location:location-data-loader-spark_2.13com.here.platform.location:location-data-loader-flink_2.13
org.apache.zookeeper:zookeeper library from the 3.9.3 version to the 3.9.3 to fix CVE-2026-24308 and CVE-2026-24281 vulnerabilities.Upgraded the following com.fasterxml.jackson.core libraries from the 2.18.2 to the 2.18.6 to fix vulnerabilities:
jackson-annotationsjackson-corejackson-databindjackson-dataformat-yamljackson-datatype-jsr310jackson-datatype-jdk8jackson-module-scala_2.13jackson-datatype-json-org
io.netty:netty-all library from the 4.1.126.Final version to the 4.1.132.Final to fix CVE-2025-59419 vulnerability.io.airlift:aircompressor library from the 2.0.2 version to the 2.0.3 to fix CVE-2025-67721 vulnerability.org.apache.zookeeper:zookeeper library from the 3.9.3 version to the 3.9.3 to fix CVE-2026-24308 and CVE-2026-24281 vulnerabilities.Upgraded the following com.fasterxml.jackson.core libraries from the 2.18.2 to the 2.18.6 to fix vulnerabilities:
jackson-annotationsjackson-corejackson-databindjackson-dataformat-yamljackson-datatype-jsr310jackson-datatype-jdk8jackson-module-scala_2.13jackson-datatype-json-org
io.netty:netty-all library from the 4.1.126.Final version to the 4.1.132.Final to fix CVE-2025-59419 vulnerability.io.airlift:aircompressor library from the 2.0.2 version to the 2.0.3 to fix CVE-2025-67721 vulnerability.org.apache.zookeeper:zookeeper library from the 3.9.3 version to the 3.9.3 to fix CVE-2026-24308 and CVE-2026-24281 vulnerabilities.Upgraded the following com.fasterxml.jackson.core libraries from the 2.18.2 to the 2.18.6 to fix vulnerabilities:
jackson-annotationsjackson-corejackson-databindjackson-dataformat-yamljackson-datatype-jsr310jackson-datatype-jdk8jackson-module-scala_2.13jackson-datatype-json-org
io.netty:netty-all library from the 4.1.126.Final version to the 4.1.132.Final to fix CVE-2025-59419 vulnerability.Changed the following archetypes to use the new Stream environment with Flink 2.2.0:
Streaming Pipeline in JavaStreaming Pipeline in Scala
The Data Archive Library has been upgraded to Flink 2.2.0.
This upgrade introduces breaking changes due to the removal of deprecated APIs in Flink 2.x. The library has been updated accordingly to align with the new APIs and runtime behavior.
Key updates:
- Source API migration
- Replaced deprecated
SourceFunctionusage with the FLIP-27SourceAPI - Updated stream creation from
addSource(...)tofromSource(...)
- Replaced deprecated
- Sink API migration
- Replaced deprecated
SinkFunctionwith the new Sink V2 API - Updated usage from
addSink(...)tosinkTo(...)
- Replaced deprecated
- Function lifecycle changes
- Updated
open(Configuration)methods toopen(OpenContext)where applicable
- Updated
- Dependencies and imports
- Updated Flink dependencies to version 2.2.0
- Updated imports to reflect API changes (e.g. removal of
flink-java)
For full details on required changes and migration steps, refer to the Flink Connector Migration Guide.
Data APIs:
interactive-map-v1:1.3.4 config:1.3.4
For more information, see the
Migration Guide
tile. Path matching performance has improved by around 10% as a result. To
benefit from this optimization, make sure a dedicated path matcher instance per
thread is created using preconfigured path matcher factories. When implementing
a custom path matcher, ensure that layer loaders are created per thread.
AttributeAccessor.apply to the Java DSL, providing the samepartition‑attribute extraction capability already available in the Scala DSL.
For instructions on how to access the advanced navigation attributes, see the
com.here.platform.location.integration.optimizedmap.graph.PropertyMaps.TopologyAttributesclass and the related methods. Added the specific Java variant through the
com.here.platform.location.integration.optimizedmap.graph.javadsl.PropertyMaps.TopologyAttributesclass.
Changed the following examples to use the new Stream environment with Flink 2.2.0:
Added the following HMC schema artifacts to the SDK Bom files:
com.here.schema.rib:speed-limits_v2com.here.schema.rib:speed-limits_v2_dscom.here.schema.rib:speed-limits_v2_javacom.here.schema.rib:speed-limits_v2_protocom.here.schema.rib:speed-limits_v2_scala_2.13
com.here.platform.data.archive:data-archive_2.13 library from sdk-batch-bom_2.13 since this library is intended for Flink applications only.If you need this library, you can find it in
sdk-stream-bom_2.13 or sdk-standalone-bom_2.13.com.here.platform.data.client:kafka-support_2.13 library from sdk-batch-bom_2.13 since this library is intended for Flink applications only.If you need this library, you can find it in
sdk-stream-bom_2.13 or sdk-standalone-bom_2.13.Added the following HMC schema artifacts to the SDK Bom files:
com.here.schema.rib:speed-limits_v2com.here.schema.rib:speed-limits_v2_dscom.here.schema.rib:speed-limits_v2_javacom.here.schema.rib:speed-limits_v2_protocom.here.schema.rib:speed-limits_v2_scala_2.13
Added the following HMC schema artifacts to the SDK Bom files:
com.here.schema.rib:speed-limits_v2com.here.schema.rib:speed-limits_v2_dscom.here.schema.rib:speed-limits_v2_javacom.here.schema.rib:speed-limits_v2_protocom.here.schema.rib:speed-limits_v2_scala_2.13
com.esotericsoftware.kryo:kryo:2.24.0 library to com.esotericsoftware:kryo:5.6.2.org.objenesis:objenesis library from the 3.3 version to the 3.4.org.apache.avro:avro library from the 1.11.4 version to the 1.11.5 to fix CVE-2025-33042 vulnerability.com.esotericsoftware.kryo:kryo:2.24.0 library to com.esotericsoftware:kryo:5.6.2.org.objenesis:objenesis library from the 3.3 version to the 3.4.org.flinkextended:flink-scala-api_2.13:1.19.1_1.2.0 library to org.flinkextended:flink-scala-api-2_2.13:2.2.0.org.apache.avro:avro library from the 1.11.4 version to the 1.11.5 to fix CVE-2025-33042 vulnerability.org.apache.commons:commons-lang3 library from the 3.12.0 version to the 3.18.0.com.esotericsoftware.kryo:kryo:2.24.0 library to com.esotericsoftware:kryo:5.6.2.org.objenesis:objenesis library from the 3.3 version to the 3.4.com.twitter:chill-protobuf library from the 0.7.6 version to the 0.10.0.com.here.platform:environment-stream:6.0.1 to the com.here.platform:environment-stream:7.0.0 to support Flink 2.2.0.Upgraded the following com.fasterxml.jackson.core libraries from the 2.14.2 to the 2.18.2 to fix CVE-2025-52999 vulnerability:
jackson-annotationsjackson-corejackson-databindjackson-dataformat-yamljackson-datatype-jsr310jackson-datatype-jdk8jackson-module-scala_2.13jackson-datatype-json-org
max-requests-per-host for the OkHttpClientused by BaseClient.
This allows controlling the maximum number of concurrent HTTP requests per host
instead of relying on OkHttp’s default limit.
Data APIs:
interactive-map-v1:1.3.4 config:1.3.4
use the separate Curvature and Heading attributes instead.
(hrn:here:data::olp-here:here-optimized-map-for-location-library-japan-2).
SimpleConnectivityTransitionProbabilityStrategy class. Please useDistanceTransitionProbabilityStrategy instead.Removed
distanceWithTransitions method. Please use the other availableoverload instead.
Updated the following tutorials to replace deprecated road-attributes with topology-attributes layer from HMC catalog, upgrade HMC catalog versions to 8185, and adopt the new topology-attributes schema:
Read from a catalog in a batch applicationCorrelate Road Attributes to Segment GeometryUse Spark connector to read and write data
Updated the following examples to replace deprecated road-attributes with topology-attributes layer from HMC catalog, upgrade HMC catalog versions to 8185 and adopt the new topology-attributes schema:
A Compiler to lift road topology and geometry and aggregate it to higher levelA Stateful Processing Compiler to Process Input and Feedback DataA Compiler to Compute Catalog DifferencesA Compiler to Extract Pedestrian Topologies into ProtobufA Compiler to Extract Pedestrian Topologies into GeoJSON
Added the following Optimized Map schema artifacts to the SDK Bom files:
com.here.platform.pb.location.optimizedmap:capabilities_v2_javacom.here.platform.pb.location.optimizedmap:capabilities_v2_protocom.here.platform.pb.location.optimizedmap:capabilities_v2_scala_2.13
Added the following Optimized Map schema artifacts to the SDK Bom files:
com.here.platform.pb.location.optimizedmap:capabilities_v2_javacom.here.platform.pb.location.optimizedmap:capabilities_v2_protocom.here.platform.pb.location.optimizedmap:capabilities_v2_scala_2.13
Added the following Optimized Map schema artifacts to the SDK Bom files:
com.here.platform.pb.location.optimizedmap:capabilities_v2_javacom.here.platform.pb.location.optimizedmap:capabilities_v2_protocom.here.platform.pb.location.optimizedmap:capabilities_v2_scala_2.13
ApiRequest.withQueryParam method to support multiple values for thesame query parameter key. Now calling
.withQueryParam("param", "value1").withQueryParam("param", "value2") willproduce a query string like
?param=value1¶m=value2 instead of overwritingthe first value.
Data APIs:
olsRouting-v8 8.146.0
Data APIs:
olsRevGeocode-v1 1.0.0
toLocationLineString extension method to Scala LineString like typesAdded the following RIB schema artifacts to the SDK Bom files:
com.here.schema.rib:cartography-tile-intersections_v2com.here.schema.rib:cartography-tile-intersections_v2_dscom.here.schema.rib:cartography-tile-intersections_v2_javacom.here.schema.rib:cartography-tile-intersections_v2_protocom.here.schema.rib:cartography-tile-intersections_v2_scala_2.13
Added the following RIB schema artifacts to the SDK Bom files:
com.here.schema.rib:cartography-tile-intersections_v2com.here.schema.rib:cartography-tile-intersections_v2_dscom.here.schema.rib:cartography-tile-intersections_v2_javacom.here.schema.rib:cartography-tile-intersections_v2_protocom.here.schema.rib:cartography-tile-intersections_v2_scala_2.13
Added the following RIB schema artifacts to the SDK Bom files:
com.here.schema.rib:cartography-tile-intersections_v2com.here.schema.rib:cartography-tile-intersections_v2_dscom.here.schema.rib:cartography-tile-intersections_v2_javacom.here.schema.rib:cartography-tile-intersections_v2_protocom.here.schema.rib:cartography-tile-intersections_v2_scala_2.13
commons-logging:commons-logging:1.3.5 library.Upgraded the following io.circe libraries from the 0.14.1 version to the 0.14.15 to fix the CVE-2022-21653 vulnerability:
io.circe:circe-coreio.circe:circe-parserio.circe:circe-generic
Upgraded the org.lz4:lz4-java:1.8.0 library to at.yawk.lz4:lz4-java:1.10.2 to fix CVE-2025-12183 and CVE-2025-66566 vulnerabilities.
For local application execution, include the following dependency:
<dependency>
<groupId>at.yawk.lz4</groupId>
<artifactId>lz4-java</artifactId>
<scope>provided</scope>
</dependency>commons-logging:commons-logging:1.3.5 library.Upgraded the following io.circe libraries from the 0.14.1 version to the 0.14.15 to fix the CVE-2022-21653 vulnerability:
io.circe:circe-coreio.circe:circe-parserio.circe:circe-generic
Upgraded the org.lz4:lz4-java:1.8.0 library to at.yawk.lz4:lz4-java:1.10.2 to fix CVE-2025-12183 and CVE-2025-66566 vulnerabilities.
For local application execution, include the following dependency:
<dependency>
<groupId>at.yawk.lz4</groupId>
<artifactId>lz4-java</artifactId>
<scope>provided</scope>
</dependency>commons-logging:commons-logging:1.3.5 library.Upgraded the following io.circe libraries from the 0.14.1 version to the 0.14.15 to fix the CVE-2022-21653 vulnerability:
io.circe:circe-coreio.circe:circe-parserio.circe:circe-generic
Data APIs:
config:1.3.4
the case of traces with dense points. This change should improve the
performances of the map matching algorithm in real-world use cases by up to 50%.
Upgraded the following logback libraries from the 1.4.14 version to the 1.5.20 to fix the CVE-2024-12801, CVE-2024-12798 vulnerabilities:
ch.qos.logback:logback-corech.qos.logback:logback-classic
Upgraded the following logback libraries from the 1.4.14 version to the 1.5.20 to fix the CVE-2024-12801, CVE-2024-12798 vulnerabilities:
ch.qos.logback:logback-corech.qos.logback:logback-classic
org.apache.parquet:parquet-avro library from the 1.14.4 version to the 1.15.2 to fix the following vulnerabilities: CVE-2025-30065,CVE-2025-46762.Upgraded the following logback libraries from the 1.4.14 version to the 1.5.20 to fix the CVE-2024-12801, CVE-2024-12798 vulnerabilities:
ch.qos.logback:logback-corech.qos.logback:logback-classic
org.apache.parquet:parquet-avro library from the 1.14.4 version to the 1.15.2 to fix the following vulnerabilities: CVE-2025-30065,CVE-2025-46762.Batch 5.0 environment with Spark 4.0.1.Data APIs:
olsRouting-v8 8.79.1
Data APIs:
config:1.3.2
Spark 4.0.1.Batch 5.0 environment with Spark 4.0.1:For more information on migrating your project to
Spark 4.0.1, refer to the migration guide.Batch 5.0 environment with Spark 4.0.1.Be sure to update the schema to the latest version to avoid compatibility issues.
Be sure to update the schema to the latest version to avoid compatibility issues.
Be sure to update the schema to the latest version to avoid compatibility issues.
The latest SDII schemas now use Protobuf 4.32.0:
- SDII v3 Schema: Message and MessageList v4.2.34
- SDII Archive Schema v2.2.50
Be sure to update the above-mentioned schemas to their latest versions to avoid compatibility issues.
Be sure to update the schema to the latest version to avoid compatibility issues.
A Compiler to Extract Pedestrian Topologies into Protobuf example to use Protobuf 4.32.0.Added the following RIB schema artifacts to the SDK Bom files:
com.here.schema.rib:physical-road-surfaces_v2com.here.schema.rib:physical-road-surfaces_v2_dscom.here.schema.rib:physical-road-surfaces_v2_javacom.here.schema.rib:physical-road-surfaces_v2_protocom.here.schema.rib:physical-road-surfaces_v2_scala_2.13
Removed the following RIB schema artifacts from the SDK Bom files:
com.here.schema.rib:road-surface-attributes_v2com.here.schema.rib:road-surface-attributes_v2_dscom.here.schema.rib:road-surface-attributes_v2_javacom.here.schema.rib:road-surface-attributes_v2_protocom.here.schema.rib:road-surface-attributes_v2_scala_2.13
Added the following RIB schema artifacts to the SDK Bom files:
com.here.schema.rib:physical-road-surfaces_v2com.here.schema.rib:physical-road-surfaces_v2_dscom.here.schema.rib:physical-road-surfaces_v2_javacom.here.schema.rib:physical-road-surfaces_v2_protocom.here.schema.rib:physical-road-surfaces_v2_scala_2.13
Removed the following RIB schema artifacts from the SDK Bom files:
com.here.schema.rib:road-surface-attributes_v2com.here.schema.rib:road-surface-attributes_v2_dscom.here.schema.rib:road-surface-attributes_v2_javacom.here.schema.rib:road-surface-attributes_v2_protocom.here.schema.rib:road-surface-attributes_v2_scala_2.13
Added the following RIB schema artifacts to the SDK Bom files:
com.here.schema.rib:physical-road-surfaces_v2com.here.schema.rib:physical-road-surfaces_v2_dscom.here.schema.rib:physical-road-surfaces_v2_javacom.here.schema.rib:physical-road-surfaces_v2_protocom.here.schema.rib:physical-road-surfaces_v2_scala_2.13
Removed the following RIB schema artifacts from the SDK Bom files:
com.here.schema.rib:road-surface-attributes_v2com.here.schema.rib:road-surface-attributes_v2_dscom.here.schema.rib:road-surface-attributes_v2_javacom.here.schema.rib:road-surface-attributes_v2_protocom.here.schema.rib:road-surface-attributes_v2_scala_2.13
org.checkerframework:checker-qual library from the 3.33.0 version to the 3.43.0.commons-codec:commons-codec library from the 1.17.1 version to the 1.17.2.commons-io:commons-io library from the 2.16.1 version to the 2.18.0.org.apache.curator:curator-client, org.apache.curator:curator-framework, and org.apache.curator:curator-recipes libraries from the 2.13.0 version to the 5.7.1 to fix the following direct and transitive vulnerabilities: CVE-2019-20444,CVE-2019-20445,CVE-2015-2156,CVE-2022-23305,CVE-2019-17571,CVE-2021-4104,CVE-2023-26464,CVE-2022-23302,CVE-2022-23307,CVE-2023-44981,CVE-2017-5637,CVE-2018-8012.com.here.platform:environment-batch_2.13:4.0.15 to the com.here.platform:environment-batch_2.13:5.0.0 to supportSpark 4.0.1.com.google.errorprone:error_prone_annotations library from the 2.5.1 version to the 2.36.0.com.google.code.gson:gson library from the 2.8.9 version to the 2.11.0.com.google.guava:guava library from the 31.1.1-jre version to the 33.4.0-jre.com.google.j2objc:j2objc-annotations library from the 2.8 version to the 3.0.0.Upgraded the following com.fasterxml.jackson.core libraries from the 2.14.2 to the 2.18.2:
jackson-annotationsjackson-corejackson-databindjackson-dataformat-yamljackson-datatype-jsr310jackson-datatype-jdk8jackson-module-scala_2.13jackson-datatype-json-org
org.jline:jline library from the 3.26.0 version to the 3.27.1.joda-time:joda-time library from the 2.12.2 version to the 2.13.0.org.json4s:json4s-ast_2.13, org.json4s:json4s-core_2.13, and org.json4s:json4s-native_2.13 libraries from the 3.7.0-M11 version to the 4.0.7.ch.qos.logback:logback-classic and ch.qos.logback:logback-core libraries from the 1.3.14 version to the 1.4.14.io.dropwizard.metrics:metrics-core library from the 3.1.5 version to the 4.2.30.io.netty:netty-all library from the 4.1.118 version to the 4.1.126.org.objenesis:objenesis library from the 3.2 version to the 3.3.org.scala-lang.modules:scala-parser-combinators_2.13 library from the 2.4.1 version to the 2.4.0.org.scala-lang.modules:scala-xml_2.13 library from the 2.4.0 version to the 2.3.0.org.yaml:snakeyaml library from the 2.0 version to the 2.3.org.xerial.snappy:snappy-java library from the 1.1.10.5 version to the 1.1.10.7.commons-beanutils:commons-beanutils library from the 1.9.4 version to the 1.11.0 to fix the following vulnerabilities: CVE-2023-25613, CVE-2024-25638.org.checkerframework:checker-qual library from the 3.33.0 version to the 3.43.0.commons-codec:commons-codec library from the 1.17.1 version to the 1.17.2.commons-io:commons-io library from the 2.16.1 version to the 2.18.0.org.apache.curator:curator-client, org.apache.curator:curator-framework, and org.apache.curator:curator-recipes libraries from the 2.13.0 version to the 5.7.1 to fix the following direct and transitive vulnerabilities: CVE-2019-20444,CVE-2019-20445,CVE-2015-2156,CVE-2022-23305,CVE-2019-17571,CVE-2021-4104,CVE-2023-26464,CVE-2022-23302,CVE-2022-23307,CVE-2023-44981,CVE-2017-5637,CVE-2018-8012.com.google.errorprone:error_prone_annotations library from the 2.5.1 version to the 2.36.0.com.google.code.gson:gson library from the 2.8.9 version to the 2.11.0.com.google.guava:guava library from the 31.1.1-jre version to the 33.4.0-jre.org.apache.hadoop:hadoop-client library from the 3.3.6 version to the 3.4.1 to fix the following vulnerabilities: CVE-2023-25613, CVE-2024-25638com.google.j2objc:j2objc-annotations library from the 2.8 version to the 3.0.0.Upgraded the following com.fasterxml.jackson.core libraries from the 2.14.2 version to the 2.18.2:
jackson-annotationsjackson-corejackson-databindjackson-dataformat-yamljackson-datatype-jsr310jackson-datatype-jdk8jackson-module-scala_2.13jackson-datatype-json-org
org.jline:jline library from the 3.26.0 version to the 3.27.1.joda-time:joda-time library from the 2.12.2 version to the 2.13.0.org.json4s:json4s-ast_2.13, org.json4s:json4s-core_2.13, and org.json4s:json4s-native_2.13 libraries from the 3.7.0-M11 version to the 4.0.7.ch.qos.logback:logback-classic and ch.qos.logback:logback-core libraries from the 1.3.14 version to the 1.4.14.io.dropwizard.metrics:metrics-core library from the 3.1.5 version to the 4.2.30.io.netty:netty-all library from the 4.1.118 version to the 4.1.126.org.objenesis:objenesis library from the 3.2 version to the 3.3.org.scala-lang.modules:scala-parser-combinators_2.13 library from the 2.4.1 version to the 2.4.0.org.scala-lang.modules:scala-xml_2.13 library from the 2.4.0 version to the 2.3.0.org.yaml:snakeyaml library from the 2.0 version to the 2.3.org.xerial.snappy:snappy-java library from the 1.1.10.5 version to the 1.1.10.7.org.checkerframework:checker-qual library from the 3.33.0 version to the 3.43.0.commons-codec:commons-codec library from the 1.17.1 version to the 1.17.2.commons-io:commons-io library from the 2.16.1 version to the 2.18.0.org.apache.curator:curator-client, org.apache.curator:curator-framework, and org.apache.curator:curator-recipes libraries from the 2.13.0 version to the 5.7.1 to fix the following direct and transitive vulnerabilities: CVE-2019-20444,CVE-2019-20445,CVE-2015-2156,CVE-2022-23305,CVE-2019-17571,CVE-2021-4104,CVE-2023-26464,CVE-2022-23302,CVE-2022-23307,CVE-2023-44981,CVE-2017-5637,CVE-2018-8012.com.google.errorprone:error_prone_annotations library from the 2.5.1 version to the 2.36.0.com.google.code.gson:gson library from the 2.8.9 version to the 2.11.0.com.google.guava:guava library from the 31.1.1-jre version to the 33.4.0-jre.com.google.j2objc:j2objc-annotations library from the 2.8 version to the 3.0.0.org.jline:jline library from the 3.26.0 version to the 3.27.1.joda-time:joda-time library from the 2.12.2 version to the 2.13.0.org.json4s:json4s-ast_2.13, org.json4s:json4s-core_2.13, and org.json4s:json4s-native_2.13 libraries from the 3.7.0-M11 version to the 4.0.7.ch.qos.logback:logback-classic and ch.qos.logback:logback-core libraries from the 1.3.14 version to the 1.4.14.io.dropwizard.metrics:metrics-core library from the 3.1.5 version to the 4.2.30.io.netty:netty-all library from the 4.1.118 version to the 4.1.126.org.objenesis:objenesis library from the 3.2 version to the 3.3.org.scala-lang.modules:scala-parser-combinators_2.13 library from the 2.4.1 version to the 2.4.0.org.scala-lang.modules:scala-xml_2.13 library from the 2.4.0 version to the 2.3.0.org.yaml:snakeyaml library from the 2.0 version to the 2.3.org.xerial.snappy:snappy-java library from the 1.1.10.5 version to the 1.1.10.7.The latest version of archetypes generates Scala 2.13 compatible projects.
If you want to use Scala 2.12, please use archetype version
1.0.1017 for the corresponding archetype (for example, batch-direct1ton-java:1.0.1017)Make sure you update the version of
sdk-batch-bom, sdk-stream-bom and sdk-standalone-bom to the latest version.The latest version can be found here.
2.12.20 to 2.13.16.When using QueryApi.getTilesContainingFeatures method it is now possible to
override the maximum value of relative resolution parameter.
Usage:
val queryApi = DataClient().queryApi(catalogHrn, settings)
val startingTiles = Seq(Tile("120", TileType.QUADKEY))
val targetZoomLevel = 8
val parallelization = 1
val maxRelativeResolution = 4
val tilesAsSource: Future[Source[Seq[Tile], NotUsed]] =
queryApi.getTilesContainingFeatures(layerId,
startingTiles,
targetZoomLevel,
parallelization,
Some(context),
maxRelativeResolution)
val response: Future[Seq[Seq[Tile]]] =
Await.result(tilesAsSource, timeout).runWith(Sink.seq[Seq[Tile]])
val tiles: Seq[Tile] = Await.result(response, timeout).flattenNavigation and Road Attributes.
If you use an older map version where the Topology Attributes layer is empty,
you will not receive any exceptions when creating or resolving references.
Instead, you will receive incomplete results.
A new experimental API has been introduced to support the deprecated
Navigation and Road Attributes layers for compatibility with older map versions.
The functions
linear, closedLinear, pointAlongLine, poiWithAccessPoint,and
olr are available in both OlrLocationReferenceCreators andOlrLocationReferenceResolvers. These functions accept a Map Data APIparameter, allowing customization of OLR creation and resolution.
Refer to the Location Library Dev Guide abouts
OLR Migration to Topology Attributes
for more details.
Attributes.
If you use an older map version to create a TMC reference where the Topology
Attributes layer is empty, you'll encounter the following exception:
com.here.platform.location.referencing.tmc.LinearLocationNotRepresentedInTmcException: LinearLocation not represented in TMC..A new experimental API has been introduced to support the deprecated Navigation
Attributes layer for compatibility with older map versions. The functions
tmc,extendedTmc, and piecewiseExtendedTmc in TmcLocationReferenceCreators, aswell as
tmc and extendedTmc in TmcLocationReferenceResolvers, accept a MapData API parameter, enabling customization of TMC creation and resolution.
Refer to the Location Library Dev Guide abouts
TMC Migration to Topology Attributes
for more details.
Fixed an issue affecting proximity searches and map matching on roads with
complex shapes.
The proximity search algorithm in
com.here.platform.location.integration.optimizedmap.geospatial.ProximitySearches.vertexGeometrySegmentsnow identifies additional eligible projections to the same vertex within the
search radius, in cases where the vertex geometry is intricate or curved.
This enhancement improves map matching in scenarios such as:
- Taking curved turns or turning at junctions, especially when input points are offset from the road
- Traveling on roads parallel to others with opposite directions, where input points may be closer to the adjacent road
- Passing over or under bridges (overpasses/underpasses) when input points are precisely located at those structures
These improvements result in more reliable map matching and geometry segment
detection in areas with complex road layouts, with a minor impact on performance
in the affected scenarios.
The Scala 2.13 collections library changed the default Seq type:
scala.Seqis now an alias forscala.collection.immutable.Seq(previously it was an alias forscala.collection.Seq).
All methods that use scala.Seq in their signatures now operate on immutable
sequences.
If you have mutable sequences (e.g. scala.collection.mutable.Seq), you must
explicitly convert them to immutable, for example using the .toSeq method.
Note:.toSeqwill usually create a copy of the collection, which may have
performance implications for large collections.
val mutableSeq: scala.collection.mutable.Seq[Int] = scala.collection.mutable.ArrayBuffer(1, 2, 3)
val immutableSeq: scala.Seq[Int] = mutableSeq.toSeqFor more information on migrating your project to Scala 2.13, refer to the migration guide.
For more information on migrating examples to Scala 2.13, refer to the migration guide.
Add Scala 2.13 support to the following schemas:
RiB schemasReal-Time Traffic SchemaSENSORIS schemaSDII v3 Message SchemaSDII v3 MessageList SchemaSDII Archive Schema.
Added the following RIB schema artifacts to the SDK Bom files:
com.here.schema.rib:named-areas_v2com.here.schema.rib:named-areas_v2_dscom.here.schema.rib:named-areas_v2_javacom.here.schema.rib:named-areas_v2_protocom.here.schema.rib:named-areas_v2_scala_2.13
Added the following RIB schema artifacts to the SDK Bom files:
com.here.schema.rib:named-areas_v2com.here.schema.rib:named-areas_v2_dscom.here.schema.rib:named-areas_v2_javacom.here.schema.rib:named-areas_v2_protocom.here.schema.rib:named-areas_v2_scala_2.13
Added the following RIB schema artifacts to the SDK Bom files:
com.here.schema.rib:named-areas_v2com.here.schema.rib:named-areas_v2_dscom.here.schema.rib:named-areas_v2_javacom.here.schema.rib:named-areas_v2_protocom.here.schema.rib:named-areas_v2_scala_2.13
io.netty:netty-all library from the 4.1.118 version to the 4.1.126 to fix the following vulnerabilities: CVE-2025-55163, CVE-2025-58056.Upgraded Scala from 2.12.20 to 2.13.16.
To support Scala 2.13, the following libraries were upgraded:
com.github.scopt:scopt_${scala.compat.version}— 3.5.0 → 4.0.1com.github.tototoshi:scala-csv_${scala.compat.version}— 1.3.4 → 1.3.6org.jline:jline— 2.14.6 → 3.26.0nl.grons:metrics4-scala_${scala.compat.version}— 4.0.1 → 4.0.7org.clapper:grizzled-slf4j_${scala.compat.version}— 1.3.2 → 1.3.4
In addition, the following Flink-related dependencies were replaced with a single compatibility library to support Scala 2.13:
Replaced:
org.apache.flink:flink-scala_${scala.compat.version}org.apache.flink:flink-streaming-scala_${scala.compat.version}org.apache.flink:flink-table-planner_${scala.compat.version}org.apache.flink:flink-table-api-scala-bridge_${scala.compat.version}
With:
org.flinkextended:flink-scala-api_2.13:1.19.1_1.2.0
io.netty:netty-all library from the 4.1.118 version to the 4.1.126 to fix the following vulnerabilities: CVE-2025-55163, CVE-2025-58056.Upgraded Scala from 2.12.20 to 2.13.16.
To support Scala 2.13, the following libraries were upgraded:
com.github.scopt:scopt_${scala.compat.version}— 3.5.0 → 4.0.1com.github.tototoshi:scala-csv_${scala.compat.version}— 1.3.4 → 1.3.6org.jline:jline— 2.14.6 → 3.26.0nl.grons:metrics4-scala_${scala.compat.version}— 4.0.1 → 4.0.7org.clapper:grizzled-slf4j_${scala.compat.version}— 1.3.2 → 1.3.4
In addition, the following Flink-related dependencies were replaced with a single compatibility library to support Scala 2.13:
Replaced:
org.apache.flink:flink-scala_${scala.compat.version}org.apache.flink:flink-streaming-scala_${scala.compat.version}org.apache.flink:flink-table-planner_${scala.compat.version}org.apache.flink:flink-table-api-scala-bridge_${scala.compat.version}
With:
org.flinkextended:flink-scala-api_2.13:1.19.1_1.2.0
io.netty:netty-all library from the 4.1.118 version to the 4.1.126 to fix the following vulnerabilities: CVE-2025-55163, CVE-2025-58056.Upgraded Scala from 2.12.20 to 2.13.16.
To support Scala 2.13, the following libraries were upgraded:
com.github.scopt:scopt_${scala.compat.version}— 3.5.0 → 4.0.1com.github.tototoshi:scala-csv_${scala.compat.version}— 1.3.4 → 1.3.6org.jline:jline— 2.14.6 → 3.26.0nl.grons:metrics4-scala_${scala.compat.version}— 4.0.1 → 4.0.7org.clapper:grizzled-slf4j_${scala.compat.version}— 1.3.2 → 1.3.4
In addition, the following Flink-related dependencies were replaced with a single compatibility library to support Scala 2.13:
Replaced:
org.apache.flink:flink-scala_${scala.compat.version}org.apache.flink:flink-streaming-scala_${scala.compat.version}org.apache.flink:flink-table-planner_${scala.compat.version}org.apache.flink:flink-table-api-scala-bridge_${scala.compat.version}
With:
org.flinkextended:flink-scala-api_2.13:1.19.1_1.2.0
Data APIs:
interactive-map-v1:1.2.11 config:1.2.11
When using QueryApi.getTilesContainingFeatures method it is now possible to
override the maximum value of relative resolution parameter.
Usage:
val queryApi = DataClient().queryApi(catalogHrn, settings)
val startingTiles = Seq(Tile("120", TileType.QUADKEY))
val targetZoomLevel = 8
val parallelization = 1
val maxRelativeResolution = 4
val tilesAsSource: Future[Source[Seq[Tile], NotUsed]] =
queryApi.getTilesContainingFeatures(layerId,
startingTiles,
targetZoomLevel,
parallelization,
Some(context),
maxRelativeResolution)
val response: Future[Seq[Seq[Tile]]] =
Await.result(tilesAsSource, timeout).runWith(Sink.seq[Seq[Tile]])
val tiles: Seq[Tile] = Await.result(response, timeout).flattenin linear and point along line OLR references could exceed the specification
limit of -0.32768 to 0.32767 degrees, especially on roads near the poles due to
meridian convergence — even for paths shorter than 15km. The fix enforces both
the relative longitude and 15km path length constraints by adding intermediate
reference points in linear references and selecting non-junction points in point
along line references when necessary.
Added support for the Topology Attributes layer.
The new Topology Attributes layer consolidates all attributes currently provided
by the following layers:
- Road Attributes
- Navigation Attributes
- Advanced Navigation Attributes
These existing layers will eventually be deprecated in favor of the new unified
layer.
The Topology Attributes layer is available in the following catalogs:
hrn:here:data::olp-here:here-optimized-map-for-location-library-2(starting from version7521)hrn:here:data::olp-here:om4ll-gt-jpn-prod-v2(starting from version11)hrn:here:data::olp-here-krmpp:om4ll-hae-kor-prod-v2(starting from version3)
Note: If you attempt to access the Topology Attributes layer in a catalog
where its schema does not yet exist, you will encounter the following exception:
java.lang.IllegalArgumentException: Layer 'topologyattributes' is not a
versioned layer.
However, if the catalog does contain the Topology Attributes schema but is
opened with an older map version, the layer will return empty data instead of
throwing an exception.
Added support for curvature and heading as separate attributes.
Adas Attributes layer now provides curvature and heading as separate attributes.
The curvatureHeading attribute is deprecated in favor of the separate
attributes.
The new attributes are available in the following catalogs:
hrn:here:data::olp-here:here-optimized-map-for-location-library-2(starting from version7618)hrn:here:data::olp-here:om4ll-gt-jpn-prod-v2(starting from version12)
Note: If you attempt to access the new attributes in a catalog where they
are not available yet, you will encounter exception similar to this:
java.lang.RuntimeException: AttributeIndex 3 (Curvature) not available in
adasattributes for TileId(1081417). Please check whether you are using an old
map version without this attribute.
Added support for resolving artifacts published with scalaVersion and sbtVersion in their filenames.
The resolver patterns now include:
[organisation]/[module]/[revision]/[artifact]_[scalaVersion]_[sbtVersion]-[revision](-[classifier]).[ext]This allows projects depending on sbt/Scala-specific artifacts to be correctly resolved.
Added support for resolving artifacts published with scalaVersion and sbtVersion in their filenames.
The resolver patterns now include:
[organisation]/[module]/[revision]/[artifact]_[scalaVersion]_[sbtVersion]-[revision](-[classifier]).[ext]This allows projects depending on sbt/Scala-specific artifacts to be correctly resolved.