How to download HERE map content catalogs using OLP CLI

Purpose

This article explains how to download HERE Map Content (such as HD Live Map or HMC data) from the HERE platform using the Open Location Platform Command Line Interface (OLP CLI).

Background

HERE map data is delivered through catalogs, which contain layers and partitions, rather than as a single downloadable file.

To download map data, you must:
- have access to the relevant catalogs,
- use OLP CLI with valid credentials
- specify the correct layer and partition details

Prerequisites

Before proceeding, ensure:
- you have access to the required map catalogs in the HERE platform
- you have created an app and obtained credentials, and OLP CLI is installed on your machine.

Step 1 — Install OLP CLI

Install the CLI depending on your operating system.

Windows:

 > winget install HERE.OLPCLI 

Linux:

 > sudo apt-get install olp-cli 

macOS:

 > brew install heremaps/olp-cli/olp 

You can also download the CLI package from the HERE platform portal.

Step 2 — Configure credentials

Generate credentials from the HERE platform by navigating to Access Manager and creating an app.
Download the credentials file and save it locally, for example under your home directory.

Step 3 — Identify catalog, layer, and partitions

From the HERE platform portal, go to Launcher and open the Data section.
Open the target catalog and note the catalog HRN and the layer ID.
Then identify the required partition IDs depending on your data needs.

Step 4 — Verify catalog access

Run the following command to verify that your CLI credentials can access the catalog.

 > olp catalog list 

If the catalog appears in the output, your access is correctly configured.

Step 5 — Download map data partitions

Use the following command to download partition data from a layer.

 > olp catalog layer partition get --partitions --credentials --output 

Example:

 > olp catalog layer partition get hrn:here:data::olp-here:rib-2 topology-geometry --partitions 23618401 --credentials ~/Downloads/credentials.properties --output ./ 

Step 6 — Download decoded data (optional)

If the data is encoded, you can retrieve decoded output using the decode option.

 > olp catalog layer partition get --partitions --decode true --credentials --output 

Important Notes

HERE map data is not available as a single downloadable file. It is always accessed and downloaded per catalog, layer, and partition.

Access via the platform portal does not guarantee CLI access. The app used by the CLI must have explicit permissions to the catalog.

Troubleshooting

If the catalog is not listed, the app may not have access to it. Ensure the catalog is linked to your project.

If you receive a 403 or access denied error, verify that your credentials are correct and that your app has permission to access the catalog.

If no data is returned, confirm that the partition ID is valid and available in the catalog.

References

HERE OLP CLI User Guide
HERE Platform Data API Documentation