Data SDK for Java & Scala

Version

Domain

Change

Description

2.85.8

Archetypes

CHANGED

Changed the following archetypes to use the new Stream environment with Flink 2.2.0:

- Streaming Pipeline in Java
- Streaming Pipeline in Scala

2.85.8

Archetypes

FIXED

Fixed Schema Archetype build for ARM architectures.

2.85.8

Data Archiving Library

CHANGED

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 SourceFunction usage with the FLIP-27 Source API
- Updated stream creation from addSource(...) to fromSource(...)

- Sink API migration
- Replaced deprecated SinkFunction with the new Sink V2 API
- Updated usage from addSink(...) to sinkTo(...)

- Function lifecycle changes
- Updated open(Configuration) methods to open(OpenContext) where applicable

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

2.85.8

Data Client Base Library

CHANGED

Updated the library to work with Flink 2.2.0.

2.85.8

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

interactive-map-v1:1.3.4 config:1.3.4

2.85.8

Data Client Library

CHANGED

Migrated the Data Client Library to support Flink 2.2.0.

For more information, see the
Migration Guide

2.85.8

Location Library

CHANGED

Improved tile loading performance by enhancing caching of the most recently used
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.

2.85.8

Location Library

ADDED

Added AttributeAccessor.apply to the Java DSL, providing the same
partition‑attribute extraction capability already available in the Scala DSL.

2.85.8

Location Library

ADDED

Added Traffic Signal attribute to Topology Attributes.

For instructions on how to access the advanced navigation attributes, see the
com.here.platform.location.integration.optimizedmap.graph.PropertyMaps.TopologyAttributes
class and the related methods. Added the specific Java variant through the
com.here.platform.location.integration.optimizedmap.graph.javadsl.PropertyMaps.TopologyAttributes
class.

2.85.8

Examples

CHANGED

Changed the following examples to use the new Stream environment with Flink 2.2.0:

- Archiving SDII Stream Data in Avro Format
- Archiving SDII Stream Data in Parquet Format
- Archiving Sensoris Stream Data in Protobuf Format
- Stream Path Matcher

2.85.8

Batch Libraries

ADDED

Added the following HMC schema artifacts to the SDK Bom files:

- com.here.schema.rib:speed-limits_v2
- com.here.schema.rib:speed-limits_v2_ds
- com.here.schema.rib:speed-limits_v2_java
- com.here.schema.rib:speed-limits_v2_proto
- com.here.schema.rib:speed-limits_v2_scala_2.13

2.85.8

Batch Libraries

REMOVED

Removed the 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.

2.85.8

Batch Libraries

REMOVED

Removed the 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.

2.85.8

Stream Libraries

ADDED

2.85.8

Standalone Libraries

ADDED

2.85.8

Batch dependencies

CHANGED

Upgraded the com.esotericsoftware.kryo:kryo:2.24.0 library to com.esotericsoftware:kryo:5.6.2.

2.85.8

Batch dependencies

CHANGED

Upgraded the org.objenesis:objenesis library from the 3.3 version to the 3.4.

2.85.8

Standalone dependencies

CHANGED

Upgraded the org.apache.avro:avro library from the 1.11.4 version to the 1.11.5 to fix CVE-2025-33042 vulnerability.

2.85.8

Standalone dependencies

CHANGED

Upgraded the com.esotericsoftware.kryo:kryo:2.24.0 library to com.esotericsoftware:kryo:5.6.2.

2.85.8

Standalone dependencies

CHANGED

Upgraded the org.objenesis:objenesis library from the 3.3 version to the 3.4.

2.85.8

Stream dependencies

CHANGED

Upgraded the 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.

2.85.8

Stream dependencies

CHANGED

Upgraded the org.apache.avro:avro library from the 1.11.4 version to the 1.11.5 to fix CVE-2025-33042 vulnerability.

2.85.8

Stream dependencies

CHANGED

Upgraded the org.apache.commons:commons-lang3 library from the 3.12.0 version to the 3.18.0.

2.85.8

Stream dependencies

CHANGED

Upgraded the com.esotericsoftware.kryo:kryo:2.24.0 library to com.esotericsoftware:kryo:5.6.2.

2.85.8

Stream dependencies

CHANGED

Upgraded the org.objenesis:objenesis library from the 3.3 version to the 3.4.

2.85.8

Stream dependencies

CHANGED

Upgraded the com.twitter:chill-protobuf library from the 0.7.6 version to the 0.10.0.

2.85.8

Stream dependencies

CHANGED

Upgraded the com.here.platform:environment-stream:6.0.1 to the com.here.platform:environment-stream:7.0.0 to support Flink 2.2.0.

2.85.8

Stream dependencies

CHANGED

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-annotations
- jackson-core
- jackson-databind
- jackson-dataformat-yaml
- jackson-datatype-jsr310
- jackson-datatype-jdk8
- jackson-module-scala_2.13
- jackson-datatype-json-org

2.84.4

Data Client Base Library

ADDED

Added support for configuring max-requests-per-host for the OkHttpClient
used by BaseClient.
This allows controlling the maximum number of concurrent HTTP requests per host
instead of relying on OkHttp’s default limit.

2.84.4

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

interactive-map-v1:1.3.4 config:1.3.4

2.84.4

Location Library

REMOVED

Removed the deprecated CurvatureHeading attribute from AdasAttributes. Please
use the separate Curvature and Heading attributes instead.

2.84.4

Location Library

REMOVED

Removed no longer supported Japan catalog constant
(hrn:here:data::olp-here:here-optimized-map-for-location-library-japan-2).

2.84.4

Location Library

REMOVED

Removed SimpleConnectivityTransitionProbabilityStrategy class. Please use
DistanceTransitionProbabilityStrategy instead.

Removed distanceWithTransitions method. Please use the other available
overload instead.

2.84.4

Tutorials

CHANGED

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 application
- Correlate Road Attributes to Segment Geometry
- Use Spark connector to read and write data

2.84.4

Examples

CHANGED

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 level
- A Stateful Processing Compiler to Process Input and Feedback Data
- A Compiler to Compute Catalog Differences
- A Compiler to Extract Pedestrian Topologies into Protobuf
- A Compiler to Extract Pedestrian Topologies into GeoJSON

2.84.4

Batch Libraries

ADDED

Added the following Optimized Map schema artifacts to the SDK Bom files:

- com.here.platform.pb.location.optimizedmap:capabilities_v2_java
- com.here.platform.pb.location.optimizedmap:capabilities_v2_proto
- com.here.platform.pb.location.optimizedmap:capabilities_v2_scala_2.13

2.84.4

Stream Libraries

ADDED

2.84.4

Standalone Libraries

ADDED

2.83.3

Data Client Base Library

ADDED

Enhanced ApiRequest.withQueryParam method to support multiple values for the
same query parameter key. Now calling
.withQueryParam("param", "value1").withQueryParam("param", "value2") will
produce a query string like ?param=value1&param=value2 instead of overwriting
the first value.

2.83.3

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

olsRouting-v8 8.146.0

2.83.3

Data Client Base Library

UPDATED

Updated Data Client Base Library to support the latest versions of HERE Platform
Data APIs:

olsRevGeocode-v1 1.0.0

2.83.3

Location Library

ADDED

Added toLocationLineString extension method to Scala LineString like types

2.83.3

Batch Libraries

ADDED

Added the following RIB schema artifacts to the SDK Bom files:

- com.here.schema.rib:cartography-tile-intersections_v2
- com.here.schema.rib:cartography-tile-intersections_v2_ds
- com.here.schema.rib:cartography-tile-intersections_v2_java
- com.here.schema.rib:cartography-tile-intersections_v2_proto
- com.here.schema.rib:cartography-tile-intersections_v2_scala_2.13

2.83.3

Stream Libraries

ADDED

2.83.3

Standalone Libraries

ADDED

2.83.3

Batch dependencies

ADDED

Added the commons-logging:commons-logging:1.3.5 library.

2.83.3

Batch dependencies

CHANGED

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-core
- io.circe:circe-parser
- io.circe:circe-generic

2.83.3

Batch dependencies

CHANGED

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>

2.83.3

Standalone dependencies

ADDED

Added the commons-logging:commons-logging:1.3.5 library.

2.83.3

Standalone dependencies

CHANGED

2.83.3

Standalone dependencies

CHANGED

<dependency>
    <groupId>at.yawk.lz4</groupId>
    <artifactId>lz4-java</artifactId>
    <scope>provided</scope>
</dependency>

2.83.3

Stream dependencies

ADDED

Added the commons-logging:commons-logging:1.3.5 library.

2.83.3

Stream dependencies

CHANGED

2.82.3

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

config:1.3.4

2.82.3

Location Library

CHANGED

Improved the performances of the map matchers with transitions, especially in
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%.

2.82.3

Batch dependencies

CHANGED

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-core
- ch.qos.logback:logback-classic

2.82.3

Standalone dependencies

CHANGED

2.82.3

Standalone dependencies

CHANGED

Upgraded the 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.

2.82.3

Stream dependencies

CHANGED

2.82.3

Stream dependencies

CHANGED

Upgraded the 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.

2.81.5

Archetypes

CHANGED

Changed archetypes to use the new Batch 5.0 environment with Spark 4.0.1.

2.81.5

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

olsRouting-v8 8.79.1

2.81.5

Data Client Base Library

CHANGED

Updated the library to work with Spark 4.0.1.

2.81.5

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

config:1.3.2

2.81.5

Data Client Library

CHANGED

The Data Client Library has been updated to use Spark 4.0.1.

2.81.5

Data Processing Library

CHANGED

Changed the Data Processing Library to use Spark 4.0.1.

2.81.5

Index Compaction Library

CHANGED

The Index Compaction Library has been updated to Spark version 4.0.1

2.81.5

Location Library

CHANGED

Updated the Location Library to support Spark 4.0.1.

2.81.5

Tutorials

CHANGED

Changed the tutorials to use the new 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.

2.81.5

Examples

CHANGED

Changed examples to use the new Batch 5.0 environment with Spark 4.0.1.

2.81.5

Schemas

CHANGED

The latest v4.0.0 OM4LL Schema now use Protobuf 4.32.0.

Be sure to update the schema to the latest version to avoid compatibility issues.

2.81.5

Schemas

CHANGED

The latest v2.1.21 Real-Time Traffic Schema now use Protobuf 4.32.0.

Be sure to update the schema to the latest version to avoid compatibility issues.

2.81.5

Schemas

CHANGED

The latest v2.182.0 Reality Index Base (RiB) Schema now use Protobuf 4.32.0.

Be sure to update the schema to the latest version to avoid compatibility issues.

2.81.5

Schemas

CHANGED

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.

2.81.5

Schemas

CHANGED

The latest v1.1.18 SENSORIS schema now use Protobuf 4.32.0.

Be sure to update the schema to the latest version to avoid compatibility issues.

2.81.5

Schemas

CHANGED

Updated the A Compiler to Extract Pedestrian Topologies into Protobuf example to use Protobuf 4.32.0.

2.81.5

Batch Libraries

ADDED

Added the following RIB schema artifacts to the SDK Bom files:

- com.here.schema.rib:physical-road-surfaces_v2
- com.here.schema.rib:physical-road-surfaces_v2_ds
- com.here.schema.rib:physical-road-surfaces_v2_java
- com.here.schema.rib:physical-road-surfaces_v2_proto
- com.here.schema.rib:physical-road-surfaces_v2_scala_2.13

2.81.5

Batch Libraries

REMOVED

Removed the following RIB schema artifacts from the SDK Bom files:

- com.here.schema.rib:road-surface-attributes_v2
- com.here.schema.rib:road-surface-attributes_v2_ds
- com.here.schema.rib:road-surface-attributes_v2_java
- com.here.schema.rib:road-surface-attributes_v2_proto
- com.here.schema.rib:road-surface-attributes_v2_scala_2.13

2.81.5

Stream Libraries

ADDED

2.81.5

Stream Libraries

REMOVED

2.81.5

Standalone Libraries

ADDED

2.81.5

Standalone Libraries

REMOVED

2.81.5

Batch dependencies

CHANGED

Upgraded the org.checkerframework:checker-qual library from the 3.33.0 version to the 3.43.0.

2.81.5

Batch dependencies

CHANGED

Upgraded the commons-codec:commons-codec library from the 1.17.1 version to the 1.17.2.

2.81.5

Batch dependencies

CHANGED

Upgraded the commons-io:commons-io library from the 2.16.1 version to the 2.18.0.

2.81.5

Batch dependencies

CHANGED

Upgraded the 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.

2.81.5

Batch dependencies

CHANGED

Upgraded the com.here.platform:environment-batch_2.13:4.0.15 to the com.here.platform:environment-batch_2.13:5.0.0 to support
Spark 4.0.1.

2.81.5

Batch dependencies

CHANGED

Upgraded the com.google.errorprone:error_prone_annotations library from the 2.5.1 version to the 2.36.0.

2.81.5

Batch dependencies

CHANGED

Upgraded the com.google.code.gson:gson library from the 2.8.9 version to the 2.11.0.

2.81.5

Batch dependencies

CHANGED

Upgraded the com.google.guava:guava library from the 31.1.1-jre version to the 33.4.0-jre.

2.81.5

Batch dependencies

CHANGED

Upgraded the com.google.j2objc:j2objc-annotations library from the 2.8 version to the 3.0.0.

2.81.5

Batch dependencies

CHANGED

Upgraded the following com.fasterxml.jackson.core libraries from the 2.14.2 to the 2.18.2:

- jackson-annotations
- jackson-core
- jackson-databind
- jackson-dataformat-yaml
- jackson-datatype-jsr310
- jackson-datatype-jdk8
- jackson-module-scala_2.13
- jackson-datatype-json-org

2.81.5

Batch dependencies

CHANGED

Upgraded the org.jline:jline library from the 3.26.0 version to the 3.27.1.

2.81.5

Batch dependencies

CHANGED

Upgraded the joda-time:joda-time library from the 2.12.2 version to the 2.13.0.

2.81.5

Batch dependencies

CHANGED

Upgraded the 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.

2.81.5

Batch dependencies

CHANGED

Upgraded the ch.qos.logback:logback-classic and ch.qos.logback:logback-core libraries from the 1.3.14 version to the 1.4.14.

2.81.5

Batch dependencies

CHANGED

Upgraded the io.dropwizard.metrics:metrics-core library from the 3.1.5 version to the 4.2.30.

2.81.5

Batch dependencies

CHANGED

Upgraded the io.netty:netty-all library from the 4.1.118 version to the 4.1.126.

2.81.5

Batch dependencies

CHANGED

Upgraded the org.objenesis:objenesis library from the 3.2 version to the 3.3.

2.81.5

Batch dependencies

CHANGED

Upgraded the org.scala-lang.modules:scala-parser-combinators_2.13 library from the 2.4.1 version to the 2.4.0.

2.81.5

Batch dependencies

CHANGED

Upgraded the org.scala-lang.modules:scala-xml_2.13 library from the 2.4.0 version to the 2.3.0.

2.81.5

Batch dependencies

CHANGED

Upgraded the org.yaml:snakeyaml library from the 2.0 version to the 2.3.

2.81.5

Batch dependencies

CHANGED

Upgraded the org.xerial.snappy:snappy-java library from the 1.1.10.5 version to the 1.1.10.7.

2.81.5

Standalone dependencies

CHANGED

Upgraded the following 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.

2.81.5

Standalone dependencies

CHANGED

Upgraded the org.checkerframework:checker-qual library from the 3.33.0 version to the 3.43.0.

2.81.5

Standalone dependencies

CHANGED

Upgraded the commons-codec:commons-codec library from the 1.17.1 version to the 1.17.2.

2.81.5

Standalone dependencies

CHANGED

Upgraded the commons-io:commons-io library from the 2.16.1 version to the 2.18.0.

2.81.5

Standalone dependencies

CHANGED

2.81.5

Standalone dependencies

CHANGED

Upgraded the com.google.errorprone:error_prone_annotations library from the 2.5.1 version to the 2.36.0.

2.81.5

Standalone dependencies

CHANGED

Upgraded the com.google.code.gson:gson library from the 2.8.9 version to the 2.11.0.

2.81.5

Standalone dependencies

CHANGED

Upgraded the com.google.guava:guava library from the 31.1.1-jre version to the 33.4.0-jre.

2.81.5

Standalone dependencies

CHANGED

Upgraded the following 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-25638

2.81.5

Standalone dependencies

CHANGED

Upgraded the com.google.j2objc:j2objc-annotations library from the 2.8 version to the 3.0.0.

2.81.5

Standalone dependencies

CHANGED

Upgraded the following com.fasterxml.jackson.core libraries from the 2.14.2 version to the 2.18.2:

- jackson-annotations
- jackson-core
- jackson-databind
- jackson-dataformat-yaml
- jackson-datatype-jsr310
- jackson-datatype-jdk8
- jackson-module-scala_2.13
- jackson-datatype-json-org

2.81.5

Standalone dependencies

CHANGED

Upgraded the org.jline:jline library from the 3.26.0 version to the 3.27.1.

2.81.5

Standalone dependencies

CHANGED

Upgraded the joda-time:joda-time library from the 2.12.2 version to the 2.13.0.

2.81.5

Standalone dependencies

CHANGED

Upgraded the 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.

2.81.5

Standalone dependencies

CHANGED

Upgraded the ch.qos.logback:logback-classic and ch.qos.logback:logback-core libraries from the 1.3.14 version to the 1.4.14.

2.81.5

Standalone dependencies

CHANGED

Upgraded the io.dropwizard.metrics:metrics-core library from the 3.1.5 version to the 4.2.30.

2.81.5

Standalone dependencies

CHANGED

Upgraded the io.netty:netty-all library from the 4.1.118 version to the 4.1.126.

2.81.5

Standalone dependencies

CHANGED

Upgraded the org.objenesis:objenesis library from the 3.2 version to the 3.3.

2.81.5

Standalone dependencies

CHANGED

Upgraded the org.scala-lang.modules:scala-parser-combinators_2.13 library from the 2.4.1 version to the 2.4.0.

2.81.5

Standalone dependencies

CHANGED

Upgraded the org.scala-lang.modules:scala-xml_2.13 library from the 2.4.0 version to the 2.3.0.

2.81.5

Standalone dependencies

CHANGED

Upgraded the org.yaml:snakeyaml library from the 2.0 version to the 2.3.

2.81.5

Standalone dependencies

CHANGED

Upgraded the org.xerial.snappy:snappy-java library from the 1.1.10.5 version to the 1.1.10.7.

2.81.5

Stream dependencies

CHANGED

Upgraded the org.checkerframework:checker-qual library from the 3.33.0 version to the 3.43.0.

2.81.5

Stream dependencies

CHANGED

Upgraded the commons-codec:commons-codec library from the 1.17.1 version to the 1.17.2.

2.81.5

Stream dependencies

CHANGED

Upgraded the commons-io:commons-io library from the 2.16.1 version to the 2.18.0.

2.81.5

Stream dependencies

CHANGED

2.81.5

Stream dependencies

CHANGED

Upgraded the com.google.errorprone:error_prone_annotations library from the 2.5.1 version to the 2.36.0.

2.81.5

Stream dependencies

CHANGED

Upgraded the com.google.code.gson:gson library from the 2.8.9 version to the 2.11.0.

2.81.5

Stream dependencies

CHANGED

Upgraded the com.google.guava:guava library from the 31.1.1-jre version to the 33.4.0-jre.

2.81.5

Stream dependencies

CHANGED

Upgraded the com.google.j2objc:j2objc-annotations library from the 2.8 version to the 3.0.0.

2.81.5

Stream dependencies

CHANGED

Upgraded the org.jline:jline library from the 3.26.0 version to the 3.27.1.

2.81.5

Stream dependencies

CHANGED

Upgraded the joda-time:joda-time library from the 2.12.2 version to the 2.13.0.

2.81.5

Stream dependencies

CHANGED

Upgraded the 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.

2.81.5

Stream dependencies

CHANGED

Upgraded the ch.qos.logback:logback-classic and ch.qos.logback:logback-core libraries from the 1.3.14 version to the 1.4.14.

2.81.5

Stream dependencies

CHANGED

Upgraded the io.dropwizard.metrics:metrics-core library from the 3.1.5 version to the 4.2.30.

2.81.5

Stream dependencies

CHANGED

Upgraded the io.netty:netty-all library from the 4.1.118 version to the 4.1.126.

2.81.5

Stream dependencies

CHANGED

Upgraded the org.objenesis:objenesis library from the 3.2 version to the 3.3.

2.81.5

Stream dependencies

CHANGED

Upgraded the org.scala-lang.modules:scala-parser-combinators_2.13 library from the 2.4.1 version to the 2.4.0.

2.81.5

Stream dependencies

CHANGED

Upgraded the org.scala-lang.modules:scala-xml_2.13 library from the 2.4.0 version to the 2.3.0.

2.81.5

Stream dependencies

CHANGED

Upgraded the org.yaml:snakeyaml library from the 2.0 version to the 2.3.

2.81.5

Stream dependencies

CHANGED

Upgraded the org.xerial.snappy:snappy-java library from the 1.1.10.5 version to the 1.1.10.7.

2.80.2

Archetypes

CHANGED

Changed the archetypes to use SDK BOM with Scala 2.13 dependencies.

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.80.2

Data Client Base Library

CHANGED

Changed Scala version from 2.12.20 to 2.13.16.

2.80.2

Data Client Library

ADDED

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).flatten

2.80.2

Data Client Library

CHANGED

The Data Client Library has been updated to Scala version 2.13.16.

2.80.2

Index Compaction Library

CHANGED

The Index Compaction Library has been updated to Scala version 2.13.16.

2.80.2

Location Library

CHANGED

OLR creators and resolvers now use Topology Attributes instead of the deprecated
Navigation 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 and
OlrLocationReferenceResolvers. These functions accept a Map Data API
parameter, allowing customization of OLR creation and resolution.

Refer to the Location Library Dev Guide abouts
OLR Migration to Topology Attributes
for more details.

2.80.2

Location Library

CHANGED

TMC creators now use Topology attributes instead of deprecated Navigation
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, as
well as tmc and extendedTmc in TmcLocationReferenceResolvers, accept a Map
Data 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.

2.80.2

Location Library

FIXED

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.vertexGeometrySegments

now 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.

2.80.2

Location Library

CHANGED

The Scala 2.13 collections library changed the default Seq type:

- scala.Seq is now an alias for scala.collection.immutable.Seq (previously
it was an alias for scala.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: .toSeq will 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.toSeq

2.80.2

Tutorials

CHANGED

Changed the tutorials to use SDK BOM files with Scala 2.13.

For more information on migrating your project to Scala 2.13, refer to the migration guide.

2.80.2

Examples

CHANGED

Changed the examples using SDK BOM files with Scala 2.13.

For more information on migrating examples to Scala 2.13, refer to the migration guide.

2.80.2

Schemas

ADDED

Add Scala 2.13 support to the following schemas:

- RiB schemas
- Real-Time Traffic Schema
- SENSORIS schema
- SDII v3 Message Schema
- SDII v3 MessageList Schema
- SDII Archive Schema.

2.80.2

Batch Libraries

ADDED

Added the following RIB schema artifacts to the SDK Bom files:

- com.here.schema.rib:named-areas_v2
- com.here.schema.rib:named-areas_v2_ds
- com.here.schema.rib:named-areas_v2_java
- com.here.schema.rib:named-areas_v2_proto
- com.here.schema.rib:named-areas_v2_scala_2.13

2.80.2

Batch Libraries

CHANGED

Changed the SDK BOM to support Scala 2.13.

2.80.2

Stream Libraries

ADDED

2.80.2

Stream Libraries

CHANGED

Changed the SDK BOM to support Scala 2.13.

2.80.2

Standalone Libraries

ADDED

2.80.2

Standalone Libraries

CHANGED

Changed the SDK BOM to support Scala 2.13.

2.80.2

Batch dependencies

CHANGED

Upgraded the 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.

2.80.2

Batch dependencies

CHANGED

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.1
- com.github.tototoshi:scala-csv_$\{scala.compat.version\} — 1.3.4 → 1.3.6
- org.jline:jline — 2.14.6 → 3.26.0
- nl.grons:metrics4-scala_$\{scala.compat.version\} — 4.0.1 → 4.0.7
- org.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

2.80.2

Standalone dependencies

CHANGED

Upgraded the 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.

2.80.2

Standalone dependencies

CHANGED

2.80.2

Stream dependencies

CHANGED

Upgraded the 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.

2.80.2

Stream dependencies

CHANGED

2.79.3

Data Client Base Library

REMOVED

Removed empty array-type query parameters from all outgoing requests

2.79.3

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

interactive-map-v1:1.2.11 config:1.2.11

2.79.3

Data Client Library

ADDED

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).flatten

2.79.3

Location Library

FIXED

Fixed an issue where the relative longitude between consecutive reference points
in 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.

2.79.3

Location Library

ADDED

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 version 7521)
- hrn:here:data::olp-here:om4ll-gt-jpn-prod-v2 (starting from version 11)
- hrn:here:data::olp-here-krmpp:om4ll-hae-kor-prod-v2 (starting from version
3)

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.

2.79.3

Location Library

ADDED

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 version 7618)
- hrn:here:data::olp-here:om4ll-gt-jpn-prod-v2 (starting from version 12)

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.

2.79.3

Tutorials

CHANGED

Updated SBT version to 1.9.9.
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.

2.79.3

Examples

CHANGED

2.78.2

Location Library

FIXED

Fixed incorrect relative coordinates for the last reference point in case of
very long OLR point along line location references.

The change affects only encoding point along line and point of interest
references, i.e. the following creators:

- com.here.platform.location.referencing.OlrLocationReferenceCreators.pointAlongLine
- com.here.platform.location.referencing.LocationReferenceCreators.olrPointAlongLine
- com.here.platform.location.referencing.OlrLocationReferenceCreators.poiWithAccessPoint
- com.here.platform.location.referencing.LocationReferenceCreators.olrPoiWithAccessPoint

and only in case the input point is at a road longer than 15km without any
junction with accessible roads. This is a case when non-junction reference
points are used to fulfill the 15km limit specified for OLR distances.

2.78.2

Location Library

FIXED

Fixed incorrect intermediate points in OLR linear location in case of very long
roads.

The change affects only encoding linear location references, i.e. the following
creators:

- com.here.platform.location.referencing.OlrLocationReferenceCreators.linear
- com.here.platform.location.referencing.OlrLocationReferenceCreators.closedLinear
- com.here.platform.location.referencing.LocationReferenceCreators.olrLinear
- com.here.platform.location.referencing.LocationReferenceCreators.olrClosedLinear

and only in case there is a road longer than 15km in the input and the end of
the reference is more than 15km away from the end of this road. After the fix
the distances between intermediate points are not breaching 15km limit.

2.77.3

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

config:1.2.11

2.77.3

Data Client Library

FIXED

Fixed an issue affecting partitions larger than 2GB when using
ReadEngine.getDataAsSource. Although this method is intended to support large
partitions, it previously failed due to internal use of arrays, which are
limited to 2GB in size by the JVM.

The fix introduces a new, stream-based decoding method in the decoder:

def decode(partition: Partition, byteSource: Source[ByteString, NotUsed])(
    implicit ctx: ExecutionContext,
    materializer: Materializer): Source[ByteString, NotUsed]

This method accepts a Source[ByteString] as input for the encoded data and
produces a Source[ByteString] of the decoded output, allowing it to handle
large partitions efficiently.

Note: If you're using existing custom decoders with
ReadEngine.getDataAsSource, you will need to implement this new decode method
to ensure compatibility.

2.76.4

Archetypes

FIXED

Fixed Schema Archetype compatibility with Maven 3.9.1 and later.

2.76.4

Data Client Base Library

FIXED

Fixed invalid behaviour in the JSON decoder that caused nested JSON properties
to be decoded with incorrect types.

2.76.4

Location Library

ADDED

Added BoundingBoxSearch, which allows to search for vertices via a bounding
box.

2.76.4

Location Library

CHANGED

With the upgrade from JDK 8 to JDK 17 proximity search could sometimes return
results in a different order. The following factory function is affected:

com.here.platform.location.integration.optimizedmap.geospatial.ProximitySearches.vertexGeometrySegments

The change could also affect map matchers in rare cases.

2.76.4

Batch Libraries

ADDED

Added the com.here.account:here-oauth-client library to the SDK BOM files.

2.76.4

Stream Libraries

ADDED

Added the com.here.account:here-oauth-client library to the SDK BOM files.

2.76.4

Standalone Libraries

ADDED

Added the com.here.account:here-oauth-client library to the SDK BOM files.

2.76.4

Batch dependencies

ADDED

Added the libraries com.fasterxml.jackson.datatype:jackson-datatype-json-org:2.14.2 and com.fasterxml.jackson.module:jackson-module-scala_2.12:2.14.2.

2.76.4

Standalone dependencies

ADDED

Added the libraries com.fasterxml.jackson.datatype:jackson-datatype-json-org:2.14.2 and com.fasterxml.jackson.module:jackson-module-scala_2.12:2.14.2.

2.76.4

Stream dependencies

ADDED

Added the libraries com.fasterxml.jackson.datatype:jackson-datatype-json-org:2.14.2 and com.fasterxml.jackson.module:jackson-module-scala_2.12:2.14.2.

2.75.5

Archetypes

CHANGED

Changed the minimum required Java version from 8 to 17.

2.75.5

Data Archiving Library

CHANGED

Changed the minimum required Java version from 8 to 17.

2.75.5

Data Client Base Library

CHANGED

Changed the minimum required Java version from 8 to 17.

2.75.5

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

config:1.2.11

2.75.5

Data Client Library

CHANGED

Changed the minimum required Java version from 8 to 17.

2.75.5

Data Client Library

ADDED

Added the
com.here.platform.data.client.flink.serializers.ScalaSomeSerializer.scala
class for use in Stream 6.0 applications when encountering the exception:

Unable to create serializer "com.esotericsoftware.kryo.serializers.FieldSerializer" for class: scala.Some.

For details on how to integrate this serializer into your application, refer to
the
Flink Connector Migration Guide.

2.75.5

Data Processing Library

CHANGED

Changed the minimum required Java version from 8 to 17.

2.75.5

Index Compaction Library

CHANGED

Changed the minimum required Java version from 8 to 17.

2.75.5

Location Library

CHANGED

Changed
com.here.platform.location.integration.optimizedmap.advancednavigationattributes.RailwayCrossing
to include also Unspecified value.

In Scala, if you are using exhaustive match-case, you will encounter a
compilation error: please ensure all match-case statements are updated to handle
the new Unspecified value.

2.75.5

Location Library

ADDED

Added support for retaining only the required attributes to reduce memory usage.

Added the following functions to the OptimizedMapCatalog DSL:

- withRoadAttributes
- withAdasAttributes
- withNavigationAttributes
- withAdvancedNavigationAttributes

Refer to the Location Library Dev Guide about
cache configuration
for more details.

2.75.5

Location Library

CHANGED

The withVersionedLayerReadersCache method in OptimizedMapCatalog has been
deprecated. A new overload is available that also accepts a
VersionedLayerReadersConfiguration, allowing consistent configuration between
caches and the OptimizedMapCatalog.

For more information, see the
cache configuration
section in the Location Library Developer Guide.

2.75.5

Location Library

CHANGED

Changed the minimum required Java version from 8 to 17.

2.75.5

Tutorials

CHANGED

Changed the minimum required Java version from 8 to 17.

2.75.5

Examples

CHANGED

Changed the minimum required Java version from 8 to 17.

2.75.5

Schemas

CHANGED

Changed the minimum required Java version from 8 to 17 for the following schemas:

- Real Time Traffic Incident's Schemas 2.1.19
- RIB Schemas 2.166.1
- SDII Schemas 4.2.29
- SDII Archive Schemas 2.2.41
- Sensoris Schemas 1.1.13
- Optimizedmap Schemas 2.8.6

2.75.5

Batch dependencies

CHANGED

Upgraded Java version from 1.8 to 17.

2.75.5

Standalone dependencies

CHANGED

Upgraded Java version from 1.8 to 17.

2.75.5

Stream dependencies

CHANGED

Upgraded Java version from 1.8 to 17.

2.74.4

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

blob:1.2.11 blob-v2:1.2.11 metadata:1.2.11 config:1.2.11

2.74.4

Data Client Library

ADDED

The client library now supports automatic calculation of message digests for
integrity verification for data uploads. Digest algorithm can be used as a data
integrity check to verify that the data received by server is the same data that
was originally sent by the client.

You can choose one of the following Secure Hash Algorithms (SHA) or Cyclic
Redundancy Check (CRC) checksum algorithms to calculate the digest value:

- CRC-32C (default)
- MD5
- SHA1
- SHA256

A new configuration option
('here.platform.data-client.blobstore.digest-algorithm') allows users to choose
the desired digest algorithm or disable integrity checking by setting it to
NONE.

2.74.4

Location Library

CHANGED

2.74.4

Location Library

ADDED

2.74.4

Location Library

CHANGED

2.74.4

Schemas

ADDED

Added the ROAD_ATTRIBUTE_TRANSPORT, ROAD_ATTRIBUTE_GARAGE, ROAD_ATTRIBUTE_CAR_PARK, and ROAD_ATTRIBUTE_RESTRICTED_AREA road attributes to the sdii_v3 schema.

2.74.4

Batch Libraries

ADDED

Added the following RIB schema artifacts to the SDK Bom files:

- topology-attributes_v2
- topology-attributes_v2_ds
- topology-attributes_v2_java
- topology-attributes_v2_proto
- topology-attributes_v2_scala_2.12
- topology-tile-intersections_v2
- topology-tile-intersections_v2_ds
- topology-tile-intersections_v2_java
- topology-tile-intersections_v2_proto
- topology-tile-intersections_v2_scala_2.12

2.74.4

Stream Libraries

ADDED

2.74.4

Standalone Libraries

ADDED

2.74.4

Batch dependencies

ADDED

Added the org.apache.pekko:pekko-protobuf-v3_2.12:1.1.2 library.

2.74.4

Batch dependencies

CHANGED

Upgraded the following org.apache.pekko libraries from the 1.0.1 version to the 1.1.0:

- org.apache.pekko:pekko-http-core_2.12
- org.apache.pekko:pekko-http_2.12

2.74.4

Batch dependencies

CHANGED

Upgraded the following org.apache.pekko libraries from the 1.0.2 version to the 1.1.2:

- org.apache.pekko:pekko-slf4j_2.12
- org.apache.pekko:pekko-stream_2.12
- org.apache.pekko:pekko-actor_2.12

2.74.4

Standalone dependencies

ADDED

Added the org.apache.pekko:pekko-protobuf-v3_2.12:1.1.2 library.

2.74.4

Standalone dependencies

CHANGED

Upgraded the following org.apache.pekko libraries from the 1.0.1 version to the 1.1.0:

- org.apache.pekko:pekko-http-core_2.12
- org.apache.pekko:pekko-http_2.12

2.74.4

Standalone dependencies

CHANGED

2.74.4

Stream dependencies

ADDED

Added the org.apache.pekko:pekko-protobuf-v3_2.12:1.1.2 library.

2.74.4

Stream dependencies

CHANGED

Upgraded the following org.apache.pekko libraries from the 1.0.1 version to the 1.1.0:

- org.apache.pekko:pekko-http-core_2.12
- org.apache.pekko:pekko-http_2.12

2.74.4

Stream dependencies

CHANGED

2.74.4

Stream dependencies

CHANGED

Upgraded the com.here.platform:environment-stream_2.12:6.0.0 to the com.here.platform:environment-stream_2.12:6.0.1 to support
Flink 1.19.2.

2.74.4

Stream dependencies

CHANGED

Upgraded the following org.apache.flink libraries from the 1.19.1 version to the 1.19.2:

- org.apache.flink:flink-scala_2.12
- org.apache.flink:flink-streaming-scala__2.12
- org.apache.flink:flink-table-planner_2.12
- org.apache.flink:flink-table-api-scala-bridge_2.12

2.73.5

Archetypes

ADDED

Added details on how to handle backward compatibility issues in the message of the HERE Proto Validate plugin when a proto backward compatibility issue occurs.

2.73.5

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

config:1.2.11

2.73.5

Data Processing Library

FIXED

Fixed bug in RefTreeCompiler and in DeltaSet resolveReferences transformation that caused keys from non-subject
layers to be passed to the compileInFn method or to be leaked into the DeltaSet result. This could happen during
incremental compilation in case a non-subject layer in the RefTree had the same layer ID as a subject layer.

2.73.5

Batch dependencies

CHANGED

Upgraded the com.here.platform:environment-batch_2.12:4.0.11 to the com.here.platform:environment-batch_2.12:4.0.12 to support
Spark 3.4.4.

2.73.5

Batch dependencies

CHANGED

Upgraded the io.netty:netty-all library from the 4.1.113.Final version to the 4.1.118.Final to fix CVE-2025-24970 vulnerability.

2.73.5

Standalone dependencies

CHANGED

Upgraded the io.netty:netty-all library from the 4.1.113.Final version to the 4.1.118.Final to fix CVE-2025-24970 vulnerability.

2.73.5

Stream dependencies

CHANGED

Upgraded the io.netty:netty-all library from the 4.1.113.Final version to the 4.1.118.Final to fix CVE-2025-24970 vulnerability.

2.72.4

Archetypes

CHANGED

Changed the following archetypes to use the new Stream environment with Flink 1.19.1:

- Streaming Pipeline in Java
- Streaming Pipeline in Scala

2.72.4

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

config:1.2.10

2.72.4

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

config:1.2.11

2.72.4

Data Client Library

CHANGED

The Data Client Library has been updated to Flink version 1.19.1. For more
details, refer to the migration guide:
Flink 1.19 migration guide

2.72.4

Data Client Library

ADDED

Added the ttl property to the ObjectStoreLayerType class, enabling setting
TTL for Object Store layer.

2.72.4

Data Client Library

ADDED

Added the encryptionType property to the RawObjectStoreProperties and
VersionedLayerProperties class, enabling setting type of encryption for
objectstore and versioned layers during layer creation.

2.72.4

Data Processing Library

FIXED

Fixed bug in DirectMToNCompiler which caused compileInFn to be called for every input partition even in case of
incremental compilation.

2.72.4

Tutorials

CHANGED

Changed the following tutorials to use the new Stream environment with Flink 1.19.1:

- Develop Flink Application
- Run a Flink application on the platform
- Subscribe to catalog and layer-level changes
- Use Flink connector to read and write data

For details on migrating Java and Scala projects to Flink 1.19.1, refer to the migration guide.

2.72.4

Examples

CHANGED

Changed the following examples to use the new Stream environment with Flink 1.19.1:

- Archiving SDII Stream Data in Avro Format
- Archiving SDII Stream Data in Parquet Format
- Archiving Sensoris Stream Data in Protobuf Format
- Stream Path Matcher

For details on migrating Java and Scala projects to Flink 1.19.1, refer to the migration guide.

2.72.4

Batch dependencies

ADDED

Added the org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.9.10 library to resolve a dependency conflict in com.squareup.okhttp3:okhttp:4.12.0 library.

2.72.4

Batch dependencies

CHANGED

Upgraded the following org.slf4j libraries from the 2.0.6 version to the 2.0.16:

- com.fasterxml.jackson.core:jackson-annotations
- com.fasterxml.jackson.core:jackson-core
- com.fasterxml.jackson.core:jackson-databind
- com.fasterxml.jackson.core:jackson-dataformat-yaml
- com.fasterxml.jackson.core:jackson-datatype-jsr310

2.72.4

Standalone dependencies

ADDED

Added the org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.9.10 library to resolve a dependency conflict in com.squareup.okhttp3:okhttp:4.12.0 library.

2.72.4

Standalone dependencies

CHANGED

Upgraded the following com.fasterxml.jackson.core libraries from the 2.12.7 version to the 2.14.2:

- com.fasterxml.jackson.core:jackson-annotations
- com.fasterxml.jackson.core:jackson-core
- com.fasterxml.jackson.core:jackson-databind
- com.fasterxml.jackson.core:jackson-dataformat-yaml
- com.fasterxml.jackson.core:jackson-datatype-jsr310

2.72.4

Standalone dependencies

CHANGED

2.72.4

Standalone dependencies

CHANGED

Upgraded the com.squareup.okhttp3 library from the 3.12.10 version to the 4.12.0 version.

2.72.4

Stream dependencies

ADDED

Added the following org.apache.flink libraries:

- org.apache.flink:flink-scala_2.12:1.19.1
- org.apache.flink:flink-streaming-scala_2.12:1.19.1
- org.apache.flink:flink-table-api-scala-bridge_2.12:1.19.1
- org.apache.flink:flink-table-planner_2.12:1.19.1

2.72.4

Stream dependencies

ADDED

Added the org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.9.10 library to resolve a dependency conflict in com.squareup.okhttp3:okhttp:4.12.0 library.

2.72.4

Stream dependencies

CHANGED

Upgraded the com.here.platform:environment-stream_2.12:5.0.3 to the com.here.platform:environment-stream_2.12:6.0.0 to support
Flink 1.19.1.

2.72.4

Stream dependencies

CHANGED

Upgraded the following com.fasterxml.jackson.core libraries from the 2.12.1 version to the 2.14.2:

- com.fasterxml.jackson.core:jackson-annotations
- com.fasterxml.jackson.core:jackson-core
- com.fasterxml.jackson.core:jackson-databind
- com.fasterxml.jackson.core:jackson-dataformat-yaml
- com.fasterxml.jackson.core:jackson-datatype-jsr310

2.72.4

Stream dependencies

CHANGED

2.72.4

Stream dependencies

CHANGED

Upgraded the org.apache.commons:commons-lang3 library from the 3.3.2 version to the 3.12.0 version.

2.72.4

Stream dependencies

CHANGED

Upgraded the com.squareup.okhttp3 library from the 3.12.10 version to the 4.12.0 version.

2.71.8

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

config:1.2.10

2.71.8

Data Client Library

ADDED

Added the ttl property to the ObjectStoreLayerType class, enabling setting
TTL for Object Store layer.

2.70.5

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

config:1.2.9

2.70.5

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

config:1.2.9

2.70.5

Data Client Library

ADDED

Added configuration key:
here.platform.data-client.await-stream-subscription-consumption-timeout to set
the timeout to wait for stream subscription to be consumed. it has the default
value 1 minute (60 seconds).

2.70.5

Standalone dependencies

CHANGED

Upgraded the org.apache.avro:avro library from the 1.11.3 version to the 1.11.4.

2.70.5

Standalone dependencies

CHANGED

Upgraded the org.apache.parquet:parquet-avro library from the 1.14.1 version to the 1.14.4.

2.70.5

Standalone dependencies

CHANGED

Upgraded the following Scala libraries from the 2.12.17 version to the 2.12.20 version:
- org.scala-lang:scala-compiler
- org.scala-lang:scala-library
- org.scala-lang:scala-reflect
- org.scala-lang:scalap

2.70.5

Stream dependencies

CHANGED

Upgraded the org.apache.avro:avro library from the 1.11.3 version to the 1.11.4.

2.70.5

Stream dependencies

CHANGED

Upgraded the org.apache.parquet:parquet-avro library from the 1.14.1 version to the 1.14.4.

2.69.5

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

config:1.2.9

2.69.5

Data Client Library

ADDED

2.69.5

Batch dependencies

ADDED

Added the org.checkerframework:checker-qual:3.33.0 library.

2.69.5

Batch dependencies

ADDED

Added the com.google.guava:guava:32.1.1-jre library.

2.69.5

Batch dependencies

CHANGED

Upgraded the commons-codec:commons-codec library from the 1.15 version to 1.17.1.

2.69.5

Batch dependencies

CHANGED

Upgraded the commons-io:commons-io library from the 2.11.0 version to 2.16.1.

2.69.5

Batch dependencies

CHANGED

Upgraded the org.apache.commons:commons-lang3 library from the 3.12.0 version to 3.17.0.

2.69.5

Standalone dependencies

ADDED

Added the org.checkerframework:checker-qual:3.33.0 library.

2.69.5

Standalone dependencies

ADDED

Added the com.google.guava:guava:32.1.1-jre library.

2.69.5

Standalone dependencies

ADDED

Added the com.github.luben:zstd-jni:1.5.6-2 library to align version with org.apache.parquet:parquet-avro:1.14.1.

2.69.5

Standalone dependencies

CHANGED

Upgraded the org.apache.avro:avro library from the 1.10.0 version to the 1.11.3.

2.69.5

Standalone dependencies

CHANGED

Upgraded the commons-codec:commons-codec library from the 1.15 version to 1.17.1.

2.69.5

Standalone dependencies

CHANGED

Upgraded the commons-io:commons-io library from the 2.11.0 version to 2.16.1.

2.69.5

Standalone dependencies

CHANGED

Upgraded the org.apache.commons:commons-lang3 library from the 3.12.0 version to 3.17.0.

2.69.5

Standalone dependencies

CHANGED

Upgraded the org.apache.hadoop:hadoop-client library from the 3.3.4 version to the 3.3.6.

2.69.5

Standalone dependencies

CHANGED

Upgraded the org.apache.parquet:parquet-avro library from the 1.10.1 version to the 1.14.1.

2.69.5

Stream dependencies

ADDED

Added the org.checkerframework:checker-qual:3.33.0 library.

2.69.5

Stream dependencies

ADDED

Added the com.google.guava:guava:32.1.1-jre library.

2.69.5

Stream dependencies

ADDED

Added the com.github.luben:zstd-jni:1.5.6-2 library to align version with org.apache.parquet:parquet-avro:1.14.1.

2.69.5

Stream dependencies

CHANGED

Upgraded the org.apache.avro:avro library from the 1.10.0 version to the 1.11.3.

2.69.5

Stream dependencies

CHANGED

Upgraded the commons-codec:commons-codec library from the 1.15 version to 1.17.1.

2.69.5

Stream dependencies

CHANGED

Upgraded the commons-io:commons-io library from the 2.11.0 version to 2.16.1.

2.69.5

Stream dependencies

CHANGED

Upgraded the org.apache.maven.plugins:maven-shade-plugin library from the 3.2.1 version to the 3.6.0 to support multi-release jars.

2.69.5

Stream dependencies

CHANGED

Upgraded the org.apache.parquet:parquet-avro library from the 1.10.1 version to the 1.14.1.

2.68.3

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

config:1.2.9

2.68.3

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

metadata:1.2.9 config:1.2.9

2.68.3

Data Client Library

CHANGED

Due to Akka's licensing model change, along with the outdated and potentially
vulnerable Akka 2.5.32, the Data Client Library has been migrated to Apache
Pekko, an open-source fork based on Akka 2.6.x.

To migrate your existing code, follow this migration path:

- Akka 2.5.32 → Akka 2.6.21 → Pekko 1.0.2.

For detailed migration guidelines:

- Migrating from Akka 2.5.32 to Akka 2.6.21: see
Akka Migration Guide
- Migrating from Akka 2.6.21 to Pekko 1.0.2: see
Pekko Migration Guide

2.68.3

Data Client Library

ADDED

Added the ttlDays property to the AutomaticVersionDeletion class, enabling
the setting of TTL for catalog versions.

2.68.3

Data Processing Library

FIXED

Fixed bug in outerJoin transformation which caused a Spark exception when the upstream deltaset is persisted with
a storage level different from intermediateStorageLevel.

2.68.3

Location Library

CHANGED

Changed standalone data loaders API to use pekko actor system.

Migration from Akka to Pekko causes a change in the API of the following
classes:

- com.here.platform.location.dataloader.standalone.StandaloneByteArrayTileLoader
- com.here.platform.location.dataloader.standalone.StandaloneCatalog

Currently, org.apache.pekko.actor.ActorSystem needs to be provided to these
classes instead of akka.actor.ActorSystem.

2.68.3

Tutorials

CHANGED

Migrated HERE SDK for Java and Scala from Apache Akka 2.5.32 to Apache Pekko 1.0.2.

To migrate your project, follow these steps:

1. Use 2.68.3 or newer version of SDK BOM.

2. Upgrade from Akka 2.5.32 to Akka 2.6.21.

Follow the official Akka migration guide: Akka 2.5.x to 2.6.x Migration Guide

3. Upgrade from Akka 2.6.21 to Pekko 1.0.2.

Follow the official Pekko migration guide: Pekko Migration Guide

4. For Flink-related projects.

Ensure that all reference.conf files from various dependencies are appended and merged into a single file in the fat jar to avoid configuration issues.
For more information, see the Data Client Developer Guide

2.68.3

Batch Libraries

ADDED

Added the following RIB schema artifacts to the SDK Bom files:

- com.here.schema.rib:overhead-structure-faces_v2
- com.here.schema.rib:overhead-structure-faces_v2_ds
- com.here.schema.rib:overhead-structure-faces_v2_java
- com.here.schema.rib:overhead-structure-faces_v2_proto
- com.here.schema.rib:overhead-structure-faces_v2_scala_2.12
- com.here.schema.rib:poles_v2
- com.here.schema.rib:poles_v2_ds
- com.here.schema.rib:poles_v2_java
- com.here.schema.rib:poles_v2_proto
- com.here.schema.rib:poles_v2_scala_2.12
- com.here.schema.rib:sign-faces_v2
- com.here.schema.rib:sign-faces_v2_ds
- com.here.schema.rib:sign-faces_v2_java
- com.here.schema.rib:sign-faces_v2_proto
- com.here.schema.rib:sign-faces_v2_scala_2.12

2.68.3

Stream Libraries

ADDED

2.68.3

Standalone Libraries

ADDED

2.68.3

Batch dependencies

ADDED

Added the com.fasterxml.jackson.datatype:jackson-datatype-jdk8:2.14.2 library.

2.68.3

Batch dependencies

ADDED

Added the com.typesafe:ssl-config-core_2.12:0.6.1 library.

2.68.3

Batch dependencies

CHANGED

Replaced all com.typesafe.akka dependencies with org.apache.pekko dependencies to align with the transition to Apache Pekko:
- com.typesafe.akka:akka-http-core_2.12:10.2.7 -> org.apache.pekko:pekko-http-core_2.12:1.0.1
- com.typesafe.akka:akka-http_2.12:10.2.7 -> org.apache.pekko:pekko-http_2.12:1.0.1
- com.typesafe.akka:akka-slf4j_2.12:2.5.32 -> org.apache.pekko:pekko-slf4j_2.12:1.0.2
- com.typesafe.akka:akka-stream_2.12:2.5.32 -> org.apache.pekko:pekko-stream_2.12:1.0.2
- com.typesafe.akka:akka-actor_2.12:2.5.32 -> org.apache.pekko:pekko-actor_2.12:1.0.2

2.68.3

Batch dependencies

CHANGED

Upgraded the org.apache.maven.plugins:maven-shade-plugin library from the 3.2.1 version to the 3.6.0 to support multi-release jars.

2.68.3

Batch dependencies

CHANGED

Upgraded the io.netty:netty-all library from the 4.1.87.Final version to the 4.1.113.Final version to fix vulnerability.

2.68.3

Batch dependencies

CHANGED

Upgraded the org.reactivestreams:reactive-streams library from the 1.0.2 version to the 1.0.4 version.

2.68.3

Batch dependencies

CHANGED

Upgraded the org.scala-lang.modules:scala-java8-compat_2.12 library from the 1.0.0 version to the 1.0.2 version.

2.68.3

Batch dependencies

CHANGED

Upgraded the com.typesafe:config library from the 1.3.0 version to the 1.4.3 version.

2.68.3

Standalone dependencies

ADDED

Added the com.fasterxml.jackson.datatype:jackson-datatype-jdk8:2.12.7 library.

2.68.3

Standalone dependencies

ADDED

Added the com.typesafe:ssl-config-core_2.12:0.6.1 library.

2.68.3

Standalone dependencies

ADDED

Added the com.github.luben:zstd-jni:1.5.6-2 library to align version with org.apache.parquet:parquet-avro:1.14.1.

2.68.3

Standalone dependencies

CHANGED

2.68.3

Standalone dependencies

CHANGED

Upgraded the org.apache.avro:avro library from the 1.10.0 version to the 1.11.3.

2.68.3

Standalone dependencies

CHANGED

Upgraded the org.apache.hadoop:hadoop-client library from the 3.3.4 version to the 3.3.6.

2.68.3

Standalone dependencies

CHANGED

Upgraded the io.netty:netty-all library from the 4.1.87.Final version to the 4.1.113.Final version to fix vulnerability.

2.68.3

Standalone dependencies

CHANGED

Upgraded the org.apache.parquet:parquet-avro library from the 1.10.1 version to the 1.14.1.

2.68.3

Standalone dependencies

CHANGED

Upgraded the org.reactivestreams:reactive-streams library from the 1.0.2 version to the 1.0.4 version.

2.68.3

Standalone dependencies

CHANGED

Upgraded the org.scala-lang.modules:scala-java8-compat_2.12 library from the 1.0.0 version to the 1.0.2 version.

2.68.3

Standalone dependencies

CHANGED

Upgraded the com.typesafe:config library from the 1.3.0 version to the 1.4.3 version.

2.68.3

Stream dependencies

ADDED

Added the com.fasterxml.jackson.datatype:jackson-datatype-jdk8:2.12.1 library.

2.68.3

Stream dependencies

ADDED

Added the com.typesafe:ssl-config-core_2.12:0.6.1 library.

2.68.3

Stream dependencies

ADDED

Added the com.github.luben:zstd-jni:1.5.6-2 library to align version with org.apache.parquet:parquet-avro:1.14.1.

2.68.3

Stream dependencies

CHANGED

2.68.3

Stream dependencies

CHANGED

Upgraded the org.apache.avro:avro library from the 1.10.0 version to the 1.11.3.

2.68.3

Stream dependencies

CHANGED

Upgraded the org.apache.maven.plugins:maven-shade-plugin library from the 3.2.1 version to the 3.6.0 to support multi-release jars.

2.68.3

Stream dependencies

CHANGED

Upgraded the io.netty:netty-all library from the 4.1.87.Final version to the 4.1.113.Final version to fix vulnerability.

2.68.3

Stream dependencies

CHANGED

Upgraded the org.apache.parquet:parquet-avro library from the 1.10.1 version to the 1.14.1.

2.68.3

Stream dependencies

CHANGED

Upgraded the org.reactivestreams:reactive-streams library from the 1.0.2 version to the 1.0.4 version.

2.68.3

Stream dependencies

CHANGED

Upgraded the org.scala-lang.modules:scala-java8-compat_2.12 library from the 1.0.0 version to the 1.0.2 version.

2.68.3

Stream dependencies

CHANGED

Upgraded the com.typesafe:config library from the 1.3.0 version to the 1.4.3 version.

2.67.7

Location Library

FIXED

Fixed an issue with bounding box exterior.

In com.here.platform.location.io.scaladsl.geojson.Feature#boundingBox we are
moving from clockwise to counterclockwise exterior of a bounding box polygon
feature. According to GeoJSON Format specification (see
https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6), Polygon exterior
should be defined counterclockwise.

2.67.7

Location Library

ADDED

Added a GeoJSON feature to visualize a collection of bounding boxes.

Added new functions:
com.here.platform.location.io.scaladsl.geojson.FeatureCollection#boundingBoxes
com.here.platform.location.io.javadsl.geojson.FeatureCollection#boundingBoxes
com.here.platform.location.io.scaladsl.geojson.Feature#boundingBoxes

New functions allow to create MultiPolygon feature for visualizing a collection
of bounding boxes with the same set of properties.

2.67.7

Tutorials

ADDED

Added the Gradle resolver plugin which provides Java and Scala developers with access to HERE platform artifacts via Gradle.

2.66.7

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

query:1.2.9 index:1.2.9 stream:1.2.9 blob:1.2.9 publish:1.2.9 volatileblob:1.2.9
interactive-map-v1:1.2.9 ingest:1.2.9 notifications:1.2.9 blob-v2:1.2.9
metadata:1.2.9 config:1.2.9

2.66.7

Data Client Library

ADDED

Added the baseVersion parameter to the Versioned layer extension properties.

2.66.7

Data Client Library

CHANGED

Changed reference.conf in a way that kafka-connector is the default for all
types of stream connections.

2.66.7

Batch Libraries

ADDED

Added the following Data Client Base Library modules to the SDK Batch Bom:

- com.here.platform.data.cliet.base:data-client-base-common_2.12
- com.here.platform.data.client.base:data-client-base-http_2.12

2.66.7

Batch Libraries

ADDED

Added the following Data Client Library module to the SDK Batch Bom:

- com.here.platform.data.client:data-converters_2.12

2.66.7

Batch Libraries

ADDED

Added the following Data Client v2 Library module to the SDK Batch Bom:

- com.here.platform.data.client.v2:data-client-v2-adapter-base_2.12

2.66.7

Batch Libraries

ADDED

Added the following Data Processing Library modules to the SDK Batch Bom:

- com.here.platform.data.processing:batch-commons_2.12
- com.here.platform.data.processing:batch-catalog_2.12
- com.here.platform.data.processing:batch-catalog-java_2.12
- com.here.platform.data.processing:data-client-factory_2.12

2.66.7

Batch Libraries

ADDED

Added the following Local Data Service Library modules to the SDK Batch Bom:

- com.here.platform.data.local:common-db_2.12
- com.here.platform.data.local:common-server_2.12

2.66.7

Batch Libraries

ADDED

Added the following Optimized Map For Location Library schema artifacts to the SDK Batch Bom:

- com.here.platform.pb.location.optimizedmap:attributes_v2_ds
- com.here.platform.pb.location.optimizedmap:attributes_v2_proto
- com.here.platform.pb.location.optimizedmap:attributes_v2_java
- com.here.platform.pb.location.optimizedmap:attributes_v2_scala_2.12
- com.here.platform.pb.location.optimizedmap:tmc_v2_ds
- com.here.platform.pb.location.optimizedmap:tmc_v2_proto
- com.here.platform.pb.location.optimizedmap:tmc_v2_java
- com.here.platform.pb.location.optimizedmap:tmc_v2_scala_2.12

2.66.7

Batch Libraries

ADDED

Added the following RIB schema artifacts to the SDK Batch Bom:

- com.here.schema.rib:rib_v2
- com.here.schema.rib:adas-attributes_v2
- com.here.schema.rib:administrative-place-profiles_v2
- com.here.schema.rib:annotations_v2
- com.here.schema.rib:bicycle-attributes_v2
- com.here.schema.rib:cellular-signal-carriers_v2
- com.here.schema.rib:census-boundaries_v2
- com.here.schema.rib:commercial-vehicle-regulations_v2
- com.here.schema.rib:complex-road-attributes_v2
- com.here.schema.rib:enhanced-geometry_v2
- com.here.schema.rib:generalized-junctions-signs_v2
- com.here.schema.rib:indexed-locations_v2
- com.here.schema.rib:landmark-attributes_v2
- com.here.schema.rib:physical-lane-boundary-attributes_v2
- com.here.schema.rib:physical-lane-boundary-geometry_v2
- com.here.schema.rib:physical-lane-geometry_v2
- com.here.schema.rib:physical-lane-group_v2
- com.here.schema.rib:physical-lane-group-segment-references_v2
- com.here.schema.rib:physical-lane-group-segment-references_v2_ds
- com.here.schema.rib:physical-lane-group-segment-references_v2_java
- com.here.schema.rib:physical-lane-group-segment-references_v2_proto
- com.here.schema.rib:physical-lane-group-segment-references_v2_scala_2.12
- com.here.schema.rib:postal-area-boundaries_v2
- com.here.schema.rib:postal-code-points_v2
- com.here.schema.rib:product-compatibility_v2
- com.here.schema.rib:toll-cost-attributes_v2
- com.here.schema.rib:trafficpattern-attributes_v2
- com.here.schema.rib:vehicle-regulation-attributes_v2
- com.here.schema.rib:administrative-places_v2
- com.here.schema.rib:advanced-navigation-attributes_v2
- com.here.schema.rib:building-footprints_v2
- com.here.schema.rib:building-textures-properties_v2
- com.here.schema.rib:building-textures-properties_v2_ds
- com.here.schema.rib:building-textures-properties_v2_java
- com.here.schema.rib:building-textures-properties_v2_proto
- com.here.schema.rib:building-textures-properties_v2_scala_2.12
- com.here.schema.rib:buildings_v2
- com.here.schema.rib:buildings_v2_ds
- com.here.schema.rib:buildings_v2_java
- com.here.schema.rib:buildings_v2_proto
- com.here.schema.rib:buildings_v2_scala_2.12
- com.here.schema.rib:cartography_v2
- com.here.schema.rib:common_v2
- com.here.schema.rib:env-zone-attributes_v2
- com.here.schema.rib:external-reference-attributes_v2
- com.here.schema.rib:lane-attributes_v2
- com.here.schema.rib:meta_v2
- com.here.schema.rib:navigation-attributes_v2
- com.here.schema.rib:placelocation_v2
- com.here.schema.rib:places_v2
- com.here.schema.rib:parking-areas_v2
- com.here.schema.rib:parking-areas_v2_ds
- com.here.schema.rib:parking-areas_v2_java
- com.here.schema.rib:parking-areas_v2_proto
- com.here.schema.rib:parking-areas_v2_scala_2.12
- com.here.schema.rib:pedestrian-attributes_v2
- com.here.schema.rib:pedestrian-attributes_v2_ds
- com.here.schema.rib:pedestrian-attributes_v2_java
- com.here.schema.rib:pedestrian-attributes_v2_proto
- com.here.schema.rib:pedestrian-attributes_v2_scala_2.12
- com.here.schema.rib:road-attributes_v2
- com.here.schema.rib:road-traffic-pattern-attributes_v2
- com.here.schema.rib:street-names_v2
- com.here.schema.rib:topology-geometry_v2
- com.here.schema.rib:distance-markers_v2
- com.here.schema.rib:sign-attributes_v2
- com.here.schema.rib:truck-attributes_v2
- com.here.schema.rib:datetime_v2
- com.here.schema.rib:geometry_v2
- com.here.schema.rib:iso_v2
- com.here.schema.rib:electric-vehicle-charging-locations_v2
- com.here.schema.rib:electric-vehicle-charging-locations_ds
- com.here.schema.rib:electric-vehicle-charging-locations_java
- com.here.schema.rib:electric-vehicle-charging-locations_proto
- com.here.schema.rib:electric-vehicle-charging-locations_scala_2.12
- com.here.schema.rib:enhanced-buildings_v2
- com.here.schema.rib:enhanced-buildings_v2_ds
- com.here.schema.rib:enhanced-buildings_v2_java
- com.here.schema.rib:enhanced-buildings_v2_proto
- com.here.schema.rib:enhanced-buildings_v2_scala_2.12
- com.here.schema.rib:barriers_v2
- com.here.schema.rib:barriers_v2_ds
- com.here.schema.rib:barriers_v2_java
- com.here.schema.rib:barriers_v2_proto
- com.here.schema.rib:barriers_v2_scala_2.12
- com.here.schema.rib:road-surface-markings_v2
- com.here.schema.rib:road-surface-markings_v2_ds
- com.here.schema.rib:road-surface-markings_v2_java
- com.here.schema.rib:road-surface-markings_v2_proto
- com.here.schema.rib:road-surface-markings_v2_scala_2.12
- com.here.schema.rib:traffic-signals_v2
- com.here.schema.rib:traffic-signals_v2_ds
- com.here.schema.rib:traffic-signals_v2_java
- com.here.schema.rib:traffic-signals_v2_proto
- com.here.schema.rib:traffic-signals_v2_scala_2.12

2.66.7

Batch Libraries

ADDED

Added the following SDII schema artifacts to the SDK Batch Bom:

- com.here.sdii:sdii_v3
- com.here.sdii:sdii_common_v3
- com.here.sdii:sdii_message_v3
- com.here.sdii:sdii_message_list_v3
- com.here.sdii:sdii_archive_v1

2.66.7

Batch Libraries

ADDED

Added the following Sensoris schema artifact to the SDK Batch Bom:

- org.sensoris:sensoris-specification_v1_2_2

2.66.7

Stream Libraries

ADDED

Added the following Data Client Base Library modules to the SDK Stream Bom:

- com.here.platform.data.cliet.base:data-client-base-common_2.12
- com.here.platform.data.client.base:data-client-base-http_2.12

2.66.7

Stream Libraries

ADDED

Added the following Data Client Library module to the SDK Stream Bom:

- com.here.platform.data.client:data-converters_2.12

2.66.7

Stream Libraries

ADDED

Added the following Data Client v2 Library module to the SDK Stream Bom:

- com.here.platform.data.client.v2:data-client-v2-adapter-base_2.12

2.66.7

Stream Libraries

ADDED

Added the following Local Data Service Library modules to the SDK Stream Bom:

- com.here.platform.data.local:common-db_2.12
- com.here.platform.data.local:common-server_2.12

2.66.7

Stream Libraries

ADDED

Added the following Optimized Map For Location Library schema artifacts to the SDK Stream Bom:

- com.here.platform.pb.location.optimizedmap:attributes_v2_ds
- com.here.platform.pb.location.optimizedmap:attributes_v2_proto
- com.here.platform.pb.location.optimizedmap:attributes_v2_java
- com.here.platform.pb.location.optimizedmap:attributes_v2_scala_2.12
- com.here.platform.pb.location.optimizedmap:tmc_v2_ds
- com.here.platform.pb.location.optimizedmap:tmc_v2_proto
- com.here.platform.pb.location.optimizedmap:tmc_v2_java
- com.here.platform.pb.location.optimizedmap:tmc_v2_scala_2.12

2.66.7

Stream Libraries

ADDED

Added the following RIB schema artifacts to the SDK Stream Bom:

- com.here.schema.rib:rib_v2
- com.here.schema.rib:adas-attributes_v2
- com.here.schema.rib:administrative-place-profiles_v2
- com.here.schema.rib:annotations_v2
- com.here.schema.rib:bicycle-attributes_v2
- com.here.schema.rib:cellular-signal-carriers_v2
- com.here.schema.rib:census-boundaries_v2
- com.here.schema.rib:commercial-vehicle-regulations_v2
- com.here.schema.rib:complex-road-attributes_v2
- com.here.schema.rib:enhanced-geometry_v2
- com.here.schema.rib:generalized-junctions-signs_v2
- com.here.schema.rib:indexed-locations_v2
- com.here.schema.rib:landmark-attributes_v2
- com.here.schema.rib:physical-lane-boundary-attributes_v2
- com.here.schema.rib:physical-lane-boundary-geometry_v2
- com.here.schema.rib:physical-lane-geometry_v2
- com.here.schema.rib:physical-lane-group_v2
- com.here.schema.rib:physical-lane-group-segment-references_v2
- com.here.schema.rib:physical-lane-group-segment-references_v2_ds
- com.here.schema.rib:physical-lane-group-segment-references_v2_java
- com.here.schema.rib:physical-lane-group-segment-references_v2_proto
- com.here.schema.rib:physical-lane-group-segment-references_v2_scala_2.12
- com.here.schema.rib:postal-area-boundaries_v2
- com.here.schema.rib:postal-code-points_v2
- com.here.schema.rib:product-compatibility_v2
- com.here.schema.rib:toll-cost-attributes_v2
- com.here.schema.rib:trafficpattern-attributes_v2
- com.here.schema.rib:vehicle-regulation-attributes_v2
- com.here.schema.rib:administrative-places_v2
- com.here.schema.rib:advanced-navigation-attributes_v2
- com.here.schema.rib:building-footprints_v2
- com.here.schema.rib:building-textures-properties_v2
- com.here.schema.rib:building-textures-properties_v2_ds
- com.here.schema.rib:building-textures-properties_v2_java
- com.here.schema.rib:building-textures-properties_v2_proto
- com.here.schema.rib:building-textures-properties_v2_scala_2.12
- com.here.schema.rib:buildings_v2
- com.here.schema.rib:buildings_v2_ds
- com.here.schema.rib:buildings_v2_java
- com.here.schema.rib:buildings_v2_proto
- com.here.schema.rib:buildings_v2_scala_2.12
- com.here.schema.rib:cartography_v2
- com.here.schema.rib:common_v2
- com.here.schema.rib:env-zone-attributes_v2
- com.here.schema.rib:external-reference-attributes_v2
- com.here.schema.rib:lane-attributes_v2
- com.here.schema.rib:meta_v2
- com.here.schema.rib:navigation-attributes_v2
- com.here.schema.rib:placelocation_v2
- com.here.schema.rib:places_v2
- com.here.schema.rib:parking-areas_v2
- com.here.schema.rib:parking-areas_v2_ds
- com.here.schema.rib:parking-areas_v2_java
- com.here.schema.rib:parking-areas_v2_proto
- com.here.schema.rib:parking-areas_v2_scala_2.12
- com.here.schema.rib:pedestrian-attributes_v2
- com.here.schema.rib:pedestrian-attributes_v2_ds
- com.here.schema.rib:pedestrian-attributes_v2_java
- com.here.schema.rib:pedestrian-attributes_v2_proto
- com.here.schema.rib:pedestrian-attributes_v2_scala_2.12
- com.here.schema.rib:road-attributes_v2
- com.here.schema.rib:road-traffic-pattern-attributes_v2
- com.here.schema.rib:street-names_v2
- com.here.schema.rib:topology-geometry_v2
- com.here.schema.rib:distance-markers_v2
- com.here.schema.rib:sign-attributes_v2
- com.here.schema.rib:truck-attributes_v2
- com.here.schema.rib:datetime_v2
- com.here.schema.rib:geometry_v2
- com.here.schema.rib:iso_v2
- com.here.schema.rib:electric-vehicle-charging-locations_v2
- com.here.schema.rib:electric-vehicle-charging-locations_ds
- com.here.schema.rib:electric-vehicle-charging-locations_java
- com.here.schema.rib:electric-vehicle-charging-locations_proto
- com.here.schema.rib:electric-vehicle-charging-locations_scala_2.12
- com.here.schema.rib:enhanced-buildings_v2
- com.here.schema.rib:enhanced-buildings_v2_ds
- com.here.schema.rib:enhanced-buildings_v2_java
- com.here.schema.rib:enhanced-buildings_v2_proto
- com.here.schema.rib:enhanced-buildings_v2_scala_2.12
- com.here.schema.rib:barriers_v2
- com.here.schema.rib:barriers_v2_ds
- com.here.schema.rib:barriers_v2_java
- com.here.schema.rib:barriers_v2_proto
- com.here.schema.rib:barriers_v2_scala_2.12
- com.here.schema.rib:road-surface-markings_v2
- com.here.schema.rib:road-surface-markings_v2_ds
- com.here.schema.rib:road-surface-markings_v2_java
- com.here.schema.rib:road-surface-markings_v2_proto
- com.here.schema.rib:road-surface-markings_v2_scala_2.12
- com.here.schema.rib:traffic-signals_v2
- com.here.schema.rib:traffic-signals_v2_ds
- com.here.schema.rib:traffic-signals_v2_java
- com.here.schema.rib:traffic-signals_v2_proto
- com.here.schema.rib:traffic-signals_v2_scala_2.12

2.66.7

Stream Libraries

ADDED

Added the following SDII schema artifacts to the SDK Stream Bom:

- com.here.sdii:sdii_v3
- com.here.sdii:sdii_common_v3
- com.here.sdii:sdii_message_v3
- com.here.sdii:sdii_message_list_v3
- com.here.sdii:sdii_archive_v1

2.66.7

Stream Libraries

ADDED

Added the following Sensoris schema artifact to the SDK Stream Bom:

- org.sensoris:sensoris-specification_v1_2_2

2.66.7

Standalone Libraries

ADDED

Added the following Data Client Base Library modules to the SDK Standalone Bom:

- com.here.platform.data.cliet.base:data-client-base-common_2.12
- com.here.platform.data.client.base:data-client-base-http_2.12

2.66.7

Standalone Libraries

ADDED

Added the following Data Client Library module to the SDK Standalone Bom:

- com.here.platform.data.client:data-converters_2.12

2.66.7

Standalone Libraries

ADDED

Added the following Data Client v2 Library module to the SDK Standalone Bom:

- com.here.platform.data.client.v2:data-client-v2-adapter-base_2.12

2.66.7

Standalone Libraries

ADDED

Added the following Data Processing Library modules to the SDK Standalone Bom:

- com.here.platform.data.processing:batch-commons_2.12
- com.here.platform.data.processing:batch-catalog_2.12
- com.here.platform.data.processing:batch-catalog-java_2.12
- com.here.platform.data.processing:data-client-factory_2.12

2.66.7

Standalone Libraries

ADDED

Added the following Local Data Service Library modules to the SDK Standalone Bom:

- com.here.platform.data.local:common-db_2.12
- com.here.platform.data.local:common-server_2.12

2.66.7

Standalone Libraries

ADDED

Added the following Optimized Map For Location Library schema artifacts to the SDK Standalone Bom:

- com.here.platform.pb.location.optimizedmap:attributes_v2_ds
- com.here.platform.pb.location.optimizedmap:attributes_v2_proto
- com.here.platform.pb.location.optimizedmap:attributes_v2_java
- com.here.platform.pb.location.optimizedmap:attributes_v2_scala_2.12
- com.here.platform.pb.location.optimizedmap:tmc_v2_ds
- com.here.platform.pb.location.optimizedmap:tmc_v2_proto
- com.here.platform.pb.location.optimizedmap:tmc_v2_java
- com.here.platform.pb.location.optimizedmap:tmc_v2_scala_2.12

2.66.7

Standalone Libraries

ADDED

Added the following RIB schema artifacts to the SDK Standalone Bom:

- com.here.schema.rib:rib_v2
- com.here.schema.rib:adas-attributes_v2
- com.here.schema.rib:administrative-place-profiles_v2
- com.here.schema.rib:annotations_v2
- com.here.schema.rib:bicycle-attributes_v2
- com.here.schema.rib:cellular-signal-carriers_v2
- com.here.schema.rib:census-boundaries_v2
- com.here.schema.rib:commercial-vehicle-regulations_v2
- com.here.schema.rib:complex-road-attributes_v2
- com.here.schema.rib:enhanced-geometry_v2
- com.here.schema.rib:generalized-junctions-signs_v2
- com.here.schema.rib:indexed-locations_v2
- com.here.schema.rib:landmark-attributes_v2
- com.here.schema.rib:physical-lane-boundary-attributes_v2
- com.here.schema.rib:physical-lane-boundary-geometry_v2
- com.here.schema.rib:physical-lane-geometry_v2
- com.here.schema.rib:physical-lane-group_v2
- com.here.schema.rib:physical-lane-group-segment-references_v2
- com.here.schema.rib:physical-lane-group-segment-references_v2_ds
- com.here.schema.rib:physical-lane-group-segment-references_v2_java
- com.here.schema.rib:physical-lane-group-segment-references_v2_proto
- com.here.schema.rib:physical-lane-group-segment-references_v2_scala_2.12
- com.here.schema.rib:postal-area-boundaries_v2
- com.here.schema.rib:postal-code-points_v2
- com.here.schema.rib:product-compatibility_v2
- com.here.schema.rib:toll-cost-attributes_v2
- com.here.schema.rib:trafficpattern-attributes_v2
- com.here.schema.rib:vehicle-regulation-attributes_v2
- com.here.schema.rib:administrative-places_v2
- com.here.schema.rib:advanced-navigation-attributes_v2
- com.here.schema.rib:building-footprints_v2
- com.here.schema.rib:building-textures-properties_v2
- com.here.schema.rib:building-textures-properties_v2_ds
- com.here.schema.rib:building-textures-properties_v2_java
- com.here.schema.rib:building-textures-properties_v2_proto
- com.here.schema.rib:building-textures-properties_v2_scala_2.12
- com.here.schema.rib:buildings_v2
- com.here.schema.rib:buildings_v2_ds
- com.here.schema.rib:buildings_v2_java
- com.here.schema.rib:buildings_v2_proto
- com.here.schema.rib:buildings_v2_scala_2.12
- com.here.schema.rib:cartography_v2
- com.here.schema.rib:common_v2
- com.here.schema.rib:env-zone-attributes_v2
- com.here.schema.rib:external-reference-attributes_v2
- com.here.schema.rib:lane-attributes_v2
- com.here.schema.rib:meta_v2
- com.here.schema.rib:navigation-attributes_v2
- com.here.schema.rib:placelocation_v2
- com.here.schema.rib:places_v2
- com.here.schema.rib:parking-areas_v2
- com.here.schema.rib:parking-areas_v2_ds
- com.here.schema.rib:parking-areas_v2_java
- com.here.schema.rib:parking-areas_v2_proto
- com.here.schema.rib:parking-areas_v2_scala_2.12
- com.here.schema.rib:pedestrian-attributes_v2
- com.here.schema.rib:pedestrian-attributes_v2_ds
- com.here.schema.rib:pedestrian-attributes_v2_java
- com.here.schema.rib:pedestrian-attributes_v2_proto
- com.here.schema.rib:pedestrian-attributes_v2_scala_2.12
- com.here.schema.rib:road-attributes_v2
- com.here.schema.rib:road-traffic-pattern-attributes_v2
- com.here.schema.rib:street-names_v2
- com.here.schema.rib:topology-geometry_v2
- com.here.schema.rib:distance-markers_v2
- com.here.schema.rib:sign-attributes_v2
- com.here.schema.rib:truck-attributes_v2
- com.here.schema.rib:datetime_v2
- com.here.schema.rib:geometry_v2
- com.here.schema.rib:iso_v2
- com.here.schema.rib:electric-vehicle-charging-locations_v2
- com.here.schema.rib:electric-vehicle-charging-locations_ds
- com.here.schema.rib:electric-vehicle-charging-locations_java
- com.here.schema.rib:electric-vehicle-charging-locations_proto
- com.here.schema.rib:electric-vehicle-charging-locations_scala_2.12
- com.here.schema.rib:enhanced-buildings_v2
- com.here.schema.rib:enhanced-buildings_v2_ds
- com.here.schema.rib:enhanced-buildings_v2_java
- com.here.schema.rib:enhanced-buildings_v2_proto
- com.here.schema.rib:enhanced-buildings_v2_scala_2.12
- com.here.schema.rib:barriers_v2
- com.here.schema.rib:barriers_v2_ds
- com.here.schema.rib:barriers_v2_java
- com.here.schema.rib:barriers_v2_proto
- com.here.schema.rib:barriers_v2_scala_2.12
- com.here.schema.rib:road-surface-markings_v2
- com.here.schema.rib:road-surface-markings_v2_ds
- com.here.schema.rib:road-surface-markings_v2_java
- com.here.schema.rib:road-surface-markings_v2_proto
- com.here.schema.rib:road-surface-markings_v2_scala_2.12
- com.here.schema.rib:traffic-signals_v2
- com.here.schema.rib:traffic-signals_v2_ds
- com.here.schema.rib:traffic-signals_v2_java
- com.here.schema.rib:traffic-signals_v2_proto
- com.here.schema.rib:traffic-signals_v2_scala_2.12

2.66.7

Standalone Libraries

ADDED

Added the following SDII schema artifacts to the SDK Standalone Bom:

- com.here.sdii:sdii_v3
- com.here.sdii:sdii_common_v3
- com.here.sdii:sdii_message_v3
- com.here.sdii:sdii_message_list_v3
- com.here.sdii:sdii_archive_v1

2.66.7

Standalone Libraries

ADDED

Added the following Sensoris schema artifact to the SDK Standalone Bom:

- org.sensoris:sensoris-specification_v1_2_2

2.65.6

Data Client Base Library

ADDED

Added the ability to override the Content Type parameter using the
withContentType method.

2.65.6

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

blob:1.2.8 config:1.2.8

2.65.6

Data Client Base Library

UPDATED

2.65.6

Data Client Library

ADDED

Added the baseVersion parameter to the Versioned layer extension properties.

2.65.6

Data Client Library

CHANGED

Changed reference.conf in a way that kafka-connector is the default for all
types of stream connections.

2.65.6

Tutorials

REMOVED

Removed the Get real-time traffic conditions for a location tutorial from HERE Data Java/Scala SDK.

2.64.5

Location Library

FIXED

Updated ProjectingInterpolator to handle paths with loops (i.e., when start
and end points are located on the same vertex and
start-fraction > end-fraction).

In some cases the path matchers could have returned OnRoad points connected to
the previous point, but going backward on the returned path. This behavior has
been changed and now connected OnRoad points can only move forward on the
matched path.

All PathMatchers which use ProjectingInterpolator under the hood are
affected by this change, including:

- PathMatchers.unrestrictedPathMatcherWithTransitions;
- PathMatchers.carPathMatcherWithTransitions;
- PathMatchers.unrestrictedPathMatcher;
- PathMatchers.unrestrictedDense;
- PathMatchers.restrictedDense;
- PathMatchers.unrestrictedSparse;
- PathMatchers.restrictedSparse.

2.64.5

Location Library

CHANGED

Changed zero offsets in OLR linear references into lack of offset.

According to the TISA OLR specification, either the lack of an offset or a zero
offset indicate that the start (in the case of a positive offset) or the end (in
the case of a negative offset) of a location lies exactly on the reference point
(first or last, respectively). Previously, we returned zero offset in some cases
and no offset in others. This has been changed to always returning no offset.

2.64.5

Location Library

FIXED

Fixed TISA OLR specification data format rule violation in linear references.

According to data format rule no. 5, the positive offset of a linear reference
must refer to the path defined by the first two reference points, while the
negative offset must refer to the path defined by the last two reference points.
At the same time, according to the rule no. 1, the maximum distance between
consecutive reference points is 15 km. In rare cases where the next junction is
distant from a given location, you must add a non-junction reference point
closer to the location. In this case, keeping both the junction as a reference
point (last or first) and the non-junction (closer) intermediate reference point
violates the rule no. 5, as the offset is not referring to the path between
them.

We previously returned both reference points and only violated rule no. 5 in
this rare case. The fix changes the behavior so that the junction is no longer a
reference point and only the non-junction point is retained (fulfilling both
rules no. 1 and 5).

2.64.5

Tutorials

CHANGED

Changed the following tutorials to use the new Batch environment with Spark 3.4.3:

- Path matching the sensor data to GeoJSON in Spark
- Copy a catalog using the Data Processing Library
- Use Spark Connector to migrate CSV data to Protobuf
- Develop a Spark application
- Read and write to Object store layer using Hadoop FS support in Spark
- Local development and testing with CLI and Data Client Library
- Read from a catalog in a batch application
- Use HERE Platform Service
- Use Spark Connector to read and write data

2.64.5

Batch dependencies

CHANGED

Upgraded the com.here.platform:environment-batch-4.0.1 to the com.here.platform:environment-batch-4.0.2 to support
Spark 3.4.3.

2.64.5

Batch dependencies

CHANGED

Upgraded the org.xerial.snappy:snappy-java library from the 1.1.10.4 version to the 1.1.10.5 version to fix vulnerability.

2.64.5

Standalone dependencies

CHANGED

Upgraded the org.xerial.snappy:snappy-java library from the 1.1.10.4 version to the 1.1.10.5 version to fix vulnerability.

2.64.5

Stream dependencies

CHANGED

Upgraded the org.xerial.snappy:snappy-java library from the 1.1.10.4 version to the 1.1.10.5 version to fix vulnerability.

2.63.7

Location Library

FIXED

Fixed an issue regarding returning unnecessary elements in Map Matching results.

This problem occurred in Map Matching using
com.here.platform.location.integration.optimizedmap.mapmatching.PathMatchers.

In cases where an input observation is projected exactly at the crossing of two
subsequent elements, it can lead to Map Matching results that include:

- a projection on the preceding element with a fraction of 1.0, even if it is
the first observation in a sequence of matched observations
- a projection on the following element with a fraction of 0.0, even if it is
the last observation in a sequence of matched observations

This fix ensures that Map Matcher will not return zero-length elements as part
of the response.

Because the algorithm has changed, you might observe different, but still
correct, results.

2.63.7

Examples

CHANGED

Updated the A Compiler to Extract Pedestrian Topologies into Protobuf example to use Protobuf 3.19.6.

2.63.7

Schemas

CHANGED

The latest v2.8.4 OM4LL Schema now use Protobuf 3.19.6.

Be sure to update the schema to the latest version to avoid compatibility issues.

2.63.7

Schemas

CHANGED

The latest v2.1.18 Real-Time Traffic Schema now use Protobuf 3.19.6.

Be sure to update the schema to the latest version to avoid compatibility issues.

2.63.7

Schemas

CHANGED

The latest v2.114.0 Reality Index Base (RiB) Schema now use Protobuf 3.19.6.

Be sure to update the schema to the latest version to avoid compatibility issues.

2.63.7

Schemas

CHANGED

The latest SDII schemas now use Protobuf 3.19.6:

- SDII v3 Schema: Message and MessageList v4.2.27
- SDII Archive Schema v2.2.38

Be sure to update the above-mentioned schemas to their latest versions to avoid compatibility issues.

2.63.7

Schemas

CHANGED

The latest v1.1.12 SENSORIS schema now use Protobuf 3.19.6.

Be sure to update the schema to the latest version to avoid compatibility issues.

2.63.7

Batch dependencies

CHANGED

Upgraded the following libraries:
- com.github.blemale:scaffeine_2.12 from the 4.0.1 version to the 4.1.0 version
- com.google.errorprone:error_prone_annotations from the 2.3.4 version to the 2.5.1 version
- com.thesamet.scalapb:compilerplugin_2.12, com.thesamet.scalapb:lenses_2.12, com.thesamet.scalapb:scalapb-runtime_2.12 from the 0.10.10 version to the 0.11.15 version
- org.scala-lang.modules:scala-java8-compat_2.12 from the 0.9.1 version to the 1.0.0 version

2.63.7

Batch dependencies

CHANGED

Upgraded the com.google.protobuf:protobuf-java and com.google.protobuf:protobuf-java-util libraries from the 3.11.4 version to the 3.19.6 version to fix the CVE-2021-22569 vulnerability.

2.63.7

Standalone dependencies

CHANGED

2.63.7

Standalone dependencies

CHANGED

Upgraded the com.google.protobuf:protobuf-java and com.google.protobuf:protobuf-java-util libraries from the 3.11.4 version to the 3.19.6 version to fix the CVE-2021-22569 vulnerability.

2.63.7

Stream dependencies

CHANGED

2.63.7

Stream dependencies

CHANGED

Upgraded the com.google.protobuf:protobuf-java and com.google.protobuf:protobuf-java-util libraries from the 3.11.4 version to the 3.19.6 version to fix the CVE-2021-22569 vulnerability.

2.62.5

Archetypes

ADDED

Added the includeOnlySourceProto configuration property to the layer-manifest-plugin which controls whether or not to include
*.proto files from dependencies in the layer.fds file.

2.62.5

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

metadata:1.2.7 config:1.2.7

2.62.5

Location Library

FIXED

Fixed an issue with missing transitions in map matching output.

This problem occurred in Map Matching using
com.here.platform.location.core.mapmatching.ProjectingInterpolator, including:

- com.here.platform.location.integration.optimizedmap.mapmatching.PathMatchers#unrestrictedPathMatcherWithTransitions
- com.here.platform.location.integration.optimizedmap.mapmatching.PathMatchers#carPathMatcherWithTransitions

In cases where a path traverses a point near the end of a segment and a point
near the beginning of the same segment, the transitions found by
com.here.platform.location.core.mapmatching.HMMPathMatcher are erased by the
interpolator. The output can be falsely interpreted as running backwards on the
segment instead of forward and looping through a transition.

2.61.5

Data Client Library

FIXED

Fixed the problem when the connection was not closed if the requested BLOB does
not exist.

2.61.5

Data Client Library

DEPRECATED

Please notice that with the upcoming release of September 2024 of the HERE SDK for Java and Scala
we will stop using Akka framework. All functions which use Akka today will be
migrated to use Pekko.
Data Client Library will not have Akka as a dependency anymore.

This means that if your application uses any of the Akka classes which are delivered with HERE SDK for Java and Scala
packages (jar files) you need to migrate your code to Pekko as well.

We suggest a 2-step migration:
1. Migration from Akka 2.5 to Akka 2.6
2. Migration from Akka 2.6 to Pekko

Please note that this change will not be backward-compatible.

2.61.5

Location Library

ADDED

Added support for the routingRoadAccess layer, which allows to do path
matching excluding roads under construction.

routingRoadAccess layer is available in the Optimized Map for Location Library
starting from the version 5750.

Example of building carPathMatcherWithTransitions excluding roads under
construction:

import com.here.platform.location.core.geospatial.GeoCoordinate
import com.here.platform.location.integration.optimizedmap.mapmatching.CarPathMatcherLayers
import com.here.platform.location.integration.optimizedmap.mapmatching.PathMatchers

val layers = new CarPathMatcherLayers(optimizedMap.geometry,
                                      optimizedMap.length,
                                      optimizedMap.routingGraph,
                                      optimizedMap.restrictedManoeuvre,
                                      optimizedMap.routingRoadAccess)
val pathMatcher = PathMatchers.carPathMatcherWithTransitionsGeoCoordinate

2.61.5

Tutorials

CHANGED

Changed the following tutorials to use the new Batch environment with Spark 3.4.2:

- Path matching the sensor data to GeoJSON in Spark
- Copy a catalog using the Data Processing Library
- Use Spark Connector to migrate CSV data to Protobuf
- Develop a Spark application
- Read and write to Object store layer using Hadoop FS support in Spark
- Local development and testing with CLI and Data Client Library
- Read from a catalog in a batch application
- Use HERE Platform Service
- Use Spark Connector to read and write data

2.61.5

Batch dependencies

CHANGED

Upgraded the com.here.platform:environment-batch-4.0.0 to the com.here.platform:environment-batch-4.0.1 to support
Spark 3.4.2.

2.61.5

Batch dependencies

CHANGED

Upgraded the following logback libraries from the 1.3.8 version to the 1.3.14 version to fix vulnerability:
- ch.qos.logback:logback-classic
- ch.qos.logback:logback-core

2.61.5

Batch dependencies

CHANGED

Upgraded the org.xerial.snappy:snappy-java library from the 1.1.10.1 version to the 1.1.10.4 version to fix vulnerability.

2.61.5

Standalone dependencies

CHANGED

Upgraded the following logback libraries from the 1.3.8 version to the 1.3.14 version to fix vulnerability:
- ch.qos.logback:logback-classic
- ch.qos.logback:logback-core

2.61.5

Standalone dependencies

CHANGED

Upgraded the org.xerial.snappy:snappy-java library from the 1.1.10.1 version to the 1.1.10.4 version to fix vulnerability.

2.61.5

Stream dependencies

CHANGED

Upgraded the following logback libraries from the 1.3.8 version to the 1.3.14 version to fix vulnerability:
- ch.qos.logback:logback-classic
- ch.qos.logback:logback-core

2.61.5

Stream dependencies

CHANGED

Upgraded the org.xerial.snappy:snappy-java library from the 1.1.10.1 version to the 1.1.10.4 version to fix vulnerability.

2.60.3

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

query:1.2.6 metadata:1.2.6 config:1.2.6

2.60.3

Location Library

DEPRECATED

Deprecate Japan maps HRNs as no longer supported:

- hrn:here:data::olp-here:here-map-content-japan-2
- hrn:here:data::olp-here:here-optimized-map-for-location-library-japan-2

2.60.3

Location Library

REMOVED

Removed all China-related elements, since China platform is no longer available,
in particular:

- China catalogs HRNs (catalogs are not available anymore)
- TmcAdjacencyProviders factory (functionality for creating adjacency provider
out of China TMC offset catalogs)

2.59.2

Data Client Base Library

CHANGED

The HERE SDK for Java and Scala upgraded support for Spark to version 3.4.1.
This means the this version of data-client-base libraries are not compatible
with the previous versions anymore.

2.59.2

Data Client Library

ADDED

Added new methods to QueryApi/FlinkQueryApi that allows adding context
parameter to query composite catalogs for versioned layers.

2.58.2

Archetypes

FIXED

Fixed the Unable to resolve Artifact Service URL. Status: HTTP/1.1 429 Too Many Requests error when use the HERE platform Maven Wagon plugin.

2.58.2

Archetypes

CHANGED

Changed the following archetypes to use the new Batch environment with Spark 3.4.1:

- Direct1toN Batch Processor in Java Archetype
- Direct1toN Batch Processor in Scala Archetype
- Batch Processor in Java Archetype
- Batch Processor in Scala Archetype
- MapGroup Batch Processor in Java Archetype
- MapGroup Batch Processor in Scala Archetype
- Reftree Batch Processor in Java Archetype
- Reftree Batch Processor in Scala Archetype

2.58.2

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

artifact:1.2.6 blob:1.2.6 publish:1.2.6 volatileblob:1.2.6 config:1.2.6

2.58.2

Data Client Library

ADDED

Added new method to WriteEngine that allows updating of Ttl on individual
partition in a Volatile layer.

2.58.2

Location Library

CHANGED

The order of the elements returned by the proximity search can change after this
release. Note that any particular order is not guaranteed by the library.

2.58.2

Location Library

CHANGED

Map matching can sometimes match exactly the end or the start of a segment. In
these cases, the library can choose any of the equivalent points, i.e. the start
of the next segment or the end of the previous one. The selection of a
particular point out of the equivalent ones can change after this release. Note
that any particular selection is not guaranteed by the library.

2.58.2

Location Library

CHANGED

Weighers defined in
com.here.platform.location.integration.optimizedmap.internal.TileWeighers, which
are needed to configure the layers in
com.here.platform.location.integration.optimizedmap.OptimizedMapLayers and are
used to estimate the cache memory occupation, are returning exactly the same
numbers as before this release, but after this release there can be sometimes
some memory optimization carried out in case of empty data fields, which is not
taken into account by the weighers. Thus, weighers can very rarely slightly
overestimate the memory consumed.

2.58.2

Tutorials

CHANGED

Changed the following tutorials to use the new Batch environment with Spark 3.4.1:

- Path matching the sensor data to GeoJSON in Spark
- Copy a catalog using the Data Processing Library
- Use Spark Connector to migrate CSV data to Protobuf
- Develop a Spark application
- Read and write to Object store layer using Hadoop FS support in Spark
- Local development and testing with CLI and Data Client Library
- Read from a catalog in a batch application
- Use HERE Platform Service
- Use Spark Connector to read and write data

For more information on how to migrate your project to use Spark 3.4.1,
see the Migrate the SDK Projects from Spark 2.4.7 to 3.4.1 section.

2.58.2

Examples

CHANGED

Changed the following examples to use the new Batch environment with Spark 3.4.1:

- A Compiler to lift road topology and geometry and aggregate it to higher level
- A Compiler to Compute Catalog Differences
- A Compiler to Extract Pedestrian Topologies into GeoJSON
- A Compiler to Extract Pedestrian Topologies into Protobuf
- A Stateful Processing Compiler to Process Input and Feedback Data
- Using DeltaSets to Extract Pedestrian Topologies into GeoJSON
- An Incremental Validation Pipeline to Verify Road Topology content with Scalatest DSL
- Compacting Index Layer Data in Parquet Format
- Compacting Index Layer Data in Protobuf Format
- Infer Stop Signs From Sensors

2.58.2

Batch dependencies

REMOVED

Removed the org.apache.commons:commons-lang3 library from the sdk-dep-common file
because of different versions of that library specified in the batch and stream environments.

Now this dependency is specified separately for the batch, stream and standalone dep files:
1. sdk-dep-batch_2.12: org.apache.commons:commons-lang3:3.12.0
2. sdk-dep-standalone_2.12: org.apache.commons:commons-lang3:3.12.0
3. sdk-dep-stream_2.12: org.apache.commons:commons-lang3:3.3.2

2.58.2

Batch dependencies

CHANGED

Upgraded the following io.circe libraries from the 0.10.0 to 0.14.1 version:
- io.circe:circe-core_2.12
- io.circe:circe-generic_2.12
- io.circe:circe-parser_2.12

2.58.2

Batch dependencies

CHANGED

Upgraded the com.here.platform:environment-batch-3.0.0 to the com.here.platform:environment-batch-4.0.0 to support
Spark 3.4.1.

The following libraries were upgraded to align with the batch-4.0 environment:

Library	Old version	New version
com.typesafe.akka:akka-http-core_2.12	10.1.12	10.2.7
com.typesafe.akka:akka-http_2.12	10.1.12	10.2.7
com.fasterxml.jackson.core:jackson-annotations	2.6.7	2.14.2
com.fasterxml.jackson.core:jackson-core	2.6.7	2.14.2
com.fasterxml.jackson.core:jackson-databind	2.6.7	2.14.2
com.fasterxml.jackson.core:jackson-dataformat-yaml	2.6.7	2.14.2
com.fasterxml.jackson.core:jackson-datatype-jsr310	2.6.7	2.14.2
org.apache.commons:commons-lang3	3.3.2	3.12.0
ch.qos.logback:logback-classic	1.2.3	1.3.8
ch.qos.logback:logback-core	1.2.3	1.3.8
com.squareup.okhttp3:logging-interceptor	3.12.0	4.12.0
com.squareup.okhttp3:okhttp	3.12.10	4.12.0
commons-codec:commons-codec	1.10	1.15
commons-io:commons-io	2.4	2.11.0
io.netty:netty-all	4.1.17.Final	4.1.87.Final
jline:jline	2.14.3	2.14.6
joda-time:joda-time	2.9.3	2.12.2
org.apache.commons:commons-lang3	3.3.2	3.12.0
org.apache.commons:commons-math3	3.4.1	3.6.1
org.apache.curator:curator-client	2.7.1	2.13.0
org.apache.curator:curator-framework	2.7.1	2.13.0
org.apache.curator:curator-recipes	2.7.1	2.13.0
org.apache.httpcomponents:httpclient	4.5.6	4.5.14
org.apache.httpcomponents:httpcore	4.4.10	4.4.16
org.apache.mesos:mesos	1.0.1	1.11.0
org.json4s:json4s-ast_2.12	3.5.3	3.7.0-M11
org.json4s:json4s-core__2.12	3.5.3	3.7.0-M11
org.json4s:json4s-native_2.12	3.5.3	3.7.0-M11
org.lz4:lz4-java	1.4.0	1.8.0
org.objenesis:objenesis	2.1	3.2
org.scala-lang.modules:scala-collection-compat_2.12	2.3.2	2.7.0
org.scala-lang.modules:scala-parser-combinators_2.12	1.0.4	2.1.1
org.scala-lang.modules:scala-xml_2.12	1.0.5	2.1.0
org.slf4j:jcl-over-slf4j	1.7.16	2.0.6
org.slf4j:jul-to-slf4j	1.7.16	2.0.6
org.slf4j:log4j-over-slf4j	1.7.16	2.0.6
org.slf4j:slf4j-api	1.7.16	2.0.6
org.slf4j:slf4j-log4j12	1.7.16	2.0.6
org.slf4j:slf4j-nop	1.7.16	2.0.6
org.slf4j:slf4j-simple	1.7.16	2.0.6
org.xerial.snappy:snappy-java	1.1.4	1.1.10.1

2.58.2

Batch dependencies

CHANGED

Upgraded the com.google.code.gson:gson library from the 2.8.6 version to the 2.8.9 version to fix vulnerabilities.

2.58.2

Standalone dependencies

REMOVED

2.58.2

Standalone dependencies

CHANGED

Upgraded the following akka libraries from the 10.1.12 version to the 10.2.7 version to fix vulnerability:
- com.typesafe.akka:akka-http-core_2.12
- com.typesafe.akka:akka-http_2.12

2.58.2

Standalone dependencies

CHANGED

Upgraded the following io.circe libraries from the 0.10.0 to 0.14.1 version:
- io.circe:circe-core_2.12
- io.circe:circe-generic_2.12
- io.circe:circe-parser_2.12

2.58.2

Standalone dependencies

CHANGED

Upgraded the org.apache.commons:commons-lang3 library from the 3.3.2 version to the 3.12.0 version to fix vulnerabilities.

2.58.2

Standalone dependencies

CHANGED

Upgraded the com.google.code.gson:gson library from the 2.8.6 version to the 2.8.9 version to fix vulnerabilities.

2.58.2

Standalone dependencies

CHANGED

Upgraded the org.apache.hadoop:hadoop-client library from the 2.7.3 version to the 3.3.4 version.

2.58.2

Standalone dependencies

CHANGED

Upgraded the following jackson libraries from the 2.12.1 version to the 2.12.7 version to align with the org.apache.hadoop:hadoop-client library:
- com.fasterxml.jackson.core:jackson-annotations
- com.fasterxml.jackson.core:jackson-core
- com.fasterxml.jackson.core:jackson-databind
- com.fasterxml.jackson.core:jackson-dataformat-yaml
- com.fasterxml.jackson.core:jackson-datatype-jsr30

2.58.2

Stream dependencies

REMOVED

2.58.2

Stream dependencies

CHANGED

Upgraded the following io.circe libraries from the 0.10.0 to 0.14.1 version:
- io.circe:circe-core_2.12
- io.circe:circe-generic_2.12
- io.circe:circe-parser_2.12

2.58.2

Stream dependencies

CHANGED

Upgraded the com.google.code.gson:gson library from the 2.8.6 version to the 2.8.9 version to fix vulnerabilities.

2.57.3

Archetypes

REMOVED

Removed *_proto-*-empty.jar and *_json-*-empty.jar files from the Schema Archetype.

2.57.3

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

artifact:1.2.6 blob:1.2.6 publish:1.2.6 volatileblob:1.2.6 config:1.2.6

2.57.3

Data Processing Library

CHANGED

AllowListFilter now supports specifying a catalog ID with an empty list of layers to
signify that any layer in that catalog will match the filter.
A full list of desired layers previously needed to be provided, which would be
bothersome to maintain as the set of required input layers evolved.

This can be used to accept any layer from a catalog, with or without an additional
partition name filter.

2.57.3

Data Processing Library

ADDED

Added a new API in the Retriever component to allow users to download a payload as an InputStream.

The new API is:

  def getPayloadAsInputStream(key: Partition.Key, meta: Partition.Meta): InputStream

It is supported both in Java and in Scala. It is worth to remark that payloads retrieved as streams in this
way will not be cached.

2.57.3

Location Library

DEPRECATED

Deprecate the data-loader module.

For more information about the new APIs, see the Developer Guide:

- High-Level API v2
- Working with OLR
- Working with TMC References

Please note that for TmcAdjacencyProviders only the deprecated API is
available.

2.57.3

Location Library

REMOVED

Remove deprecated methods from OptimizedMapCatalog, use the DSL methods instead.

2.57.3

Location Library

DEPRECATED

Deprecated OptimizedMapLayers.RoutingGraphConfiguration in favor of
OptimizedMapLayers.RoutingGraphLayerConfiguration.

Deprecated OptimizedMapLayers.RestrictedManoeuvreConfiguration in favor of
OptimizedMapLayers.RestrictedManoeuvreLayerConfiguration.

2.57.3

Location Library

ADDED

Added support for LocalRoad.ParkingAisle attribute in NavigationAttributes.

2.56.2

Data Processing Library

ADDED

Added compressedSize field to Partition.Meta. For backward compatibility the field isn't
retrieved by default, but the set of additional fields an application wants to populate can be
configured on a per-catalog basis in application.conf. For example:

here.platform.data-processing.driver.catalogs {
  default {
    // Additional metadata fields queried and included in the input Meta objects.
    // Valid values are: checksum, size, compressedSize
    additionalFields = [checksum, size]
  }

  // Configuration overrides for specific catalogs IDs.
  // For the output catalog, regardless of the configuration, the checksum field is always
  // included in additionalFields because it is needed by the library itself to implement its
  // incremental publishing.
  overrides {
    // Partial overrides indexed by catalog ID.
    //
     "input-catalog-1" {
       // no optional metadata fields
       additionalFields = []
     }

     "input-catalog-2" {
       // size and compressedSize
       additionalFields = [size, compressedSize]
     }

     "output" {
       // metadata fields for the output layers used as input. The metadata will in practice
       // always include the checksum field, which is mandatory for the output metadata and used
       // to implement incremental publishing.
       additionalFields = [compressedSize]
     }
  }
}

This change introduced a small backward incompatibility for Scala users using
Partition.Meta.unapply, due to the additional optional compressedSize field.

2.56.2

Location Library

ADDED

Added support for LocalRoad.ParkingAisle attribute in NavigationAttributes.

2.55.5

Location Library

DEPRECATED

2.55.5

Location Library

REMOVED

Remove deprecated methods from OptimizedMapCatalog, use the DSL methods instead.

2.55.5

Location Library

DEPRECATED

2.55.5

Examples

CHANGED

Changed the following examples to run them using sbt:

- Infer Stop Sign Locations from Automotive Sensor Observations
- Geometry Lifter
- Pedestrian Topologies Extraction to GeoJSON
- Pedestrian Topologies Extraction to Protobuf
- Statistics creation across multiple processing runs with stateful processing
- Here Map Content Diff-Tool
- Point Matching Example
- Point Matching Example
- Point Matching Example
- Point Matching Example
- Traversing the Graph
- Most Probable Path
- Path Matching Example
- Path Matching with Restrictions
- Turn Restrictions
- Generic Range Based Attributes
- Path Matching Sparse Probe Data
- Converting References from HERE Optimized Map for Location Library to HERE Map Content
- Converting References from TPEG2 to its Binary Representation
- Extracting TPEG2 Document
- Creating and Resolving TMC Reference
- Resolving TMC References in RTTI Message
- Creating OpenLR Reference from Road Segments
- Resolving OpenLR Reference from Road Segments
- Functional Class for a Vertex
- ADAS Curvature Attribute

2.54.3

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

artifact:1.2.4

2.54.3

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

metadata:1.2.5 config:1.2.5

2.54.3

Location Library

DEPRECATED

Deprecate methods which use the DataLoaderProvider.

For more information about the new APIs, see the Developer Guide:

- High-Level API v2
- Working with OLR
- Working with TMC References

2.54.3

Location Library

REMOVED

Remove deprecated methods from OptimizedMapCatalog, use the DSL methods instead.

2.54.3

Tutorials

CHANGED

Changed the Maven version to 3.9.4.

2.54.3

Examples

CHANGED

Changed the Maven version to 3.9.4.

2.53.5

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

artifact:1.2.4

2.52.8

Data Client Base Library

ADDED

Added the
Public Transit API v8
OLS client.

For more details and small examples please refer to

- https://developer.here.com/documentation/data-client-base/dev_guide/client/api-ols-public-transit-v8.html

2.52.8

Data Client Base Library

ADDED

Added the
HERE Destination Weather v3
OLS client.

For more details and small examples please refer to

- https://developer.here.com/documentation/data-client-base/dev_guide/client/api-ols-weather-v3.html

2.52.8

Data Client Library

FIXED

The call:

queryApi.getFeatureCollectionByIds(
    layerId,
    ids,
    selection,
    context,
    version,
    author
)

was returning always the latest version. Fixed it by making the method return
the appropriate version of the feature collection.

2.52.8

Batch Libraries

ADDED

Added thePublic Transit API v8 OLS client to the SDK BOM files.

To use it, add the following dependency to your project:

<dependency>
    <groupId>com.here.platform.data.client.base</groupId>
    <artifactId>ols-public-transit-v8_${scala.compat.version}</artifactId>
</dependency>

2.52.8

Batch Libraries

ADDED

Added the HERE Destination Weather v3 OLS client to the SDK BOM files.

To use it, add the following dependency to your project:

      <dependency>
        <groupId>com.here.platform.data.client.base</groupId>
        <artifactId>ols-weather-v3_${scala.compat.version}</artifactId>
      </dependency>

2.52.8

Stream Libraries

ADDED

Added thePublic Transit API v8 OLS client to the SDK BOM files.

To use it, add the following dependency to your project:

<dependency>
    <groupId>com.here.platform.data.client.base</groupId>
    <artifactId>ols-public-transit-v8_${scala.compat.version}</artifactId>
</dependency>

2.52.8

Stream Libraries

ADDED

Added the HERE Destination Weather v3 OLS client to the SDK BOM files.

To use it, add the following dependency to your project:

      <dependency>
        <groupId>com.here.platform.data.client.base</groupId>
        <artifactId>ols-weather-v3_${scala.compat.version}</artifactId>
      </dependency>

2.52.8

Standalone Libraries

ADDED

Added thePublic Transit API v8 OLS client to the SDK BOM files.

To use it, add the following dependency to your project:

<dependency>
    <groupId>com.here.platform.data.client.base</groupId>
    <artifactId>ols-public-transit-v8_${scala.compat.version}</artifactId>
</dependency>

2.52.8

Standalone Libraries

ADDED

Added the HERE Destination Weather v3 OLS client to the SDK BOM files.

To use it, add the following dependency to your project:

      <dependency>
        <groupId>com.here.platform.data.client.base</groupId>
        <artifactId>ols-weather-v3_${scala.compat.version}</artifactId>
      </dependency>

2.51.5

Data Client Base Library

ADDED

Added the
HERE Traffic API
OLS client.

For more details and small examples please refer to

- https://developer.here.com/documentation/data-client-base/dev_guide/client/api-ols-traffic-v7.html

2.51.5

Data Client Base Library

ADDED

Added the
HERE Search - Reverse Geocoder
OLS client.

For more details and small examples please refer to

- https://developer.here.com/documentation/data-client-base/dev_guide/client/api-ols-revgeocode-search-v1.html

2.51.5

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

artifact:1.2.3 config:1.2.3

2.51.5

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

publish:1.2.4 interactive-map-v1:1.2.4 config:1.2.4

2.51.5

Data Client Library

ADDED

Added new methods for versioning handling in interactive map layers

For retrieving the existing Changesets from the layer with a version range
[startVersion, endVersion]

- com.here.platform.data.client.scaladsl.QueryApi.getFeatureChanges(layerId, startVersion, endVersion, limit)
- com.here.platform.data.client.javadsl.QueryApi.getFeatureChanges(layerId, startVersion, endVersion, limit)

For retrieving one Changeset from the layer with a specific version

- com.here.platform.data.client.scaladsl.QueryApi.getFeatureChangesByVersion(layerId, version, limit)
- com.here.platform.data.client.javadsl.QueryApi.getFeatureChangesByVersion(layerId, version, limit)

For getting statistics about changesets in a layer.

- com.here.platform.data.client.scaladsl.QueryApi.getFeatureChangesStatistics(layerId)
- com.here.platform.data.client.javadsl.QueryApi.getFeatureChangesStatistics(layerId)

For deleting one or more changesets in a layer

- com.here.platform.data.client.scaladsl.PublishApi.deleteFeatureChanges(layerId, versionQuery)
- com.here.platform.data.client.javadsl.PublishApi.deleteFeatureChanges(layerId, versionQuery)

2.51.5

Data Client Library

CHANGED

Changed PublishApi.deleteFeatureChanges from

def deleteFeatureChanges(
layerId: String,
versionQuery: Option[String] = None
): Future[Done]

to:

def deleteFeatureChanges(
layerId: String,
versionQuery: VersionQuery
): Future[Done]

The previous API converts version query "<8" to the REST API call:
…?version=%3D8 which is not supported.

Created VersionQuery class to build the request correctly. Deleting changesets
older than version now can be done with:

publishApi.deleteFeatureChanges(
  layerId,
  VersionQuery.lessThan(version)
)

2.51.5

Data Client Library

REMOVED

Please notice that the following configuration properties for the flink
connector have been removed now.

If you still use it please replace it as described below.

- Usage of olp.index.query-parallelism should be replaced by
olp.connector.query-parallelism

- Usage of olp.version.query-parallelism should be replaced by
olp.connector.query-parallelism

2.51.5

Data Client Library

REMOVED

Please notice that the following methods have been removed now.

Please notice this is valid for Java only.

If you still use it please replace it as described below.

- Usage of
com.here.platform.data.client.engine.javadsl.WriteEngine.blobCrc(layer: String, blob: scaladsl.NewPartition.BufferedBlob): CompletionStage[Optional[String]]
needs to be replaced by
com.here.platform.data.client.engine.javadsl.WriteEngine.blobCrc(layer: String, blob: BufferedBlob): CompletionStage[Optional[String]]

- Usage of
com.here.platform.data.client.engine.javadsl.WriteEngine.blobChecksum(layer: String, blob: scaladsl.NewPartition.BufferedBlob): CompletionStage[Optional[String]]
needs to be replaced by
com.here.platform.data.client.engine.javadsl.WriteEngine.blobChecksum(layer: String, blob: BufferedBlob): CompletionStage[Optional[String]]

2.51.5

Data Client Library

ADDED

Added support of BOOL countMode to the existing Interactive Map Layer
endpoints methods:

- com.here.platform.data.client.scaladsl.QueryApi.getQuadBinsByTileId
- com.here.platform.data.client.scaladsl.QueryApi.getQuadBinsByBbox

Added context parameter to the existing Interactive Map Layer endpoints
methods:

- com.here.platform.data.client.scaladsl.QueryApi.getFeatureCollectionByIds
- com.here.platform.data.client.scaladsl.QueryApi.getFeatureCollectionByBbox
- com.here.platform.data.client.scaladsl.QueryApi.getFeatureCollectionByTile
- com.here.platform.data.client.scaladsl.QueryApi.getFeatureCollectionBySearchParam
- com.here.platform.data.client.scaladsl.QueryApi.getFeatureCollectionBySpatialSearchCircle
- com.here.platform.data.client.scaladsl.QueryApi.getFeatureCollectionBySpatialSearchFeature
- com.here.platform.data.client.scaladsl.QueryApi.getFeatureCollectionBySpatialSearchGeometry
- com.here.platform.data.client.scaladsl.QueryApi.getFeatureCollectionByIterate
- com.here.platform.data.client.scaladsl.QueryApi.getQuadBinsByTileId
- com.here.platform.data.client.scaladsl.QueryApi.getQuadBinsByBbox
- com.here.platform.data.client.scaladsl.QueryApi.getHexBinsByTileId
- com.here.platform.data.client.scaladsl.QueryApi.getHexBinsByBbox
- com.here.platform.data.client.javadsl.QueryApi.getFeatureCollectionByIds
- com.here.platform.data.client.javadsl.QueryApi.getFeatureCollectionByBbox
- com.here.platform.data.client.javadsl.QueryApi.getFeatureCollectionByTile
- com.here.platform.data.client.javadsl.QueryApi.getFeatureCollectionBySearchParam
- com.here.platform.data.client.javadsl.QueryApi.getFeatureCollectionBySpatialSearchCircle
- com.here.platform.data.client.javadsl.QueryApi.getFeatureCollectionBySpatialSearchFeature
- com.here.platform.data.client.javadsl.QueryApi.getFeatureCollectionBySpatialSearchGeometry
- com.here.platform.data.client.javadsl.QueryApi.getFeatureCollectionByIterate
- com.here.platform.data.client.scaladsl.PublishApi.deleteFeatures
- com.here.platform.data.client.javadsl.PublishApi.deleteFeatures

For more details please refer to:
Get Data
and
Publish Data
sections in Data Client Library documentation

Added support of Interactive Map Layer context in Spark reading and deleting.
For more details please refer to:
Read interactive map layer data
and
Delete interactive map layer data
sections in Data Client Library documentation

2.51.5

Data Client Library

ADDED

Added new method to retrieve all the tiles containing features from
interactive map layer:

- com.here.platform.data.client.scaladsl.QueryApi.getTilesContainingFeatures

For more details and small examples please refer to:
'Get Data' section in Data Client Library documentation

2.51.5

Data Client Library

FIXED

Fixed The response payload was too large errors when downloading data
exceeding 50MB. Now, they're getting split into multiple requests. Fix
implemented in methods:

- com.here.platform.data.client.scaladsl.QueryApi.getFeatureCollectionByIds
- com.here.platform.data.client.scaladsl.QueryApi.getFeatureCollectionByBbox
- com.here.platform.data.client.scaladsl.QueryApi.getFeatureCollectionByTile
- com.here.platform.data.client.scaladsl.QueryApi.getFeatureCollectionBySpatialSearchGeometry
- com.here.platform.data.client.javadsl.QueryApi.getFeatureCollectionByIds
- com.here.platform.data.client.javadsl.QueryApi.getFeatureCollectionByBbox
- com.here.platform.data.client.javadsl.QueryApi.getFeatureCollectionByTile
- com.here.platform.data.client.javadsl.QueryApi.getFeatureCollectionBySpatialSearchGeometry

2.51.5

Data Client Library

FIXED

Fixed URL too long errors when too many IDs were provided in a single request.
Now, they're getting split into multiple requests. Fix implemented in methods:

- com.here.platform.data.client.scaladsl.QueryApi.getFeatureCollectionByIds
- com.here.platform.data.client.javadsl.QueryApi.getFeatureCollectionByIds

2.51.5

Tutorials

ADDED

Added the Use HERE Platform Service tutorial that demonstrates how to use HERE platform services through the example of the HERE Traffic API client.

2.51.5

Batch Libraries

ADDED

Added the HERE Search - Forward Geocoder OLS client to the SDK BOM files.

To use it, add the following dependency to your project:

<dependency>
    <groupId>com.here.platform.data.client.base</groupId>
    <artifactId>ols-geocode-v1_${scala.compat.version}</artifactId>
</dependency>

2.51.5

Batch Libraries

ADDED

Added the HERE Search - Reverse Geocoder OLS client to the SDK BOM files.

To use it, add the following dependency to your project:

<dependency>
  <groupId>com.here.platform.data.client.base</groupId>
  <artifactId>ols-revgeocode-v1_${scala.compat.version}</artifactId>
</dependency>

2.51.5

Batch Libraries

ADDED

Added the HERE Routing OLS client to the SDK BOM files.

To use it, add the following dependency to your project:

<dependency>
    <groupId>com.here.platform.data.client.base</groupId>
    <artifactId>ols-router-v8_${scala.compat.version}</artifactId>
</dependency>

2.51.5

Batch Libraries

ADDED

Added the HERE Traffic API OLS client to the SDK BOM files.

To use it, add the following dependency to your project:

      <dependency>
        <groupId>com.here.platform.data.client.base</groupId>
        <artifactId>ols-traffic-v7_${scala.compat.version}</artifactId>
      </dependency>

2.51.5

Stream Libraries

ADDED

Added the HERE Search - Forward Geocoder OLS client to the SDK BOM files.

To use it, add the following dependency to your project:

<dependency>
    <groupId>com.here.platform.data.client.base</groupId>
    <artifactId>ols-geocode-v1_${scala.compat.version}</artifactId>
</dependency>

2.51.5

Stream Libraries

ADDED

Added the HERE Search - Reverse Geocoder OLS client to the SDK BOM files.

To use it, add the following dependency to your project:

<dependency>
  <groupId>com.here.platform.data.client.base</groupId>
  <artifactId>ols-revgeocode-v1_${scala.compat.version}</artifactId>
</dependency>

2.51.5

Stream Libraries

ADDED

Added the HERE Routing OLS client to the SDK BOM files.

To use it, add the following dependency to your project:

<dependency>
    <groupId>com.here.platform.data.client.base</groupId>
    <artifactId>ols-router-v8_${scala.compat.version}</artifactId>
</dependency>

2.51.5

Stream Libraries

ADDED

Added the HERE Traffic API OLS client to the SDK BOM files.

To use it, add the following dependency to your project:

      <dependency>
        <groupId>com.here.platform.data.client.base</groupId>
        <artifactId>ols-traffic-v7_${scala.compat.version}</artifactId>
      </dependency>

2.51.5

Standalone Libraries

ADDED

Added the HERE Search - Forward Geocoder OLS client to the SDK BOM files.

To use it, add the following dependency to your project:

<dependency>
    <groupId>com.here.platform.data.client.base</groupId>
    <artifactId>ols-geocode-v1_${scala.compat.version}</artifactId>
</dependency>

2.51.5

Standalone Libraries

ADDED

Added the HERE Search - Reverse Geocoder OLS client to the SDK BOM files.

To use it, add the following dependency to your project:

<dependency>
  <groupId>com.here.platform.data.client.base</groupId>
  <artifactId>ols-revgeocode-v1_${scala.compat.version}</artifactId>
</dependency>

2.51.5

Standalone Libraries

ADDED

Added the HERE Routing OLS client to the SDK BOM files.

To use it, add the following dependency to your project:

<dependency>
    <groupId>com.here.platform.data.client.base</groupId>
    <artifactId>ols-router-v8_${scala.compat.version}</artifactId>
</dependency>

2.51.5

Standalone Libraries

ADDED

Added the HERE Traffic API OLS client to the SDK BOM files.

To use it, add the following dependency to your project:

      <dependency>
        <groupId>com.here.platform.data.client.base</groupId>
        <artifactId>ols-traffic-v7_${scala.compat.version}</artifactId>
      </dependency>

2.51.5

Batch dependencies

CHANGED

Upgraded org.yaml:snakeyaml version from 1.15 to 2.0.

2.51.5

Batch dependencies

CHANGED

Upgraded com.google.code.gson:gson version from 2.8.6 to 2.8.9.

2.51.5

Batch dependencies

CHANGED

Upgraded commons-io version from 2.4 to 2.7.

2.51.5

Standalone dependencies

CHANGED

Upgraded org.yaml:snakeyaml version from 1.15 to 2.0.

2.51.5

Standalone dependencies

CHANGED

Upgraded com.google.code.gson:gson version from 2.8.6 to 2.8.9.

2.51.5

Standalone dependencies

CHANGED

Upgraded commons-io version from 2.4 to 2.7.

2.51.5

Stream dependencies

CHANGED

Upgraded org.yaml:snakeyaml version from 1.15 to 2.0.

2.51.5

Stream dependencies

CHANGED

Upgraded com.google.code.gson:gson version from 2.8.6 to 2.8.9.

2.51.5

Stream dependencies

CHANGED

Upgraded commons-io version from 2.4 to 2.7.

2.50.4

Data Archiving Library

ADDED

Added the ability to pass source and sink catalogs through the pipeline-config.conf file.

2.50.4

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

query:1.2.2 artifact:1.2.2 blob:1.2.2 publish:1.2.2 notifications:1.2.2
metadata:1.2.2 config:1.2.2

2.50.4

Data Client Library

ADDED

Added versioning support for interactive map layers with the attribute
versionsToKeep. the attribute is of type integer between 1 and 1,000,000,000.
When the attribute is set to 1 this means that versioning is disabled for the
underlying layer.

2.50.4

Data Client Library

CHANGED

Changed the context parameter for Java bindings for interactive map layers from
InteractiveMapContext to Optional[InteractiveMapContext] inside:

- com.here.platform.data.client.javadsl.QueryApi
- com.here.platform.data.client.javadsl.PublishApi

to migrate to the new changes just replace context with Optional.of(context)
whenever you use an InteractiveMapContext.

2.50.4

Data Client Library

ADDED

Added version and author parameters to the existing IML endpoints methods:

- com.here.platform.data.client.javadsl.QueryApi.getFeatureCollectionByIds
- com.here.platform.data.client.scaladsl.QueryApi.getFeatureCollectionByIds
- com.here.platform.data.client.javadsl.QueryApi.getFeatureCollectionBySearchParam
- com.here.platform.data.client.scaladsl.QueryApi.getFeatureCollectionBySearchParam

Added version parameter to the existing IML endpoints methods:

- com.here.platform.data.client.javadsl.QueryApi.getFeatureCollectionByBbox
- com.here.platform.data.client.scaladsl.QueryApi.getFeatureCollectionByBbox
- com.here.platform.data.client.scaladsl.QueryApi.getHexBinsByBbox
- com.here.platform.data.client.scaladsl.QueryApi.getQuadBinsByBbox
- com.here.platform.data.client.javadsl.QueryApi.getFeatureCollectionByTile
- com.here.platform.data.client.scaladsl.QueryApi.getFeatureCollectionByTile
- com.here.platform.data.client.scaladsl.QueryApi.getQuadBinsByTileId
- com.here.platform.data.client.scaladsl.QueryApi.getHexBinsByTileId
- com.here.platform.data.client.javadsl.QueryApi.getFeatureCollectionBySpatialSearchCircle
- com.here.platform.data.client.javadsl.QueryApi.getFeatureCollectionBySpatialSearchFeature
- com.here.platform.data.client.javadsl.QueryApi.getFeatureCollectionBySpatialSearchGeometry
- com.here.platform.data.client.scaladsl.QueryApi.getFeatureCollectionBySpatialSearchCircle
- com.here.platform.data.client.scaladsl.QueryApi.getFeatureCollectionBySpatialSearchFeature
- com.here.platform.data.client.scaladsl.QueryApi.getFeatureCollectionBySpatialSearchGeometry
- com.here.platform.data.client.javadsl.QueryApi.getFeatureCollectionByIterate
- com.here.platform.data.client.scaladsl.QueryApi.getFeatureCollectionByIterate

2.50.4

Data Client Library

CHANGED

Changed the layer ID attribute of the GetFeatureCollectionBy* IML endpoints
from layer to layerId.

2.50.4

Location Library

ADDED

Added support for user defined country code in road attributes. See:

- com.here.platform.location.integration.optimizedmap.graph.PropertyMaps.RoadAttributes#userDefinedCountryCode
- com.here.platform.location.integration.optimizedmap.graph.javadsl.PropertyMaps.RoadAttributes#userDefinedCountryCode

The attribute is available starting with the following versions of Optimized Map
for Location Library:

- hrn:here:data::olp-here:here-optimized-map-for-location-library-2 version 5060
- hrn:here:data::olp-here:here-optimized-map-for-location-library-japan-2
version 85
- hrn:here-cn:data::olp-cn-here:here-optimized-map-for-location-library-china-2
version 10
- hrn:here-cn:data::olp-cn-here:here-optimized-map-for-location-library-china-2-staging
version 34

2.49.2

Archetypes

FIXED

Fixed the org.apache.http.impl.client.DefaultRedirectStrategy.<init>([Ljava/lang/String;)V error when use the HERE platform Maven Wagon plugin with Intellij IDEA.

2.49.2

Location Library

REMOVED

Removed deprecated TMC methods which were not forcing addition of internal
primary location to TMC reference in case the precise TMC information is needed
(only companion object methods in Scala and static methods in Java):

- LocationReferenceCreators.extendedTmc
- LocationReferenceCreators.piecewiseExtendedTmc
- LocationReferenceResolver.extendedTmc

2.49.2

Location Library

FIXED

Fixed an issue in TMC reference creation which resulted in a precise TMC
information exceeding TMC reference for more than 100 m. Affected all TMC
creators, namely:

- LocationReferenceCreators.tmc
- LocationReferenceCreators.extendedTmc
- LocationReferenceCreators.piecewiseExtendedTmc
- TmcLocationReferenceCreators.tmc
- TmcLocationReferenceCreators.extendedTmc
- TmcLocationReferenceCreators.piecewiseExtendedTmc

2.49.2

Location Library

FIXED

Fixed an issue with resolving TMC references with precise TMC info, when the
problem length is greater than the full reference length. The output location is
trimmed to prevent exceeding the TMC reference in this case.

Also, when a precise TMC info with a nonpositive problem length is used, an
exception is thrown, since this input is invalid.

All TMC resolvers are affected, namely:

- LocationReferenceResolvers.tmc
- LocationReferenceResolvers.extendedTmc
- LocationReferenceResolvers.extendedTmcV2
- TmcLocationReferenceResolvers.tmc
- TmcLocationReferenceResolvers.extendedTmc

2.49.2

Tutorials

CHANGED

Changed the Get real-time traffic conditions for a location tutorial to use the new HERE Traffic Flow catalog.

2.48.3

Archetypes

FIXED

Fixed the compatibility issue between Maven 3.9.0 and Maven Wagon throwing the "AbstractMethodError: Receiver class com.here.platform.artifact.maven.wagon.layout.HereRepositoryLayout does not define or inherit an implementation of the resolved method 'abstract java.util.List getChecksumAlgorithmFactories()' of interface org.eclipse.aether.spi.connector.layout.RepositoryLayout" error.

2.48.3

Data Client Library

ADDED

There were added new optional parameters to catalog configuration for
location-aware access control.

| Property | Description |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| areaScheme | The HERE Resource Name (HRN) of the area scheme used across the catalog. If the value is not set than no area scheme is applied to the catalog. |
| subsetRestrictions | Indicates if the subsetRestrictions for a catalog is enabled or not. subsetRestrictions can only be enabled for catalogs that are defined within projects. It requires area scheme being set. If catalog subsetRestrictions are disabled, supported layer's subsetRestrictions will be disabled by default. |

Please note that the only area scheme currently available is
hrn:here:areascheme::olp-here:default-countries.

Furthermore, you can control the subset restictions per versioned and volatile
layer if enabled on catalog level. For that you should pass these new optional
parameters when defining the layerType of a layer as

- VersionedLayerType(secureHandles: Option[Boolean] = None, subsetRestrictions: Option[Boolean] = None)
or
- VolatileLayerType(secureHandles: Option[Boolean] = None, subsetRestrictions: Option[Boolean] = None).

| Property | Description |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| secureHandles | A boolean flag which indicates if the layer metadata and blob are in mode of secure data handles support. It requires catalog area scheme to be set and supports only heretile partitioning of the layer. |
| subsetRestrictions | A boolean flag which indicates if the subsetRestrictions for a layer is enabled or not. subsetRestrictions can only be enabled for layers of catalogs that are defined within projects. It requires area scheme of the catalog being set. Supported layer subsetRestrictions are enabled by default when subsetRestrictions is enabled for the catalog. Layer subsetRestrictions requires catalog subsetRestrictions to be enabled. If catalog subsetRestrictions are disabled, supported layer's subsetRestrictions will be disabled by default. Supported only for layers with heretile partitioning. |

There are also added 4 new functions of AdminApi to get information about area
subsets as there are

- getSubsets: Get the list of all accessible subsets which match the optional
areaId filter
- getSubsetsAsSource: Get the list of all accessible subsets which match the
optional areaId filter as an Akka Source
- getSubset: Get the details of a subset
- getSubsetsFingerprint: Get a fingerprint that represents the accessible
subset configuration

2.48.3

Data Client Library

CHANGED

Please note that all specific layer types are objects now. This was necessary
for VersionedLayerType and VolatileLayerType due to the introduction of new
parameters for location-aware access control.

However, we decided to align the other specific layer types as well.

Therefore please notice this backward-incompatible change. Unfortunately, you
need to change your code as follows:

| Language | Before | Now |
| -------- | ----------------------------- | ------------------------------------------- |
| Scala | VersionedLayerType | VersionedLayerType() |
| Scala | LayerTypes.Versioned | VersionedLayerType() |
| Java | LayerTypes.Versioned() | VersionedLayerType.defaultInstance() |
| Scala | LayerTypes.Volatile | VolatileLayerType() |
| Java | LayerTypes.Volatile() | VolatileLayerType.defaultInstance() |
| Scala | ObjectStoreLayerType | ObjectStoreLayerType() |
| Scala | LayerTypes.ObjectStore | ObjectStoreLayerType() |
| Java | LayerTypes.ObjectStore() | ObjectStoreLayerType.defaultInstance() |
| Scala | LayerTypes.InteractiveMap | InteractiveMapLayerType() |
| Java | LayerTypes.InteractiveMap() | InteractiveMapLayerType.defaultInstance() |
| Scala | LayerTypes.Index | IndexLayerType() |
| Java | LayerTypes.Index() | IndexLayerType.defaultInstance() |
| Scala | LayerTypes.Stream | StreamLayerType() |
| Java | LayerTypes.Stream() | StreamLayerType.defaultInstance() |

2.48.3

Data Client Library

ADDED

Added possibility for versioned layers only to specify output catalog
dependencies in spark-support with the method
LayerDataFrameWriter.withDependencies. Bellow a sample code how to do:

val df: DataFrame = ..
val dependencies: Seq[VersionDependency] = ..
df.writeLayer(catalogHRN, versionedLayerId)
  .withDependencies(dependencies)
  .save()

If not provided the dependencies will be empty by default.

2.48.3

Examples

DELETED

Deleted the following Data Archiving Library examples:

- Archiving SDII stream data in Protobuf
- Archiving SENSORIS stream data in Parquet

2.48.3

Examples

CHANGED

Updated the following Data Archiving Library examples to run them locally using Maven:

- Archiving SDII Stream Data in Avro format
- Archiving SDII stream data in Parquet
- Archiving Sensoris Stream Data in Protobuf format

2.48.3

Examples

CHANGED

Changed the Data Processing Library examples to use local output catalogs.

2.48.3

Examples

CHANGED

Updated the following Index Compaction Library examples to run them locally using Maven:

- Compacting Index Layer Data in Parquet Format
- Compacting Index Layer Data in Protobuf Format

2.48.3

Examples

ADDED

Added instructions how to run Location Library examples using local catalogs.

2.48.3

Batch dependencies

CHANGED

Upgraded ch.qos.logback:logback-core and ch.qos.logback:logback-classic version from 1.2.3 to 1.3.5.

2.48.3

Standalone dependencies

CHANGED

Upgraded ch.qos.logback:logback-core and ch.qos.logback:logback-classic version from 1.2.3 to 1.3.5.

2.48.3

Stream dependencies

CHANGED

Upgraded ch.qos.logback:logback-core and ch.qos.logback:logback-classic version from 1.2.3 to 1.3.5.

2.47.2

Data Client Base Library

ADDED

Added API client for Artifact Service For more details and small examples please
refer to

- Data Client Artifact API
- Data Client References API
- Data Client Schema API

2.47.2

Data Processing Library

ADDED

Added SamplingLogger, a ContextAwareLogger with sampling capabilities that reduce clutter and
costs incurred when the same log message is produced a large number of times, while retaining the
information a few samples provide.

2.47.2

Location Library

CHANGED

Changed high-level-v2 API OptimizedMapLayers provided by the new
OptimizedMapCatalog that replaces the high-level API based on Data Loaders
(CatalogFactory) by introducing last tile optimization.

This optimization is expected to bring a 30% performance improvement with
respect to the previous Data Loaders in multi-threaded applications and a 50%
improvement in the previous versions of OptimizedMapLayers.

2.47.2

Location Library

CHANGED

Changed the following map matcher parameters to improve the behavior on very
sparse data:

- The limit on iterations in the
TransitionProbabilityStrategies.distanceWithTransitions while connecting
distant points was removed and replaced with a road distance limit of
approximately 30km.
- The probability assigned to any transition to or from an Unknown has been
lowered to avoid disconnections for sparse points.

2.47.2

Location Library

CHANGED

Deprecate SimpleConnectivityTransitionProbabilityStrategy in favor of
DistanceTransitionProbabilityStrategy and
TransitionProbabilityStrategies.connectivity in favor of
TransitionProbabilityStrategies.directDistance.

2.47.2

Location Library

CHANGED

Changed the OptimizedMapLayers provided by the new OptimizedMapCatalog v2
high level API with lazy requests to the config service that are delayed after
initialization until the first use.

2.46.5

Archetypes

REMOVED

Removed the archetype documentation.
Information about archetypes available at:
- Protobuf schema archetype
- JSON schema archetype
- Batch archetype
- Streaming archetype

2.46.5

Archetypes

FIXED

Fixed an issue when dependencies are not included in layer.fds in case the messages are not used in the main message.

2.46.5

Data Client Library

ADDED

Added and optional parameter to listObjects and listObjectsAsCollection
functions of ReadEngine and FlinkReadEngine to define the internal page
size.

Background:

As a user you always get the full list either as a Source or a List.
However, the default page size is 1000 and if you have an ObjectStore folder
which has 1 million objects then it would fire a 1000 requests. This is slow.
So, if you already know or you suspect that there is a large number of objects
you can optimize the runtime very much by defining a higher value for the
pageSize parameter.

2.46.5

Data Client Library

ADDED

A new feature was added which allows you to subscribe to changes of an
interactive map layer. For further reading please see the
Data Client Library Developer Guide.

2.46.5

Location Library

FIXED

Fixed an issue with too long OpenLR references for point along a line.

OpenLR standard requires the distances between reference points to be smaller
than 15km. In some cases of point along a line reference longer distances were
produced. This change is fixing that and implementing an algorithm of choosing
invalid (i.e. non-junction) nodes as first and last reference points in case
valid points are too far from the access point or from each other.

The algorithm chooses always the most distant invalid nodes possible (stretches
the reference up to 15km if there are no valid nodes closer) and prefers
choosing one valid and one invalid node over two invalid ones whenever possible.
It also keeps the access point in the middle of the reference in extreme case of
need to chose two invalid nodes (as first and last).

2.46.5

Tutorials

ADDED

Added the Implement GeoJSON Renderer tutorial that demonstrates how to implement the GeoJSON rendering plugin using the Data Inspector.

2.46.5

Tutorials

ADDED

Added the Publish Protobuf schema to the platform tutorial that demonstrates how to generate, build, extend and publish Protobuf schema to the platform.

2.46.5

Tutorials

CHANGED

Updated the Develop a Flink application and Develop a Spark application tutorials with the information about Maven archetypes.

2.46.5

Tutorials

CHANGED

Updated the Subscribe to catalog and layer-level changes tutorial to use olp catalog layer notification commands.

2.45.7

Data Client Library

REMOVED

The following functions have been removed after end of deprecation notice
period:

- ReadEngine.getObjectDataAsSource
- ReadEngine.getObjectDataAsBytes
- ReadEngine.listObjectsAsSource
- WriteEngine.uploadObject
- WriteEngine.startUploadObject
- WriteEngine.simpleUploadObject
- FlinkReadEngine.getObjectDataAsBytes
- FlinkWriteEngine.uploadObject

2.45.7

Location Library

ADDED

Added a new DSL for constructing OptimizedMapCatalog. In order to avoid direct
usage of other libraries apart from location library as far as possible, a new
DSL was added to construct OptimizedMapCatalog. It makes sure that in the
compile time the user won't pass both external caches and cache configuration.
The DSL is almost identical in Java and Scala, since it uses a universal DSL
pattern (multiple builder classes).

2.45.7

Location Library

DEPRECATED

Deprecated the OptimizedMapCatalog API based on apply methods in Scala and
single builder in Java. Instead, use new DSL consistent for Scala and Java.

2.45.7

Tutorials

CHANGED

Path matching in Spark tutorial has been updated to use new Location Library
OptimizedMapCatalog DSL instead of the deprecated API.

2.45.7

Tutorials

FIXED

Fixed the Extract Apache Hadoop section in the Bring your data into HERE platform using an object store layer tutorial
returning the Cannot create symlink error for Windows users.

2.45.7

Examples

CHANGED

Location Library examples have been updated to use new OptimizedMapCatalog DSL
instead of the deprecated API.

2.44.4

Archetypes

FIXED

Fixed the problem of the wrong 3.6.0 version of protoc being used when running the layer-manifest-plugin.
The correct 3.11.4 version is now used in all HERE plugins.

2.44.4

Data Client Library

CHANGED

Changed API's return type to return list of updated features while calling api
to update feature modifications from flink pipelines, cli and hadoop fs.

2.44.4

Tutorials

ADDED

Added a Publish JSON schema to the platform that demonstrates how to generate, build, and publish JSON schema to the platform.

2.44.4

Examples

CHANGED

The examples that were using the Location Library Data Loaders, with the exception of the OnTheFlyCompiledPropertyMapExample have been updated to use the new OptimizedMapCatalog available in the location-integration-optimized-map-dcl2 module as documented in the Location Library developer guide in the section "High Level API v2"

2.43.5

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs:

blob:1.0.7 notifications:2.0.1 ingest:1.1.3 config:1.1.13 publish:2.0.2
volatileblob:1.0.2 index:1.1.2 stream:2.1.2 metadata:1.0.7 query:1.0.3
blob-v2:2.0.1 interactive-map-v1:1.0.0

2.43.5

Data Processing Library

ADDED

Adds a forceStateless option for DeltaSet transformations, that can force any transformation to be
stateless. This will avoid the overhead incurred by the state, but the transformation will
not be able to track dependencies between partitions during an incremental run. In practice,
this means that in an incremental run, the DeltaSet has to process all upstream partitions,
whether they changed or not, unless it can determine that the upstream DeltaSet did not change
at all.

2.43.5

Location Library

ADDED

Introduced new experimental Apis based on OptimizedMapLayers for
LocationReferenceCreators and LocationReferenceResolvers which allow
multi-version caching.

2.43.5

Tutorials

CHANGED

Changed the Develop Flink application tutorial to use the PipelineContext for getting information about input catalogs.

2.43.5

Stream dependencies

ADDED

Added com.google.errorprone:error_prone_annotations:2.3.4 library to sdk-dep-common file to fix dependency conflicts in the com.google.protobuf:protobuf-java-util:3.11.4 library.

2.43.5

Stream dependencies

CHANGED

Upgraded the com.google.code.findbugs:jsr305 version from 1.3.9 to 3.0.2 to align versions com.google.protobuf:protobuf-java-util:3.11.4 library.

2.43.5

Stream dependencies

CHANGED

Upgraded the com.google.protobuf:protobuf-java and com.google.protobuf:protobuf-java-util versions from 3.6.0 to 3.11.4.

2.43.5

Stream dependencies

CHANGED

Upgraded the com.thesamet.scalapb:compilerplugin_$\{scala.compat.version\}, com.thesamet.scalapb:lenses_$\{scala.compat.version\} and com.thesamet.scalapb:scalapb-runtime_$\{scala.compat.version\} versions from 0.8.0 to 0.10.10.

Note that all messages are now preserving unknown fields by default.
This results in an additional parameter to the case class. This may break your code if you are using pattern matching and expecting a specific number of parameters.
Use the of(your, case, class, parameters) static method if you do not want to specify the unknownFields parameter when creating an instance of the case class.

See the scalapb changelog to get more information about changes in the scalapb library.

2.43.5

Standalone dependencies

ADDED

Added com.google.errorprone:error_prone_annotations:2.3.4 library to sdk-dep-common file to fix dependency conflicts in the com.google.protobuf:protobuf-java-util:3.11.4 library.

2.43.5

Standalone dependencies

CHANGED

Upgraded the com.google.code.findbugs:jsr305 version from 1.3.9 to 3.0.2 to align versions com.google.protobuf:protobuf-java-util:3.11.4 library.

2.43.5

Standalone dependencies

CHANGED

Upgraded the com.google.protobuf:protobuf-java and com.google.protobuf:protobuf-java-util versions from 3.6.0 to 3.11.4.

2.43.5

Standalone dependencies

CHANGED

2.43.5

Batch dependencies

ADDED

Added com.google.errorprone:error_prone_annotations:2.3.4 library to sdk-dep-common file to fix dependency conflicts in the com.google.protobuf:protobuf-java-util:3.11.4 library.

2.43.5

Batch dependencies

CHANGED

Upgraded the com.google.code.findbugs:jsr305 version from 1.3.9 to 3.0.2 to align versions com.google.protobuf:protobuf-java-util:3.11.4 library.

2.43.5

Batch dependencies

CHANGED

Upgraded the com.google.protobuf:protobuf-java and com.google.protobuf:protobuf-java-util versions from 3.6.0 to 3.11.4.

2.43.5

Batch dependencies

CHANGED

2.42.4

Data Client Library

ADDED

Added support for postFeatureModifications API to update features in an
interactive map layer. This api accepts featureModificationList which contains a
list of FeatureModification objects. As each FeatureModification contains &
action details if features exist/doesn't exist, this API allows users to define
different actions on different features in single api call.

2.42.4

Data Client Library

CHANGED

Spark schema derivation process was updated to throw exception and interrupt job
in case of any failures during schema infer

2.42.4

Data Processing Library

FIXED

Fixed bug that caused IllegalArgumentExceptions when Default.PreviousRunId inputs were used
for multiple runs without a monotonically non-decreasing sequence of input versions.

2.42.4

Location Library

FIXED

Fixes an issue in the recently introduced methods:

- com.here.platform.location.referencing.LocationReferenceCreators.extendedTmcV2
- com.here.platform.location.referencing.LocationReferenceCreators.piecewiseExtendedTmcV2

In particular, it fixes the calculation of the hazardDistance1 of the
PreciseTMCInformation of TMCLocationReference when an incident doesn't
include TMC primary location, that is, when useInternalPrimaryLocation is
false.

2.41.4

Location Library

ADDED

The following function overloads have been added with an extra geometry
parameter:

- com.here.platform.location.core.mapmatching.javadsl.TransitionProbabilityStrategiesMixin.distanceWithTransitions
- com.here.platform.location.core.mapmatching.scaladsl.TransitionProbabilityStrategiesMixin.distanceWithoutTransitions
- com.here.platform.location.core.mapmatching.scaladsl.TransitionProbabilityStrategiesMixin.distanceWithTransitions

2.41.4

Location Library

CHANGED

The execution time of the path matcher created by
PathMatchers.carPathMatcherWithTransitions and
PathMatchers.unrestrictedPathMatcherWithTransitions was reduced by up to 50%
for sparse probes using a patent pending algorithm.

2.41.4

Location Library

DEPRECATED

The following methods have been deprecated:

- com.here.platform.location.core.mapmatching.javadsl.TransitionProbabilityStrategiesMixin.distanceWithTransitions
- com.here.platform.location.core.mapmatching.scaladsl.TransitionProbabilityStrategiesMixin.distanceWithoutTransitions
- com.here.platform.location.core.mapmatching.scaladsl.TransitionProbabilityStrategiesMixin.distanceWithTransitions

Use the corresponding overloads with the geometry parameter instead.

2.41.4

Tutorials

REMOVED

Removed the Getting live weather conditions for a location tutorial from HERE Data Java/Scala SDK.

2.41.4

Stream dependencies

CHANGED

Now the platform profile in sdk-stream-bom_2.12 automatically excludes any application.properties file there might be in the resources folder from the fat JAR, to avoid shadowing the application.properties file made available by the Pipeline service. To revert this behavior please use a custom profile.

2.40.0.7

Location Library

ADDED

Introduced new experimental constructors based on OptimizedMapLayers for
RoadAttributes, NavigationAttributes, AdvancedNavigationAttributes and
AdasAttributes, which allow multi-version caching.

2.40.0.7

Location Library

ADDED

New implementations have been added for Extended TMC Reference creation and
resolution, namely:

- com.here.platform.location.referencing.LocationReferenceCreators.extendedTmcV2
- com.here.platform.location.referencing.LocationReferenceCreators.piecewiseExtendedTmcV2
- com.here.platform.location.referencing.LocationReferenceResolvers.extendedTmcV2

The new methods correctly implement the TISA standard by measuring the
hazardDistance field of the PreciseTMCInformation always from a the so
called "Spatial reference point", located at the beginning of the Internal
Primary location.

2.40.0.7

Location Library

DEPRECATED

The following methods have been deprecated:

- com.here.platform.location.referencing.LocationReferenceCreators.extendedTmc
- com.here.platform.location.referencing.LocationReferenceCreators.piecewiseExtendedTmc
- com.here.platform.location.referencing.LocationReferenceResolvers.extendedTmc

Instead, use the *V2 counterparts:

- com.here.platform.location.referencing.LocationReferenceCreators.extendedTmcV2
- com.here.platform.location.referencing.LocationReferenceCreators.piecewiseExtendedTmcV2
- com.here.platform.location.referencing.LocationReferenceResolvers.extendedTmcV2

2.39.0.5

Archetypes

FIXED

Fixed issues with failing downloads and uploads of schemas. The operations failing with 408, 429, 500, 502, 503 or 504 errors now are automatically retried up to 5 times.

2.39.0.5

Archetypes

REMOVED

Removed Scala 2.11 support from the sdii_archive_v1 schema as of version 2.2.26.

2.39.0.5

Archetypes

REMOVED

Removed Scala 2.11 support from the sdii_v3 schema as of version 4.2.19.

2.39.0.5

Archetypes

REMOVED

Removed Scala 2.11 support from the sensoris-specification_v1_2_2 schema as of version 1.1.4.

2.39.0.5

Data Client Library

DEPRECATED

Be advised that the following configuration properties for the flink connector
are deprecated now. These deprecated properties will be removed after 6 months
from the release date, therefore replacing the usage of deprecated properties
with alternative property is necessary for its users.

- Usage of olp.index.query-parallelism should be replaced by
olp.connector.query-parallelism

- Usage of olp.version.query-parallelism should be replaced by
olp.connector.query-parallelism

2.39.0.5

Data Processing Library

ADDED

Added a new configuration option here.platform.data-processing.driver.allowEmptyPayloads, which,
if set to true, allows the compiler to publish payloads that have 0 bytes. Previously, all DPL
compilers rejected publishing empty blobs, which remains the default behavior.

2.39.0.5

Location Library

FIXED

Fix GeoCoordinates.pointForFraction, wrongly returning false when two
identical points whose type does not implement proper equality are passed.

2.39.0.5

Tutorials

ADDED

Added a tutorial that demonstrates how to develop and debug Spark applications.

2.39.0.5

Tutorials

ADDED

Added a tutorial that demonstrates how to run Spark applications on the platform.
The tutorial shows how to monitor the application using Grafana, Splunk, Spark UI, and Platform Billing Page.

2.38.0.9

Data Client Library

ADDED

Added support for reading & writing Json, Csv and Text data from versioned layer
using the
Spark Connector.

2.38.0.9

Data Client Library

DEPRECATED

2.38.0.9

Data Client Library

REMOVED

The following methods are removed.

- com.here.platform.data.client.model.Layer#createJava
- com.here.platform.data.client.model.Replication#createJava

2.38.0.9

Data Processing Library

FIXED

Fixed parsing of AllowListFilters, so that the partitions parameter can be left out like
catalogsAndLayers instead of forcing the user to specify an empty array. This introduces a small
backward incompatibility if an AllowListFilterParam object is explicitly built, because both
catalogsAndLayers and partitions are now optional:

Before:

val catalogsAndLayers = Map("hmc" -> Seq("topology-geometry"))
val partitions = Set("23618358", "23618359")
val param = AllowListFilterParam(Some(catalogsAndLayers), partitions)

After:

val catalogsAndLayers = Map("hmc" -> Seq("topology-geometry"))
val partitions = Set("23618358", "23618359")
val param = AllowListFilterParam(Some(catalogsAndLayers), Some(partitions))

2.38.0.9

Location Library

ADDED

Introduced new experimental module location-integration-optimized-map-dcl2
which allows multi-version caching. It brings a new experimental class
OptimizedMapCatalog which can be used to construct some of the high level
factories:

- ProximitySearches
- Graphs
- PathMatchers
- Subset of PropertyMaps
- hereMapContentReferenceToVertex
- vertexToHereMapContentReference
- geometry
- length
- turnRestrictions
- roadAccess
- freeFlowSpeed

2.38.0.9

Tutorials

ADDED

Added a tutorial that demonstrates how to run Flink applications on the platform.
The tutorial shows how to monitor the application using Grafana, Splunk, Flink UI, and Platform Billing Page.

2.38.0.9

Tutorials

ADDED

Added a tutorial that demonstrates how to develop and debug Flink applications.

2.37.0.5

Data Client Library

ADDED

Added support for reading & writing Json, Csv and Text data from volatile layer
using the
Spark Connector.

2.37.0.5

Data Client Library

ADDED

Added the configuration property query-by-parts to control the behaviour of
QueryApi.queryIndex and QueryApi.queryIndexAsIterator methods (See chapter
on
Configuration).

2.37.0.5

Data Client Library

REMOVED

Removed the following deprecated methods from the FlinkQueryApi:

For Scala

- com.here.platform.data.client.flink.scaladsl.queryIndexAsIterator(layer: String, queryString: String): Iterator[IndexPartition]

- com.here.platform.data.client.flink.scaladsl.queryIndexAsStream(layer: String, queryString: String, parts: Option[Int] = None)(implicit env: StreamExecutionEnvironment): DataStream[IndexPartition]

- com.here.platform.data.client.flink.scaladsl.queryIndex(layer: String, queryString: String): SourceFunction[IndexPartition]

For Java

- com.here.platform.data.client.flink.javadsl.queryIndexAsIterator(layer: String, queryString: String): JIterator[IndexPartition]

- com.here.platform.data.client.flink.javadsl.queryIndexAsStream(env: StreamExecutionEnvironment, layer: String, queryString: String): DataStream[IndexPartition]

- com.here.platform.data.client.flink.javadsl.queryIndexAsStream(env: StreamExecutionEnvironment, layer: String, queryString: String, parts: Int): DataStream[IndexPartition]

- com.here.platform.data.client.flink.javadsl.queryIndex(layer: String, queryString: String): SourceFunction[IndexPartition]

2.37.0.5

Data Client Library

ADDED

Added the function queryIndexParts to FlinkQueryApi.

2.37.0.5

Location Library

FIXED

Fixed non-deterministic behaviour of LocationReferenceCreators.tmc resolver: in
case of several matching tmc codes for linear location exist, the shortest one
is given priority.

2.36.0.3

Data Client Library

REMOVED

Removed the deprecated parameter olp.connector.flink.v2.

2.36.0.3

Data Client Library

DEPRECATED

Be advised that the following methods are marked deprecated now. These
deprecated methods will be removed after 6 months from the release date,
therefore replacing the usage of deprecated methods with alternative methods is
necessary for its users.

For Scala

- Usage of
com.here.platform.data.client.engine.scaladsl.ReadEngine.getObjectDataAsBytes(layerId: String, key: String, range: ByteRange = AllBytes): Future[Array[Byte]]
should be replaced by
com.here.platform.data.client.engine.scaladsl.ReadEngine.getObjectDataAsBytes2(layerId: String, key: String, applyDecompression: Boolean, range: ByteRange = AllBytes): Future[Array[Byte]]

- Usage of
com.here.platform.data.client.engine.scaladsl.ReadEngine.getObjectDataAsSource(layerId: String, key: String, range: ByteRange = AllBytes): Future[Source[ByteString, NotUsed]]
should be replaced by
com.here.platform.data.client.engine.scaladsl.ReadEngine.getObjectDataAsSource2(layerId: String, key: String, applyDecompression: Boolean, range: ByteRange = AllBytes): Future[Source[ByteString, NotUsed]]

- Usage of
com.here.platform.data.client.engine.scaladsl.WriteEngine.uploadObject(layerId: String, key: String, blob: Blob, contentType: Option[ContentType] = None, contentEncoding: Option[HttpEncoding] = None): Future[Done]
should be replaced by
com.here.platform.data.client.engine.scaladsl.WriteEngine.uploadObject2(layerId: String, key: String, blob: Blob, contentType: Option[String] = None, contentEncoding: Option[ContentEncoding] = None): Future[Done]

- Usage of
com.here.platform.data.client.engine.scaladsl.WriteEngine.startUploadObject(layerId: String, key: String, contentType: Option[ContentType] = None, contentEncoding: Option[HttpEncoding] = None): Future[ObjectMultipartToken]
should be replaced by
com.here.platform.data.client.engine.scaladsl.WriteEngine.startUploadObject2(layerId: String, key: String, contentType: Option[String] = None, contentEncoding: Option[ContentEncoding] = None): Future[ObjectMultipartToken]

- Usage of
com.here.platform.data.client.engine.scaladsl.WriteEngine.simpleUploadObject(layerId: String, key: String, data: ByteString, contentType: Option[ContentType] = None, contentEncoding: Option[HttpEncoding] = None): Future[Done]
should be replaced by
com.here.platform.data.client.engine.scaladsl.WriteEngine.simpleUploadObject2(layerId: String, key: String, data: ByteString, contentType: Option[String] = None, contentEncoding: Option[ContentEncoding] = None): Future[Done]

- Usage of
com.here.platform.data.client.flink.scaladsl.FlinkWriteEngine.uploadObject(layerId: String, key: String, blob: Blob, contentType: Option[ContentType] = None, contentEncoding: Option[HttpEncoding] = None): Unit
should be replaced by
com.here.platform.data.client.flink.scaladsl.FlinkWriteEngine.uploadObject2(layerId: String, key: String, blob: Blob, contentType: Option[String] = None, contentEncoding: Option[ContentEncoding] = None): Unit

- Usage of
com.here.platform.data.client.flink.scaladsl.FlinkReadEngine.getObjectDataAsBytes(layerId: String, key: String, range: ByteRange = AllBytes): Array[Byte]
should be replaced by
com.here.platform.data.client.flink.scaladsl.FlinkReadEngine.getObjectDataAsBytes2(layerId: String, key: String, applyDecompression: Boolean, range: ByteRange = AllBytes): Array[Byte]

For Java

- Usage of
com.here.platform.data.client.engine.javadsl.ReadEngine.getObjectDataAsSource(layerId: String, key: String, range: ByteRange = AllBytes): Future[Array[Byte]]
should be replaced by
com.here.platform.data.client.engine.javadsl.ReadEngine.getObjectDataAsBytes2(layerId: String, key: String, applyDecompression: Boolean, range: ByteRange = AllBytes): Future[Array[Byte]]

- Usage of
com.here.platform.data.client.engine.javadsl.ReadEngine.getObjectDataAsSource(layerId: String, key: String, range: ByteRange = AllBytes): Future[Source[ByteString, NotUsed]]
should be replaced by
com.here.platform.data.client.engine.javadsl.ReadEngine.getObjectDataAsSource2(layerId: String, key: String, applyDecompression: Boolean, range: ByteRange = AllBytes): Future[Source[ByteString, NotUsed]]

- Usage of
com.here.platform.data.client.engine.javadsl.WriteEngine.uploadObject(layerId: String, key: String, blob: Blob, contentType: Option[ContentType] = None, contentEncoding: Option[HttpEncoding] = None): Future[Done]
should be replaced by
com.here.platform.data.client.engine.javadsl.WriteEngine.uploadObject2(layerId: String, key: String, blob: Blob, contentType: Option[String] = None, contentEncoding: Option[ContentEncoding] = None): Future[Done]

- Usage of
com.here.platform.data.client.engine.javadsl.WriteEngine.startUploadObject(layerId: String, key: String, contentType: Option[ContentType] = None, contentEncoding: Option[HttpEncoding] = None): Future[ObjectMultipartToken]
should be replaced by
com.here.platform.data.client.engine.javadsl.WriteEngine.startUploadObject2(layerId: String, key: String, contentType: Option[String] = None, contentEncoding: Option[ContentEncoding] = None): Future[ObjectMultipartToken]

- Usage of
com.here.platform.data.client.engine.javadsl.WriteEngine.simpleUploadObject(layerId: String, key: String, data: ByteString, contentType: Option[ContentType] = None, contentEncoding: Option[HttpEncoding] = None): Future[Done]
should be replaced by
com.here.platform.data.client.engine.javadsl.WriteEngine.simpleUploadObject2(layerId: String, key: String, data: ByteString, contentType: Option[String] = None, contentEncoding: Option[ContentEncoding] = None): Future[Done]

- Usage of
com.here.platform.data.client.flink.javadsl.FlinkWriteEngine.uploadObject(layerId: String, key: String, blob: Blob, contentType: Option[ContentType] = None, contentEncoding: Option[HttpEncoding] = None): Unit
should be replaced by
com.here.platform.data.client.flink.javadsl.FlinkWriteEngine.uploadObject2(layerId: String, key: String, blob: Blob, contentType: Option[String] = None, contentEncoding: Option[ContentEncoding] = None): Unit

- Usage of
com.here.platform.data.client.flink.javadsl.FlinkReadEngine.getObjectDataAsBytes(layerId: String, key: String, range: ByteRange = AllBytes): Array[Byte]
should be replaced by
com.here.platform.data.client.flink.javadsl.FlinkReadEngine.getObjectDataAsBytes2(layerId: String, key: String, applyDecompression: Boolean, range: ByteRange = AllBytes): Array[Byte]

2.36.0.3

Data Client Library

REMOVED

Removed the following deprecated methods from the QueryApi:

For Scala

- com.here.platform.data.client.scaladsl.queryIndexAsIterator(layer: String, queryString: String, isHugeQuery: Boolean = false): Future[Iterator[IndexPartition]]

- com.here.platform.data.client.scaladsl.queryIndexAsIterator(layer: String, queryString: String, partId: Option[String]): Future[Iterator[IndexPartition]]

- com.here.platform.data.client.scaladsl.queryIndexAsIterator(layer: String, queryString: Option[String]): Future[Iterator[IndexPartition]]

- com.here.platform.data.client.scaladsl.queryIndex(layer: String, queryString: String, isHugeQuery: Boolean = false): Future[Source[IndexPartition, NotUsed]]

- com.here.platform.data.client.scaladsl.queryIndex(layer: String, queryString: String, partId: Option[String]): Future[Source[IndexPartition, NotUsed]]

- com.here.platform.data.client.scaladsl.queryIndex(layer: String, queryString: Option[String]): Future[Source[IndexPartition, NotUsed]]

For Java

- com.here.platform.data.client.javadsl.queryIndexAsIterator(layer: String, queryString: String): CompletionStage[JIterator[IndexPartition]]

- com.here.platform.data.client.javadsl.queryIndexAsIterator(layer: String, queryString: String, isHugeQuery: Boolean): CompletionStage[JIterator[IndexPartition]]

- com.here.platform.data.client.javadsl.queryIndexAsIterator(layer: String, queryString: String, partId: String): CompletionStage[JIterator[IndexPartition]]

- com.here.platform.data.client.javadsl.queryIndex(layer: String, queryString: String): CompletionStage[JSource[IndexPartition, NotUsed]]

- com.here.platform.data.client.javadsl.queryIndex(layer: String, queryString: String, isHugeQuery: Boolean): CompletionStage[JSource[IndexPartition, NotUsed]]

- com.here.platform.data.client.javadsl.queryIndex(layer: String, queryString: String, partId: String): CompletionStage[JSource[IndexPartition, NotUsed]]

2.36.0.3

Location Library

ADDED

Added GeoCoordinateOperations to Point feature and LineStringOperations to
LineString feature.

2.36.0.3

Stream dependencies

FIXED

Fixed misalignment between Batch Environment 3.0.0 and corresponding SDK Dependency file,
both use 3.1.5 version of the io.dropwizard.metrics:metrics-core library.

2.36.0.3

Stream dependencies

FIXED

Fixed misalignment between com.fasterxml.jackson.core:jackson-databind library in the sdk-dep-standalone file and environment-stream-5.0.0 file
both use 2.12.1 version of the com.fasterxml.jackson.core:jackson-databind library. Fixed critical vulnerability.

2.36.0.3

Stream dependencies

REMOVED

Removed the org.json4s:json4s-jackson:3.5.3 library from the sdk-dep-common bom file
to fix dependencies conflicts with com.fasterxml.jackson.core:jackson-databind library.

2.36.0.3

Standalone dependencies

FIXED

Fixed misalignment between Batch Environment 3.0.0 and corresponding SDK Dependency file,
both use 3.1.5 version of the io.dropwizard.metrics:metrics-core library.

2.36.0.3

Standalone dependencies

FIXED

Fixed misalignment between com.fasterxml.jackson.core:jackson-databind library in the sdk-dep-standalone file and sdk-dep-stream file
both use 2.12.1 version of the com.fasterxml.jackson.core:jackson-databind library. Fixed critical vulnerability.

2.36.0.3

Standalone dependencies

REMOVED

Removed the org.json4s:json4s-jackson:3.5.3 library from the sdk-dep-common bom file
to fix dependencies conflicts with com.fasterxml.jackson.core:jackson-databind library.

2.36.0.3

Batch dependencies

FIXED

Fixed misalignment between Batch Environment 3.0.0 and corresponding SDK Dependency file,
both use 3.1.5 version of the io.dropwizard.metrics:metrics-core library.

2.36.0.3

Batch dependencies

FIXED

Fixed misalignment between com.fasterxml.jackson.core:jackson-databind library in the sdk-dep-batch file and environment-batch-3.0.0
both use 2.6.7.3 version of the com.fasterxml.jackson.core:jackson-databind library.

2.36.0.3

Batch dependencies

REMOVED

Removed the org.json4s:json4s-jackson:3.5.3 library from the sdk-dep-common bom file
to fix dependencies conflicts with com.fasterxml.jackson.core:jackson-databind library.

2.35.0.2

Archetypes

CHANGED

Schema Archetype now includes HERE Data SDK for Java and Scala Bill of Material file. The versions for the schemas included in the SDK can be resolved automatically

2.35.0.2

Archetypes

CHANGED

Changed the streaming archetype to use the new stream 5.0 environment.
Archetype version 1.0.784 is the last released version with the stream 4.0 support.

2.35.0.2

Archetypes

REMOVED

Scala 2.11 bindings support has been removed from Schema Archetype.
Archetype version 2.1.12 is the last released version with the support of Scala 2.11.

2.35.0.2

Data Archiving Library

REMOVED

The Data Archiving Library has removed the artifact com.here.platform.dal.data-archive_2.11 for Scala 2.11, and it is no longer supported.

2.35.0.2

Data Archiving Library

REMOVED

The Data Archiving Library removed the deprecated merge API and corresponding support. You should use the Index Compaction Library if you want to compact the index layer.

2.35.0.2

Data Client Base Library

REMOVED

Entity retry-policy and method parseConfigs in ApiConfigurationProfile
removed. Use parseConfig method instead and request entity in config file.

2.35.0.2

Data Client Base Library

REMOVED

Method withQueryParam(@unused name: String, values: MapValues) removed due to
deprecation period. Please use withQueryParam(params: Map[String, String])
method instead.

2.35.0.2

Data Client Library

CHANGED

Flink version updated to 1.13.3. Please feel free to benefit from our migration
experience and see:
https://developer.here.com/documentation/data-client-library/dev_guide/client/flink-connector-migration-guide.html

2.35.0.2

Data Client Library

REMOVED

Removed the deprecated parameter olp.connector.volatile.reader.v2.

2.35.0.2

Index Compaction Library

REMOVED

The Index Compaction Library has removed the artifact com.here.platform.index.compaction.index-compaction-batch_2.11 for Scala 2.11, and it is no longer supported.

2.35.0.2

Tutorials

ADDED

Added a tutorial that demonstrates how to subscribe to the notifications for catalog and layer-level changes.

2.35.0.2

Tutorials

ADDED

Added tutorial that demonstrates how to retrieve real-time traffic data using the HERE Real Time Traffic catalog.

2.35.0.2

Tutorials

CHANGED

Upgraded "Run a Stream Application with Pipeline API" tutorial to use stream-5.0.

2.35.0.2

Examples

REMOVED

The Data Archiving Library Examples removed the deprecated merge API and corresponding support. You should use the Index Compaction Library if you want to compact the index layer.

2.35.0.2

Examples

CHANGED

Changed the Data Archive and Location examples to use the new stream-5.0 environment.

2.35.0.2

Dependencies

REMOVED

Scala 2.11 support is removed.

The former SDK-BOM files are removed:

- sdk-batch-bom.pom
- sdk-stream-bom.pom
- sdk-standalone-bom.pom

Migration instructions can be found in the guide.

2.35.0.2

Stream dependencies

CHANGED

Changed the supported pipeline environment from stream-4.0 to stream-5.0 for Scala 2.12.

2.34.0.4

Data Client Base Library

ADDED

Added configurable flag 'auto-shutdown' in 'reference.conf' for HTTP client.

2.34.0.4

Data Client Base Library

UPDATED

Following api was updated: Config Api 1.1.7 to 1.1.10

2.34.0.4

Location Library

ADDED

Added boundingBoxOf method to the HereTileResolver, which returns a bounding
box for the specified Tile ID.

2.34.0.4

Location Library

CHANGED

Improved the map matching quality, avoiding unnecessary detours in some rare
cases.

2.34.0.4

Location Library

FIXED

Fixed ExponentialProbabilityDistribution for negative inputs. We now correctly
return LogProbability(NegativeInfinity) for negative inputs.

2.34.0.4

Tutorials

ADDED

Added tutorial that demonstrates how to use HereTileResolver class from Location Library to calculate TileIDs for certain area queries.

2.34.0.4

Tutorials

ADDED

Added tutorial that demonstrates how to retrieve live weather data using the HERE Live Weather catalogs.

2.33.0.3

Data Processing Library

FIXED

When a batch pipeline is upgraded to the Scala 2.12 variant of the Data Processing Library, if
incremental compilation is applicable and the output catalog is not empty and contains a state
published by the same Data Processing Library version, but the Scala 2.11 variant, reading the state
fails because the serialized classes are not binary compatible. This was fixed by including the
Scala binary version in the fingerprints. Switching between 2.11 and 2.12 between compilations will
now correctly fallback to full compilation.

2.32.0.9

Archetypes

ADDED

Added backwards compatibility check on nested messages of .proto files.

2.32.0.9

Data Client Base Library

REMOVED

Removed the following deprecated code BaseClient.Builder().

2.32.0.9

Data Client Library

ADDED

Integrating interactive map layers with Flink pipelines using Flink connector is
now supported via the Data Client Library.

Flink connector implements the standard Flink interfaces that allow you to
create source Tables for reading, and sink Tables for writing to interactive
map layers. Hence, you can use both relational APIs that Flink supports:
Table API and SQL API. In addition, you can convert a Table to a
DataStream and use the Flink DataStream API.

For more information and examples, see
Read and Write interactive map layer lata

2.32.0.9

Examples

FIXED

Fixed an issue with versions incompatibility between scala-maven-plugin 4.1.1 and Maven 3.8.*.
The version of scala-maven-plugin was upgraded to 4.5.4.

2.31.0

Data Client Base Library

REMOVED

Inheritance from API trait is no longer available. If you create your own API
with inheritance from trait API - creation new instance using BaseClient.of[]
is no longer available. Remove inheritance from API and use new instead.

2.31.0

Data Client Base Library

FIXED

Project scope is not mandatory but optional again.

2.31.0

Data Client Base Library

REMOVED

Removed ExecutionContext as implicit argument from execute... methods from
ApiRequest. Now BaseClient will use ExecutionContext, provided during client
instance creation. You still can provide separate execution context for
BodyDeserializer.

For example, to explicit providing different execution contexts:

val generalExecutionContext = ???
val serializingExecutionContext = ???
val deserializingExecutionContext = ???

val client = BaseClient()(generalExecutionContext)
val metadataApi = client.of[MetadataApi]
val request = metadataApi.getChanges(catalogHrn, None, layerId)

val dependencySerializer: BodySerializer[Dependencies] = {
  implicit val exec: ExecutionContext = serializingExecutionContext
  jsonBodySerializer
}
val versionResponseDeserializer: BodyDeserializer[VersionsResponse] = {
  implicit val exec: ExecutionContext = deserializingExecutionContext
  jsonBodyDeserializer
}

// BEFORE:
metadataApi
  .compatibleVersions(catalogHrn, Dependencies())(dependencySerializer)
  .executeToEntity()(generalExecutionContext, versionResponseDeserializer)

// NOW:
// no need to provide general ExecutionContext, as it was already provided during client instance creation
metadataApi
  .compatibleVersions(catalogHrn, Dependencies())(dependencySerializer)
  .executeToEntity()(versionResponseDeserializer)

If you use same ExecutionContext for general purposes and for
serialization/deserialization - changes will not affect you, but anyway keep in
mind that method signature will be changed:

implicit val executionContext: ExecutionContext = ???

val client = BaseClient()
val metadataApi = client.of[MetadataApi]
val request = metadataApi.getChanges(catalogHrn, None, layerId)

// BEFORE:
metadataApi
  .compatibleVersions(catalogHrn, Dependencies())
  .executeToEntity()

// AFTER:
metadataApi
  .compatibleVersions(catalogHrn, Dependencies())
  .executeToEntity()

2.31.0

Data Client Base Library

REMOVED

Removed the following deprecated configuration entity
credentials.legacy-evaluation-order.

2.31.0

Data Client Library

REMOVED

Removed the following deprecated methods from the FlinkQueryApi:

For Scala

- com.here.platform.data.client.flink.scaladsl.FlinkQueryApi.queryIndexAsIterator(layer: String, queryString: String, isHugeQuery: Boolean): Iterator[IndexPartition]

- com.here.platform.data.client.flink.scaladsl.FlinkQueryApi.queryIndex(layer: String, queryString: String, isHugeQuery: Boolean): SourceFunction[IndexPartition]

For Java

- com.here.platform.data.client.flink.javadsl.FlinkQueryApi.queryIndexAsIterator(layer: String, queryString: String, isHugeQuery: Boolean): JIterator[IndexPartition]

- com.here.platform.data.client.flink.javadsl.FlinkQueryApi.queryIndex(layer: String, queryString: String, isHugeQuery: Boolean): SourceFunction[IndexPartition]

2.31.0

Data Client Library

REMOVED

Removed the following deprecated parameter olp.connector.payload-decoding

2.31.0

Data Client Library

ADDED

This release of the Spark Connector fully supports all operations for
interactiv map layers (IML): Read, write (created and update) as well as
deletion of data. Spark Connectors provide a tool to help facilitate your data
analysis, consumption and processing via Spark. OLP data connectors integrate
OLP proprietary catalogs and layers with the industry standard formats of Flink
(TableSource) and Spark (DataFrame). Whereas before you needed to implement this
functionality yourself, now you can use these connectors to leverage the full
functionality of searching, filtering, mapping, sorting and more offered by
standard Apache Flink and Spark frameworks. Spend less time writing low level
pipeline/data integration code and more time on your use case specific business
logic.

##### Supported Operations

- Read
- Write (create and update)
- Delete

##### Supported Data Formats

- IML format (based on GeoJSON)

For more information and examples, see

- Read Volatile Layer Data
- Write Volatile Layer Data
- Delete Volatile Layer Data

2.31.0

Data Client Library

REMOVED

Removed the following deprecated classes from the flink-support module:

For Scala

- com.here.platform.data.client.flink.scaladsl.OlpStreamTableSourceFactory

- com.here.platform.data.client.flink.scaladsl.OlpStreamTableSinkFactory

For Java

- com.here.platform.data.client.flink.javadsl.OlpStreamTableSourceFactory

- com.here.platform.data.client.flink.javadsl.OlpStreamTableSinkFactory

2.31.0

Data Client Library

REMOVED

Removed the following deprecated configuration entity
credentials.legacy-evaluation-order.

2.31.0

Data Client Library

REMOVED

Removed the following deprecated configuration entity
use-muti-part-upload-from.

2.31.0

Data Client Library

REMOVED

Removed the deprecated Java method CatalogConfiguration.createJava.

2.31.0

Data Client Library

DEPRECATED

The following methods are deprecated and should be replace by according
builder() methods.

- com.here.platform.data.client.model.Layer#createJava should be replaced by
com.here.platform.data.client.model.Layer#builder.
- com.here.platform.data.client.model.Replication#createJava should be
replaced by com.here.platform.data.client.model.Replication#builder.

2.30.0

Data Client Base Library

DEPRECATED

The com.here.platform.data.client.base.http.IOExecutionContext is deprecated
and will be removed.

2.30.0

Data Client Base Library

ADDED

With this change we give the user the option to define his own execution
contexts. There can be defined two such contexts, one is used for execution of
tasks and futures of data client base library, whereas the other is passed to
the underlying OkHttp stack. The contexts are passed to the BaseClient instance:

@param exec the Scala execution context which should be used for execution of
internal Futures of Data Client Base library; default is Scala's
ExecutionContext.global

@param ioExecutorService the Java executor service which is used by underlying
OkHttp stack; default is an internal thread pool which is created by OkHttp's
Dispatcher()

##### Note:

- The com.here.platform.data.client.base.http.IOExecutionContext is deprecated
and will be removed.

- Please note that this change is backward-incompatible if you directly use
BodySerializer. This is because in the BodySerializer there cannot have
multiple functions with same signatur that differ only by implicit parameter
type.

Usage example in Scala:

object WorkingWithBaseClientContexts {

  implicit val myCustomExecutionContext = ExecutionContext.global
  implicit val myIOExecutorService: ExecutorService =
    ExecutionContext.fromExecutorService(ForkJoinPool.commonPool())

  def main(args: Array[String]): Unit = {

    val client = BaseClient() // this takes the implicit contexts
    val configApi = client.of[ConfigApi]

    val result: CatalogsResultBase = configApi
      .getCatalogs(verbose = Some(false))
      .toEntity()

    println(s"response: $result")
  }
}

Usage example in Java:

public class JavaWorkingWithBaseClientContexts {

  private static ExecutorService myCustomExecutor = Executors.newFixedThreadPool(4);
  private static ExecutorService myCustomIoExecutor = Executors.newFixedThreadPool(10);

  public static void main(String[] args) {
    BaseClient baseClient = new BaseClientJava.Builder()
      .withExecutorService(myCustomExecutor)
      .withIoExecutorService(myCustomIoExecutor)
      .build();
    ConfigApi configApi = new ConfigApi(baseClient);

    CatalogsListResult listResult =
        (CatalogsListResult)
            configApi.getCatalogs().withVerbose(Optional.of(true)).build().toEntity();

    System.out.println(listResult);
  }
}

2.30.0

Data Client Library

ADDED

The data client has introduced a new methods that supports additional metadata
calls to work with interactive map layers.

The methods have been added to QueryApi.

Usage:


    val layer = "test-im-layer"
    val bbox = BoundingBox(22.689013, 56.218811, 23.648524, 57.284241)
    val tileId = "023232121"
    val tileType = TileType.QUADKEY

    /*
    returns hexbins for a bounding box. Please note that this function will
    return the hexbins for the smallest quadkey that contains the bounding box.
    This means you might get more hexbins than anticipated.
     */
    val hexBins = queryApi.getHexBinsByBbox(layer, bbox, Set.empty, Some(1), None, None, None, None, None)

    /*
    returns quadbins for a quadkey. This time the output is exactly what you requested.
     */
    val quadBins =
      queryApi.getQuadBinsByTileId(layer, tileId, tileType, Set.empty, Some(1), None, None)

2.30.0

Data Client Library

DEPRECATED

2.30.0

Data Client Library

ADDED

Added option to check/ignore invalid partitions in Spark connector via the
options:

- olp.connector.check-invalid-partitions(default=false)
- olp.connector.ignore-invalid-partitions(default=false)

When the check is enabled, the checksum of the partition will be verified. And,
if olp.connector.ignore-invalid-partitions is set to true the connector will
log a warning message. Otherwise, it will throw an exception.

When the layer digest attribute is undefined and the partition checksum is not,
this option:

- olp.connector.default-checksum(default="MD5") can be used to specify which
algorithm to use in this case. By default Spark connector uses "MD5" but the
values "SHA-1" and "SHA-256" can be also used.

2.30.0

Data Client Library

ADDED

Added option to set the overall timeout in milliseconds that is applied for
reading the partitions in Spark connector via the spark option
olp.connector.read-timeout. Default value is 60000 milliseconds.

2.29.0

Archetypes

CHANGED

Downgraded the maven-shade-plugin from 3.2.4 to 3.2.1 to align with the version used in SDK BOM files.

2.29.0

Data Client Base Library

ADDED

Added scope support at CredentialsModels, which allows defining scope for
project.

2.29.0

Data Client Library

ADDED

Added olp.connector.metadata-columns parameter for flink connector. This
parameter (by default it is false) should be set to true in order to add
metadata to flink connector schema. Works only for new version of connector (see
the olp.connector.flink.v2 option)

2.29.0

Data Client Library

ADDED

Added olp.connector.flink.v2 parameter for flink connector. This parameter (by
default it is false) should be set to true in order to use new version of
flink connector, which differs from the old version in terms of metadata
columns. New connector will not provide/require metadata by default (this
behaviour could be changed by using olp.connector.metadata-columns option).
Also it will have another order of some metadata columns. The old version of
connector is deprecated. After the deprecation period the new version of the
connector will be used by default.

2.29.0

Data Client Library

DEPRECATED

olp.connector.flink.v2 parameter for flink connector is deprecated. This
parameter should be set to true in order to use new version of flink connector.
After deprecation period new version will be used by default and this parameter
will be removed.

2.29.0

Data Client Library

ADDED

Added support for custom (foreign) members in the Feature GeoJSON object.

2.29.0

Data Client Library

DEPRECATED

2.29.0

Examples

CHANGED

Downgraded the maven-shade-plugin from 3.2.4 to 3.2.1 to align with the version used in SDK BOM files.

2.28.0

Archetypes

CHANGED

Changed the archetypes to use SDK BOM with Scala 2.12 dependencies.

The latest version of archetypes generates Scala 2.12 compatible projects.
If you want to use Scala 2.11, please use the following versions of archetypes:

* batch-direct1ton-java - 1.0.727
* batch-direct1ton-scala - 1.0.727
* batch-directmton-java - 1.0.727
* batch-directmton-scala - 1.0.727
* batch-mapgroup-java - 1.0.727
* batch-mapgroup-scala - 1.0.727
* batch-reftree-java - 1.0.727
* streaming-java - 1.0.727
* streaming-scala - 1.0.727

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.28.0

Archetypes

FIXED

Fixed an issue where users with the 32-bit JDK experienced Protobuf compilation errors.

2.28.0

Archetypes

CHANGED

Added better error handling to protoc-scala-maven-plugin and protoc-scala-maven-plugin_2.12 plugins
for the cases when plugin configuration is invalid.

2.28.0

Data Archiving Library

CHANGED

The Data Archive Library has changed the artifact name from com.here.platform.data.archive.data-archive to com.here.platform.data.archive.data-archive_2.11 and com.here.platform.data.archive.data-archive_2.12 for Scala 2.11 and Scala 2.12 respectively.

2.28.0

Data Client Library

FIXED

Fixed uploading an empty blob to durable volume.

2.28.0

Data Client Library

DEPRECATED

Method isLayerType in LayerType class is deprecated.

2.28.0

Data Client Library

ADDED

Added olp.connector.volatile.reader.v2 parameter for spark volatile reader.
This parameter (by default it is false) should be set to true in order to use
new version of spark volatile reader, which differs from the old version in
terms of metadata columns. New reader will not provide mt_dataHandle and
mt_metadata for volatile layer. The old version of reader is deprecated. After
the deprecation period the new version of the reader will be used by default.

2.28.0

Data Client Library

DEPRECATED

olp.connector.volatile.reader.v2 parameter for spark volatile reader is
deprecated. This parameter should be set to true in order to use new version of
spark volatile reader. After deprecation period new version will be used by
default and this parameter will be removed.

2.28.0

Data Client Library

FIXED

Fixed GeoJSON models with validations.

2.28.0

Data Processing Library

FIXED

Under certain circumstances, user-provided partitioners were applied to DPL-internal state
partition keys, which could lead to unexpected exceptions if the partitioner would throw
on some keys.

2.28.0

Index Compaction Library

CHANGED

The Index Compaction Library has changed the artifact name from com.here.platform.index.compaction.index-compaction-batch to com.here.platform.index.compaction.index-compaction-batch_2.11 and com.here.platform.index.compaction.index-compaction-batch_2.12 for Scala 2.11 and Scala 2.12 respectively.

2.28.0

Examples

CHANGED

Changed the examples using SDK BOM files with Scala 2.12.

To use the SDK BOM files with Scala 2.11, do the following:

* Use the Scala 2.11 BOM files:

* sdk-batch-bom instead of sdk-batch-bom_2.12
* sdk-stream-bom instead of sdk-stream-bom_2.12
* sdk-standalone-bom instead of sdk-standalone-bom_2.12

* Change scala.compat.version property to 2.11.

* Make sure you update Scala dependencies of examples to Scala 2.11 (for example pipeline-runner-java_2.12 -> pipeline-runner-java_2.11)
* Different pipeline environments should be used to run the examples, stream-3.0.0 instead of stream-4.0 and batch-2.1.0 instead of batch-3.0.0

2.28.0

Dependencies

ADDED

Scala 2.12 is now supported by Data SDK for Java & Scala. Scala 2.12 SDK-BOM files contain _2.12 suffixes:

- sdk-batch-bom_2.12.pom
- sdk-stream-bom_2.12.pom
- sdk-standalone-bom_2.12.pom

The former SDK-BOM files support only Scala 2.11 and they don’t have any suffix for backward compatibility:

- sdk-batch-bom.pom
- sdk-stream-bom.pom
- sdk-standalone-bom.pom

Migration instructions can be found in the guide.

2.28.0

Dependencies

DEPRECATED

Scala 2.11 support will be discontinued in 6 months.

The former SDK-BOM files are deprecated:

- sdk-batch-bom.pom
- sdk-stream-bom.pom
- sdk-standalone-bom.pom

Migration instructions can be found in the guide.

2.28.0

Environment

ADDED

Two new environments for Scala 2.12 have been added:

- stream-4.0 for stream environment with Flink 1.10.3
- batch-3.0 for batch environment with Spark 2.4.7

The former environments support only Scala 2.11 and they have the versions:

- stream-3.0.0 for stream environment with Flink 1.10.1
- batch-2.1.0 for batch environment with Spark 2.4.2

Migration instructions can be found in the guide.

2.28.0

Environment

DEPRECATED

Scala 2.11 support will be discontinued in 6 months.

The former environments are deprecated:

- stream-3.0.0 for stream environment with Flink 1.10.1
- batch-2.1.0 for batch environment with Spark 2.4.2

Migration instructions can be found in the guide.

2.27.0

Data Client Base Library

ADDED

Added blocking methods for API requests. Now you are able to use:

val client = BaseClient()
val configApi = client.of[ConfigApi]

val result: CatalogsResultBase =
  configApi.getCatalogs(verbose = Some(false)).toEntity()

println(s"response: $result")

New configuration parameter blocking-timeout is introduced to setup blocking
timeout for each level. The default value is 5 minutes. You can change it
using configuration file or programmatically.

2.27.0

Data Client Base Library

DEPRECATED

retry-policy entity in configuration is deprecated. Please use new one
instead:

com.here.platform.data.client {
  request {
    defaults {
      retry-policy {
        ...
      }
    }
  }
}

2.27.0

Data Client Base Library

ADDED

Removed the need to use shutdown explicitly. Now you can omit shutdown line:

    val client = BaseClient()
    client.shutdown()

2.27.0

Data Client Library

ADDED

Added support for the objectstore layer in FlinkReadEngine and
FlinkWriteEngine. With the addition of this support users will be able to
upload and download data from the objectstore layer using flink-support
package.

2.27.0

Data Client Library

ADDED

Added a new configuration property publish.kafka-publish-parallelism which
determines with how many threads events are published to Kafka in parallel.
Please put this property in your application.conf file if you wanna use some
other value than default. The default value is 2048.

Event ordering is guaranteed only in case of 1, which has a huge performance
impact.

This property applies to direct kafka mode only.

2.27.0

Data Client Library

FIXED

Fixed inefficient FlinkQueryApiImpl implementation.

2.27.0

Data Client Library

CHANGED

The http user agent header of Data Client has been changed

- from DataClient/x.y.z (Java/a.b.c_d)
- to DataClient/x.y.z (Java/a.b.c_d) (Scala/r.s.t).
- where
- x.y.z is the version of the Data Client
- a.b.c_d is the version of the Java VM which is currently running it
- r.s.t is the version of the Scala compiler which built it

This means you can see now in the logs the Scala compiler version that was used
to build this Data Client library.

Example for new http user agent header:
DataClient/1.6.10 (Java/1.8.0_252) (Scala/2.11.12)

2.27.0

Data Client Library

ADDED

This release adds a new layer type: Interactive Map. This library enables
users to access Interactive Map layer through various operations. Data Client
supported operations are:

- Create interactive-map layer
- Read data
- Write data
- Delete data

This release also include Data Engine and Flink-Support for Interactive Map
Layer. The data engines support includes operations such as:

- Export layer data
- Upload large data

2.27.0

Location Library

ADDED

Added the following values to the SupplementalGeometry navigation attribute:

- Mountain Bike Trail
- Hiking Trail
- CrossCountry Ski Trail
- Golf Course Trail
- Ski Run
- Ski Lift
- Running Track
- Bmx Track
- Horse Trail
- Outdoor Activity Road
- Outdoor Activity Access

For instructions on how to access the navigation attributes, see the
com.here.platform.location.integration.optimizedmap.graph.PropertyMaps.NavigationAttributes
class and the related methods. Added the specific Java variant through the
com.here.platform.location.integration.optimizedmap.graph.javadsl.PropertyMaps.NavigationAttributes
class.

2.26.0

Archetypes

FIXED

Changed protoc-scala-maven-plugin_2.12 (HERE's Maven plugin) to support the backwards compatibility of the Scala
bindings API between Scala 2.11 and 2.12.

2.26.0

Archetypes

FIXED

Fixed API backwards compatibility issues between Scala 2.11 and 2.12 bindings generated by Schema Archetype.

2.26.0

Data Client Base Library

ADDED

Added streamingContent to HttpResponse, so that we can support getting
directly the byte stream from the OkHttp response, and hence support data
streaming in the DCBL APIs.

As an example, with BlobApi you will be able to use .executeToInputStream():

val client = BaseClient()
val blobApi = client.of[BlobApi]

val result: Future[InputStream] =
  blobApi.getBlob(someHrn, someLayer, someDataHandle).executeToInputStream()

2.26.0

Data Client Library

CHANGED

kafka-support is not part of data-client module anymore. The user needs to
add kafka-support module to the dependencies of his application if he would
like to use kafka-connector:
https://developer.here.com/documentation/data-client-library/dev_guide/client/direct-kafka.html

This change will not break your code. The logic inside checks the existence of
kafka-support module and in case of its absence will override connector type
to http-connector until kafka-support module will add to dependencies.

This doesn't touch flink users, because kafka-support module was included in
flink-support module. The spark-support module will no longer contain kafka
library.

2.26.0

Data Processing Library

ADDED

The DeltaContext now allows the construction of disjoint union of not only two, but two or more
DeltaSets.

2.26.0

Index Compaction Library

ADDED

Added a failure-rate-threshold value to the configuration of Index Compaction Library to calculate, log, and verify that compaction failure rate is below the maximum failure rate expected by the user.
Default threshold is 1.0, which means the compaction job fails only if compaction for all keyGroups fail.
Note that compaction is an optimization for cost and performance. Failure of compaction will not affect data consistency in Index Layer.

2.26.0

Schemas

FIXED

Protobuf partition decoding in the HERE platform portal was fixed in these latest SDII schema versions:
* SDII v3 Message Schema v4.2.5.
* SDII v3 MessageList Schema v4.2.5.
* SDII Archive Schema v2.2.6.

2.26.0

Schemas

FIXED

Protobuf partition decoding in the HERE platform portal was fixed in SENSORIS schema v1.1.3.

2.26.0

Schemas

FIXED

Scala 2.12 bindings API is now backwards compatible with the Scala 2.11 one in these latest SDII schema versions:
* SDII v3 Message Schema v4.2.6.
* SDII v3 MessageList Schema v4.2.6.
* SDII Archive Schema v2.2.7.

2.26.0

Schemas

FIXED

Scala 2.12 bindings API is now backwards compatible with the Scala 2.11 one in SENSORIS schema v1.1.4.

2.25.0

Data Client Base Library

ADDED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs: - interactive-map-v1-openapi.yml: 1.0.0

Data Client Base Library supports Interactive map layer operations.

For the details of this new API, please see the
Data Client Base Library API reference
or the
HERE platform REST Interactive API.

2.25.0

Data Client Base Library

ADDED

Updated Data Client Base Library to support following versions of HERE Platform
Data APIs: blob-v2: 2.0.1

ByKeyApi in Data Client Base Library supports Blob-v2 operations for
objectstore layer.

For the details of this new API, please see the
Data Client Base Library API reference
or the
HERE platform REST Blob API v2.

2.25.0

Data Client Library

ADDED

Added a new flag to the Settings named forceRawData. If settings are passed
to read or write engines then this new flag determines if the raw data handling
is enforced or not.

The default value is false. In this case the behavior is driven by existing
parameters like layer configuration.

If the flag is true then

- in case of read engine the data is read in raw format (bytes) and no gunzip is
applied regardless of layer configuration,
- in case of write engine the data is written in raw format (bytes) and no gzip
is applied regardless of layer configuration.

2.25.0

Location Library

CHANGED

Added methods you can use to check whether a PropertyMap contains a value for
a given key:

- Scala: PropertyMap.contains
- Java: PropertyMap.containsKey

This is a breaking change for you, if you had implemented your own
PropertyMap.

The methods should behave like the following example implementations:

Scala:

def contains(key: K): Boolean = try {
  apply(key)
  true
} catch {
  case _: NoSuchElementException => false
}

Java:

boolean containsKey(K key) {
  try {
    get(key);
    return true;
  } catch (NoSuchElementException ex) {
    return false;
  }
}

2.25.0

Location Library

CHANGED

Changed GeometryTile to support precomputed lengths from the Optimized Map for
Location Library to speed-up the decoding. The straightLineDistanceCalculator
was removed from the fields to be passed in construction. The distance
calculator is now passed to each TiledGeometryPropertyMap.

2.25.0

Location Library

CHANGED

IncidenceGraphs now contain methods to check whether a graph contains a given
vertex or edge:

- Scala: IncidenceGraph.containsVertex and IncidenceGraph.containsEdge
- Java: IncidenceGraph.containsVertex and IncidenceGraph.containsEdge

If you implemented your own IncidenceGraph this will be a breaking change for
your code that can be fixed implementing the two new methods as well.

2.25.0

Examples

REMOVED

Data Validation Library, Data Validation Schemas and Data Validation Examples have been removed from HERE Data Java/Scala SDK

2.25.0

Schemas

FIXED

SDII Scala 2.12 module dependency conflicts were fixed in the latest schema versions:
* SDII v3 Message Schema v4.2.4.
* SDII v3 MessageList Schema v4.2.4.
* SDII Archive Schema v2.2.4.

2.24.0

Archetypes

ADDED

Both the schema archetype and HERE Maven plugins have been updated to support generation of the new Scala 2.12 bindings.
This change is in preparation for Scala 2.12 on HERE Platform.

Schema owners are encouraged to update their schema projects to generate Scala 2.12 bindings.
In order to upgrade, follow the instructions in the
migration guide.

2.24.0

Data Client Base Library

DEPRECATED

Deprecate builder for scala BaseClient.

2.24.0

Data Client Base Library

FIXED

Data Client Base Library can use multiple BaseClient instances.

2.24.0

Data Client Library

ADDED

Added olp.connector.force-raw-data configuration parameter on
producer/consumer side in flink connector which allows disabling
encoding/decoding logic for avro, protobuf, parquet content types and use raw
data directly. By default, this parameter is set as false.

2.24.0

Data Client Library

FIXED

Fixed an issue where pipelines crash with sdii serialization exception.

2.24.0

Data Client Library

ADDED

2.24.0

Data Client Library

DEPRECATED

olp.connector.payload-decoding parameter for flink and spark connector is
deprecated. This parameter was applicable only for source/read side. The new
parameter olp.connector.force-raw-data (by default it is false) should be
set in true for forcing raw data usage (disabling transformation from/to
parquet, avro, protobuf) and is applicable for both source/read and sink/write
sides.

2.24.0

Index Compaction Library

BUG-FIX

The correct data size is now represented for layers with gzip content encoding during the compaction process in Index Compaction Library.
This fix restores correct functionality of the compaction process for index layers with gzip content encoding by addressing a bug where an error would be incorrectly thrown for suspected overflow due to negative data-size value.

2.24.0

Location Library

CHANGED

Improved the performance of the getAll method for the Apache Flink variant of
com.here.platform.location.dataloader.core.TileLoader/DataLoader when running
on a limited number of CPUs.

2.24.0

Location Library

OTHER

In the next release, the Location Library will add methods you can use to check
whether a PropertyMap contains a value for a given key:

- Scala: PropertyMap.contains
- Java: PropertyMap.containsKey

This would be a breaking change for you, if you had implemented your own
PropertyMap.

The methods should behave like the following example implementations:

Scala:

def contains(key: K): Boolean = try {
  apply(key)
  true
} catch {
  case _: NoSuchElementException => false
}

Java:

boolean containsKey(K key) {
  try {
    get(key);
    return true;
  } catch (NoSuchElementException ex) {
    return false;
  }
}

2.24.0

Schemas

ADDED

The latest SDII schemas now include the new Scala 2.12 bindings.
They can be used in your project using the following artifact ids:
* SDII v3 Message Schema v4.2.0 sdii_message_v3_scala_2.12
* SDII v3 MessageList Schema v4.2.0: sdii_message_list_v3_scala_2.12
* SDII Archive Schema v2.2.0: sdii_archive_v1_scala_2.12

2.24.0

Schemas

ADDED

SENSORIS schema v1.1.0 now includes the new Scala 2.12 bindings.
They can be used in your project using the sensoris-specification_v1_1_0_scala_2.12 artifact id.

2.23.0

Data Client Base Library

UPDATED

Updated Data Client Base Library to support following versions of HERE platform
Data APIs:

- blob: 1.0.5
- config: 1.1.6
- index: 1.1.0
- ingest: 1.1.0
- metadata: 1.0.3
- notifications: 2.0.0
- publish: 2.0.0
- query: 1.0.3
- stream: 2.1.0
- volatileblob: 1.0.1

2.23.0

Data Client Library

FIXED

Fixed an issue where reading partitions larger than ~135 MB in size from a
compressed layer caused an error with the error message: "Ranges different than
AllBytes are not supported for compressed layers".

2.23.0

Data Client Library

FIXED

Fixed an issue where listing a single file from the hadoop-fs-support using
spark-sql returns empty result.

2.23.0

Data Client Library

REMOVED

Following up the changelog notice in release 2.20, the deprecated optional field
packageType in VolatileVolume class was removed from the JSON parser as the Data
API does not have it anymore.

2.23.0

Data Client Library

CHANGED

We rolled back the usage of Kafka client with OAuth2.
We found there is a JVM classloader problem when using this Kafka client with OAuth2 in conjuction with Flink 1.10 and then performing HERE platform pipeline restart.

2.23.0

Data Processing Library

ADDED

The following useful built-in presets were added to OneToMany to ease
the implementation of many typically used key transformation patterns:

- OneToMany.toChildren
- OneToMany.toDescendants

2.23.0

Data Processing Library

FIXED

Fixed bug in batch-validation's publishAndAggregateByLevel transformation that caused an
exception if the test DeltaSet contained the root tile (tile ID 1).

2.23.0

Data Processing Library

CHANGED

In the DeltaSets programming abstraction, the mapKeys and flatMapKeys transformations can
now specify partial inverse functions. This is particularly useful because the Data Processing
Library can call the inverse functions on values that are of the key type, but are never produced
by the mapping function. For such values, it may not be convenient or even possible to define a
correct inverse. This problem can now be solved by restricting the domain of the inverse function
to only those keys for which the inverse can be correctly defined.

For example, OneToOne[Int, String](_.toString, _.toInt) is incorrect, because the inverse is not
correctly defined for all strings. Instead, a partial function should be used:
OneToOne[Int, String](_.toString, \{ case s: String if s forall Character.isDigit => s.toInt \})

This change brings a minor backward incompatibility with the previous version of DPL: if the
OneToOne, OneToMany, ManyToOne, or ManyToMany relation is defined in a place where
DeltaSet transformations are not imported, a partial function must be used for the inverse even
if the inverse is defined on all keys. For example, OneToOne(_.toInt, _.toString) would have to
be replaced by OneToOne(_.toInt, PartialFunction(_.toString)).

2.23.0

Location Library

ADDED

The Location Library now offers PropertyMaps.overlappingRangeBasedProperty, a
factory method for on-the-fly compiling PropertyMaps from range-based HERE Map
Content attributes with overlapping ranges.

If the attribute you are trying to compile contains overlapping ranges, you can
use this method instead of existing methods like
PropertyMaps.rangeBasedProperty which only support non-overlapping ranges.

2.23.0

Location Library

REMOVED

A few implementation details were found to be mistakenly exposed. Since they
don't pertain to the intended user-facing API and are likely to change in the
near future, they were removed from the public scope. This applies to
following class members:

- In class StandaloneCatalog:
- field dataClientSettings,
- field timeout,
- field actorSystem.
- In class StandaloneCatalogFactory:
- field timeout,
- field optionalDataClientSettings.

Existing code shouldn't be affected by the removal but, in the very hypothetical
case where these fields were used in your code, please keep in mind that the
values they reference are not different from the values passed at construction
time.