Get started

This section provides information on the minimum setup required to quickly begin using the Road Network catalog's data:

  1. Get a HERE account
  2. Install the OLP CLI
  3. Get your credentials
  4. Download all catalog partitions

The following procedures apply to HERE platform users who have already purchased the Road Network catalog from the HERE Marketplace. For more information on how to browse catalog listings and subscribe to listings on the HERE Marketplace, see the Marketplace Consumer User Guide.

A project named My Purchases is created and the Road Network catalog is linked automatically after purchasing the Road Network catalog from the HERE Marketplace. You can use the My Purchases project to quickly register an app and generate your credentials.


A maximum of five sub-resources are linked to the My Purchases project by default. Additional sub-resources can be linked using the Projects Manager on the HERE platform.

You can link the Road Network catalog to additional projects. For more detailed information on HERE account setup, project creation, service linking, app registration, and authentication, see the Identity & Access Management Developer Guide.

Get a HERE account

You can get started with a free HERE platform account from the flexible HERE Base Plan. For more information, see the HERE Base Plan Pricing. Alternatively, if your company has already established a HERE platform organization, contact your organization admin who can invite you to join your company's organization.

Install the OLP CLI

For information on how to install the OLP CLI, see the Command Line Interface User Guide.

Get your credentials

To get your credentials, follow these steps:

  1. Sign in to the HERE platform using your HERE account.
  2. Select the Access Manager from the launcher.
  3. Select the Apps tab and click Register new app.
  4. Enter a name for the app.
  5. Optional: Enter a description for the app.
  6. Under New app, select Create.
  7. Select the My Purchases project from the Default access to a project field.
  8. Click Register. The HERE platform creates a new app with a unique app ID.
  9. On the Credentials tab, click Create credentials. An access key is created and displayed.
  10. Click download to download the file.
  11. Create a default profile by running the following command in the OLP CLI:
olp credentials import default
  1. Run the following command in the directory that contains the OLP CLI JAR file to verify that your credentials have been correctly configured:
olp api token get

Output similar to the following is returned, confirming that your credentials have been configured correctly:

Token: eyJhbGciOiJSUzUxMiIsImN0eSI6IkpXVCIsImlzcyI6IkhFUkUiLCJhaWQiOiJtekxjYjFyTDhuc2t2RFFwQ0ZFRiIs
Token Expires at: 2018-03-24T14:03:48.100Z

Download all catalog partitions

To download all catalog partitions, follow these steps:

  1. Sign in to the HERE platform using your HERE account.
  2. Open the Projects Manager from the launcher and locate and note the HERE Resource Name (HRN) of the My Purchases project.

    Example project HRN
    Figure 1. Example project HRN
  3. Click the Road Network catalog, and then click View to view the linked catalog.

  4. Locate and note the catalog HRN.

    Example catalog HRN
    Figure 2. Example catalog HRN
  5. Select a layer from the Layers section and locate and note the Layer ID.

    Example Layer ID
    Figure 3. Example Layer ID
  6. Run the following command in the OLP CLI to download all the partitions within the scope of the catalog:

olp catalog layer partition get <catalog HRN> <layer ID>  --all --scope <project hrn>

For example, the following command downloads all partitions of the rules-and-regulations layer of the hrn:here:marketplace::olp-here:listing:here-signs-signals-and-warnings catalog:

olp catalog layer partition get hrn:here:marketplace::olp-here:listing:here-signs-signals-and-warnings rules-and-regulations --all --scope hrn:here-dev:authorization::orgXXX:project/my-purchases


For more information on downloading partitions using the OLP CLI, see the Command Line Interface User Guide.

results matching ""

    No results matching ""