Skip to content

Commit dbb8f10

Browse files
heremaps-botheremaps-bot
authored andcommitted
HERE Data SDK for Java & Scala Release 2.18.0
1 parent f46623b commit dbb8f10

File tree

110 files changed

+2904
-264
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

110 files changed

+2904
-264
lines changed

README.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ For more information, see a use case illustration of [keeping a client map up to
4141
### Archiving Stream Data
4242

4343
The HERE Workspace allows you to retain stream data for longer periods, which allows you to later query and process the retained data for non-real-time use cases.
44-
For more information, see [Data Archiving Library Developer Guide.](https://developer.here.com/olp/documentation/data-archiving-library/dev_guide/index.html)
44+
For more information, see [Data Archiving Library Developer Guide](https://developer.here.com/olp/documentation/data-archiving-library/dev_guide/index.html).
4545

4646
| Name | Description | Source | Labels / Topics |
4747
| ---- | ----------- | ------ | --------------- |
@@ -51,6 +51,17 @@ For more information, see [Data Archiving Library Developer Guide.](https://deve
5151
| Archiving SENSORIS stream data in Parquet| The example shows how to use the Data Archiving Library to quickly develop an archiving solution that archives SENSORIS data in Parquet format. | [Java](data-archive/java/sensoris-parquet-example) | Data Archiving Library, Flink, Stream, SENSORIS, Parquet |
5252
| Archiving SENSORIS stream data in Protobuf| The example shows how to use the Data Archiving Library to quickly develop an archiving solution that archives SENSORIS data in Protobuf format. | [Java](data-archive/java/sensoris-protobuf-example) | Data Archiving Library, Flink, Stream, SENSORIS, Protobuf |
5353

54+
### Compacting Index Data
55+
56+
The HERE Workspace allows you to compact data files with the same index attribute values into one or more files based on the configuration.
57+
Compaction reduces the index layer storage cost, improves query performance, and makes subsequent data processing more efficient.
58+
For more information, see [Index Compaction Library Developer Guide](https://developer.here.com/olp/documentation/index-compaction-library/dev_guide/index.html).
59+
60+
| Name | Description | Source | Labels / Topics |
61+
| ---- | ----------- | ------ | --------------- |
62+
| Compacting Parquet format indexed data | The example shows how to use the Index Compaction Library to quickly develop a compaction application that compacts parquet format data. | [Java](index-compaction-batch/java/parquet-example) | Index Compaction Library, Spark, Batch, Parquet, SDII |
63+
| Compacting Protobuf format indexed data | The example shows how to use the Index Compaction Library to quickly develop a compaction application that compacts protobuf format data. | [Java](index-compaction-batch/java/protobuf-example) | Index Compaction Library, Spark, Batch, Parquet, SDII |
64+
5465
### Small Examples Showing Usage of Location Library
5566

5667
The following examples demonstrate how to use the Location Library. Sources can be found [here for Java](location/java/standalone) and [here for Scala](location/scala/standalone).

data-archive/java/avro-example/README.md

Lines changed: 14 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,10 @@ olp project create $PROJECT_ID $PROJECT_NAME
4242

4343
The command returns the [HERE Resource Name (HRN)](https://developer.here.com/documentation/data-user-guide/user_guide/shared_content/topics/olp/concepts/hrn.html) of your new project. Note down this HRN as you'll need it later in this tutorial.
4444

45-
> Note: You don't have to provide a `--scope` parameter if your app has a default scope.
45+
> Note:
46+
> You don't have to provide a `--scope` parameter if your app has a default scope.
47+
> For details on how to set a default project scope for an app, see the _Specify a
48+
> default Project_ for Apps chapter of the [Teams and Permissions Guide](https://developer.here.com/documentation/access-control/user_guide/topics/manage-projects.html).
4649
4750
For more information on how to work with projects, see the [Organize your work in projects](https://developer.here.com/documentation/java-scala-dev/dev_guide/organize-work-in-projects/index.html) tutorial.
4851

@@ -58,10 +61,10 @@ Use the **HERE platform portal** to [create the input catalog](https://developer
5861

5962
- For instructions on how to create a catalog, refer to **Create a Catalog** in [Data User Guide](#data-user-guide).
6063
- For instructions on how to create a layer, refer to **Create a Layer** in [Data User Guide](#data-user-guide).
61-
- For instructions on how to link a resource to a project, refer to **Project Resources Link** in [Command Line Interface Developer Guide](https://developer.here.com/documentation/open-location-platform-cli/user_guide/topics/project/project-resources-commands.html#project-resources-link).
64+
- For instructions on how to link a resource to a project, refer to **Project Resources Link** in [Command Line Interface Developer Guide](#command-line-interface-developer-guide).
6265
- For instructions on how to share your project, refer to **Manage Projects** in [Teams and Permissions User Guide](#teams-and-permissions-user-guide).
6366

64-
Alternatively, you can use the **OLP CLI Commands** in [Command Line Interface Developer Guide](https://developer.here.com/documentation/open-location-platform-cli/user_guide/index.html) instead of the platform portal to create a new catalog with a `stream` layer:
67+
Alternatively, you can use the **OLP CLI Commands** in [Command Line Interface Developer Guide](#command-line-interface-developer-guide) instead of the platform portal to create a new catalog with a `stream` layer:
6568

6669
> Note:
6770
> We recommend you to set values to variables so that you can easily copy and execute the following commands.
@@ -95,10 +98,10 @@ Use the **HERE platform portal** to [create the output catalog](https://develope
9598

9699
- For instructions on how to create a catalog, refer to **Create a Catalog** in [Data User Guide](#data-user-guide).
97100
- For instructions on how to create a layer, refer to **Create a Layer** in [Data User Guide](#data-user-guide).
98-
- For instructions on how to link a resource to a project, refer to **Project Resources Link** in [Command Line Interface Developer Guide](https://developer.here.com/documentation/open-location-platform-cli/user_guide/topics/project/project-resources-commands.html#project-resources-link).
101+
- For instructions on how to link a resource to a project, refer to **Project Resources Link** in [Command Line Interface Developer Guide](#command-line-interface-developer-guide).
99102
- For instructions on how to share your project, refer to **Manage Projects** in [Teams and Permissions User Guide](#teams-and-permissions-user-guide).
100103

101-
Alternatively, you can use the **OLP CLI Commands** in [Command Line Interface Developer Guide](https://developer.here.com/documentation/open-location-platform-cli/user_guide/index.html) instead of the platform portal to create a new catalog with an `index` layer:
104+
Alternatively, you can use the **OLP CLI Commands** in [Command Line Interface Developer Guide](#command-line-interface-developer-guide) instead of the platform portal to create a new catalog with an `index` layer:
102105

103106
1. Use the [`olp catalog create`](https://developer.here.com/documentation/open-location-platform-cli/user_guide/topics/data/catalog-commands.html#catalog-create) command to create the catalog.
104107
Make sure to note down the HRN returned by the following command for later use:
@@ -152,7 +155,7 @@ For information on using the platform portal to configure and run a pipeline, se
152155

153156
#### Use the Command Line Interface to Run a Pipeline
154157

155-
You can use the **OLP CLI Commands** in [Command Line Interface Developer Guide](https://developer.here.com/documentation/open-location-platform-cli/user_guide/index.html) to create pipeline components and activate it.
158+
You can use the **OLP CLI Commands** in [Command Line Interface Developer Guide](#command-line-interface-developer-guide) to create pipeline components and activate it.
156159

157160
First, configure data sources using the `config/pipeline-config.conf` file. This file contains the configuration of the data sources which are used as placeholders for Data Archiving Library examples:
158161

@@ -165,7 +168,7 @@ pipeline.config {
165168
}
166169
```
167170

168-
You must replace `YOUR_OUTPUT_CATALOG_HRN` with the HRN of your output catalog and `YOUR_INPUT_CATALOG_HRN` with the HRN of your input catalog. To find the HRN, in the [HERE platform portal](#olp-portal), navigate to your catalog. The HRN is displayed in the upper left corner of the page.
171+
You must replace `YOUR_OUTPUT_CATALOG_HRN` with the HRN of your output catalog and `YOUR_INPUT_CATALOG_HRN` with the HRN of your input catalog. To find the HRN, in the [HERE platform portal](#here-platform-portal), navigate to your catalog. The HRN is displayed in the upper left corner of the page.
169172

170173
You can use the OLP CLI to create pipeline components and activate the pipeline version with the following commands:
171174

@@ -194,20 +197,20 @@ olp pipeline version activate $PIPELINE_ID $PIPELINE_VERSION_ID --scope $PROJECT
194197
In the [HERE platform portal](https://platform.here.com/pipelines) / [HERE platform China portal](https://platform.hereolp.cn/pipelines)
195198
navigate to your pipeline to see its status.
196199

197-
For more information on using the **OLP CLI** to configure and run a pipeline, see **Pipeline Commands** in [Command Line Interface Developer Guide](https://developer.here.com/documentation/open-location-platform-cli/user_guide/index.html).
200+
For more information on using the **OLP CLI** to configure and run a pipeline, see **Pipeline Commands** in [Command Line Interface Developer Guide](#command-line-interface-developer-guide).
198201

199202
> #### Note
200203
> The selection of input and output catalog values using the portal when creating pipeline version or the values added to `pipeline.config` when using command line interface must be valid. These values represent a placeholder which will not be used by the the Data Archiving Library. Instead, values will be taken from the `application.conf` file. If you want to change or update the input/output catlogs, modify the `application.conf` file and rebuild.
201204
202205
## Verify the Output
203206

204-
In the [HERE platform portal](#olp-portal) select the _Pipelines_ tab and find your pipeline.
207+
In the [HERE platform portal](#here-platform-portal) select the _Pipelines_ tab and find your pipeline.
205208
- Verify pipeline is in `Running` state.
206209

207210
After the pipeline is running, you can ingest your data into the `stream` layer created in the `Create Input Catalog and Layer` section using one of the following:
208211
- **Publish to a Stream Layer** in [Data API Developer Guide](#data-api-developer-guide)
209212
- **Publish Data** in [Data Client Library Developer Guide](#data-client-library-developer-guide)
210-
- **Stream** in [Command Line Interface Developer Guide](https://developer.here.com/documentation/open-location-platform-cli/user_guide/index.html)
213+
- **Stream** in [Command Line Interface Developer Guide](#command-line-interface-developer-guide)
211214

212215
> #### Note
213216
> For ingesting data, make sure your app has `read` and `write` permission to your `stream` layer.
@@ -220,7 +223,7 @@ After the pipeline is running, you can ingest your data into the `stream` layer
220223
After your data is archived in `index` layer, you can query/retrieve data using one of the following:
221224
- **Get Data from an Index Layer** in [Data API Developer Guide](#data-api-developer-guide)
222225
- **Get Data** in [Data Client Library Developer Guide](#data-client-library-developer-guide)
223-
- **Partitions** in [Command Line Interface Developer Guide](https://developer.here.com/documentation/open-location-platform-cli/user_guide/index.html)
226+
- **Partitions** in [Command Line Interface Developer Guide](#command-line-interface-developer-guide)
224227
> #### Note
225228
> For querying metadata or retrieving data, make sure your app has `read` permission to your `index` layer.
226229
> For instructions on how to manage app, refer to **Manage Apps** in [Teams and Permissions User Guide](#teams-and-permissions-user-guide).

data-archive/java/avro-example/pom.xml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33

44
<groupId>com.here.platform.data.archive</groupId>
55
<artifactId>data-archive-avro-example</artifactId>
6-
<version>0.0.528</version>
6+
<version>0.0.548</version>
77
<packaging>jar</packaging>
88

99
<!-- Meta information section start -->
@@ -23,10 +23,10 @@
2323
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
2424
<java.version>1.8</java.version>
2525

26-
<sdk-bom.version>2.17.9</sdk-bom.version>
26+
<sdk-bom.version>2.18.5</sdk-bom.version>
2727
<scala.compat.version>2.11</scala.compat.version>
2828

29-
<avro.version>1.8.2</avro.version>
29+
<avro.version>1.10.0</avro.version>
3030
<commons-logging.version>1.2</commons-logging.version>
3131

3232
<junit.version>4.12</junit.version>

0 commit comments

Comments
 (0)