Start using your purchased data

Once you have purchased HERE lidar data, you can download and use it in your projects. One way to set up a project and download your lidar data to your app is to use the HERE Command Line Interface (OLP CLI), as described below:

1. Install the OLP CLI
2. Create a project
3. Link your lidar catalog to your project
4. Get your credentials
5. Download all catalog partitions

Install the OLP CLI

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

Create a project

To create a project, follow these steps:

1. Sign in to the HERE platform using your HERE account.
2. Open the Projects Manager from the launcher.
3. Click Create new project.
4. Enter a name for the project. Project names don't have to be unique.
5. Enter a project ID. Project IDs must be unique within an organization and cannot be changed for the lifetime of the organization. Project IDs must be between 4 and 16 characters in length.
6. Optional: Enter a description.
7. Click Save.

Link your lidar catalog to your project

To access your lidar data, you must link your lidar catalog to your project, as follows:

1. Sign in to the HERE platform using your HERE account.
2. Open the Projects Manager in the launcher and select your project. (Note: The catalogs from your newly purchased lidar product will not appear yet in the list of catalogs linked to your projects.)
3. Click Add catalog and then select Link a catalog from the drop-down list.
4. Search for the lidar catalog in the product you purchased and click Link.
5. Click Apply. The HERE platform displays a success message banner and the Add catalog button is replaced with a linked icon.
6. Click Done. The linked catalog appears under the Catalogs section of the Resources tab.

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 project that you created 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 credentials.properties file.

11. Create a default profile by running the following command in the OLP CLI:

    olp credentials import default credentials.properties
    

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 should be returned, confirming that your credentials have been configured correctly:

```
Token: eyJhbGciOiJSUzUxMiIsImN0eSI6IkpXVCIsImlzcyI6IkhFUkUiLCJhaWQiOiJtekxjYjFyTDhuc2t2RFFwQ0ZFRiIs
ImlhdCI6MTUyMTgwNjYyOCwiZXhwIjoxNTIxODkzMDI4LCJraWQiOiJqMSJ9.ZXlKaGJHY2lPaUprYVhJaUxDSmxibU1pT2lKQk
1qVTJRMEpETFVoVE5URXlJbjAuLmtGc0JMODJibEUxTHhCS1M3MEctcFEuZHhsb2psaklEQmdNVEdoMEFKMHAzUU9yeE9INXdhd
1hkWjVSLS1Kdkc3VFBoUkRWY3owcUFYZ0V2Y3kwOGpMdzBCR09sNjJfZ2pxeUNuLXhET3JtZV8xNUlkV0tJN2VxTUpZNTNJelRx
ZjhUSzdVVHlEUlJFVnBLRW5BN2FvR2MubFViMTNGYWdKMlVGZXVQZnZsVG44Y2JqTzdtbF9ncGpLamFUN0xmZFF0UQ.EPYB9Rdy
jCHFxrqpaEBWkPzhPmFrAPBKlkt8SQpcI0k71mH_vC6txh6Uv1NVQC4xYyWG7ueq5mb4mcQh1sCorcv15GwIH1R0v0NR_CRPh-M
DNSFtg8HNnWyC1ePsfUGpSqjucQW8RMdbsU03wDO50Pr3ctQI4BZrxiU4HW6tdQq9_TinizujACzE-LMZ6FlFAb6pPB8TDsFlY3
9OmBFXEanaPvZwE01dKjE1K_A_G1_TiJzWo4vwuNeD54HfmOf6hN1IE8-CCSKRoIFoIBiVNqqzyCybyovRlSCWzSaTNz4v9BD7N
2lDgEuBlpn3q0qTFppZzjEvzv3RicGrCC_tmB
Token Expires at: 2018-03-24T14:03:48.100Z
```

Download all catalog partitions

Although you could download your lidar data one file at a time, HERE recommends that you download all the catalog partitions together, as follows:

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 project you created.
3. Click the lidar catalog, and then click View to view the catalog linked to the project you created.
4. Locate and note the catalog HRN.
5. Select a layer from the Layers section and locate and note the Layer ID.

6. Run the following command in the OLP CLI to download all the partitions within the scope of the purchased 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-project

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