Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/heremaps/here-data-sdk-cpp

The HERE Data SDK for C++ is a modern, lightweight and modular SDK for the HERE platform
https://github.com/heremaps/here-data-sdk-cpp

android authentication authorization cpp11 data-sdk ios oauth-client olp sdk

Last synced: 6 days ago
JSON representation

The HERE Data SDK for C++ is a modern, lightweight and modular SDK for the HERE platform

Host: GitHub
URL: https://github.com/heremaps/here-data-sdk-cpp
Owner: heremaps
License: apache-2.0
Created: 2019-06-25T13:18:02.000Z (over 5 years ago)
Default Branch: master
Last Pushed: 2024-10-28T09:56:09.000Z (16 days ago)
Last Synced: 2024-10-28T12:59:25.026Z (16 days ago)
Topics: android, authentication, authorization, cpp11, data-sdk, ios, oauth-client, olp, sdk
Language: C++
Homepage: https://www.here.com/products/platform
Size: 36.6 MB
Stars: 51
Watchers: 14
Forks: 43
Open Issues: 16
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE

Awesome Lists containing this project

README

        # HERE Data SDK for C++

HERE Data SDK for C++ is a C++ client for the HERE platform.

## Use the SDK

To learn how to install and use the Data SDK, see the Getting Started Guide and Developer Guide.

## Health check

### Build and test pipelines

| Linux GCC | Linux CLang | MacOS |

| :-------- | :---------- | :---- |

| [![Linux gcc build status][1]][1] | [![Linux Clang build status][1]][1] | [![MacOS build status][1]][1] |

| iOS | Windows | Android |

| :-- | :------ | :------ |

| [![iOS build status][1]][1] | [![Windows build status][1]][1] | [![Android build status][1]][1] |

[1]: https://github.com/heremaps/here-data-sdk-cpp/actions/workflows/psv_pipelines.yml/badge.svg

### Full verification testing pipelines

| iOS | Android |

| :-- | :------ |

| [![iOS test status][2]][2] | [![Android test status][2]][2] |

[2]: https://github.com/heremaps/here-data-sdk-cpp/actions/workflows/fv_pipelines.yml/badge.svg 

### Test coverage

| Platform | Status                                                                                                                                                                                              |

| :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

| Linux    |  |

## Backward compatibility

We try to develop and maintain our API in a way that preserves its compatibility with the existing applications. Changes in Data SDK for C++ are greatly influenced by the Data API development. Data API introduces breaking changes 6 months in advance. Therefore, you may need to migrate to a new version of Data SDK for C++ every half a year.

For more information on Data API, see its Developer Guide and API Reference.

When new API is introduced in Data SDK for C++, the old one is not deleted straight away. The standard API deprecation time is 6 months. It gives you time to switch to new code. However, we do not provide ABI backward compatibility.

Learn more about deprecated methods, functions, and parameters in the Data SDK for C++ API Reference and changelog.

For more information on Data SDK for C++, see our Developer Guide.

## Supported platforms

The table below lists the platforms on which the Data SDK has been tested.

| Platform                   | Minimum requirement   |

| :------------------------- |:----------------------|

| Ubuntu Linux               | GCC 7.5 and Clang 7.0 |

| Embedded Linux (32 bit)    | GCC 7.4 armhf         |

| Windows                    | MSVC++ 2017           |

| macOS                      | Apple Clang 11.0.0    |

| iOS                        | Xcode 11.7, Swift 5.0 |

| Android                    | API level 21          |



## Dependencies

The table below lists the dependencies of the Data SDK.

| Library              | Recommended version |

|:---------------------|:--------------------|

| Libcurl              | 7.52.1              |

| OpenSSL              | 1.1.1w              |

| Boost (headers only) | 1.72.0              |

| LevelDB              | 1.21                |

| Snappy               | 1.1.7               |

| RapidJSON            | latest              |

| Zlib                 | 1.3.1               |

### Linux dependencies

To install the dependencies on Linux, run the following command:

```bash

sudo apt-get update && sudo apt-get --yes install git g++ make cmake libssl-dev libcurl4-openssl-dev libboost-all-dev

```

> #### Note

> Please note that on some Linux distribution, the default libcurl version can be lower than the required v7.52.0. In that case, you need to install the required libcurl version from a different PPA.

## Contribution

For details, see HERE Data SDK C++ Contributors Guide.

## LICENSE

Copyright (C) 2019–2024 HERE Europe B.V.

For license details, see the LICENSE file in the root of this project.

> #### Note

> This project has Open Source Software dependencies that are downloaded and installed upon execution of the abovementioned installation commands. For further details, see the CMake configuration files included in the external directory.