# Getting Started Guide

## Prerequisites

To start using HERE Data SDK for C++, you need a platform user account.

Working with the Data SDK requires knowledge of the following subjects:

## Concepts

To use HERE Data SDK for C++, you need to understand the following concepts related to the HERE platform:

For more details, see the Data User Guide.

## Get credentials

To work with catalog or service requests to the HERE platform, you need to get authentication and authorization credentials.

You can authenticate to the HERE platform within your application with the platform credentials available on the HERE Portal by means of Data SDK for C++ authentication library. For the available authentication options, see the Identity & Access Management Developer Guide.

## Available components

Data SDK for C++ contains separate libraries, each of which has a distinct functionality. For more information about the components, see the architectural overview.

## HERE Data SDK for C++ in CMake projects

Once the libraries are installed, you can find them using the find_package() function within your project. For more information on how to install libraries, see the related section in the README.md file.

find_package(olp-cpp-sdk-core REQUIRED)
find_package(olp-cpp-sdk-authentication REQUIRED)
find_package(olp-cpp-sdk-dataservice-write REQUIRED)


Once the necessary targets are imported, you can link them to your library:

target_link_libraries(example_app
olp-cpp-sdk-core
olp-cpp-sdk-authentication
olp-cpp-sdk-dataservice-write
)


## Reference documentation

The API reference documentation for Data SDK for C++ is available on our GitHub Pages.

## Examples

HERE Data SDK for C++ contains several example programs that demonstrate some of the key use cases. These example programs can be found in the examples folder:

• Read example – demonstrates how to get catalog and partition metadata, as well as partition data.
• Read example for a stream layer – demonstrates how to get data from a stream layer.
• Cache example – demonstrates how to get partition data and work with a mutable and protected cache.
• Write example – demonstrates how to publish data to OLP.