GuidesTypeScript API ReferencePython v2 API Reference
Guides
  1. Data SDK Python V2

HERE Data SDK for Python installation

The HERE Data SDK for Python is divided into packages that you can install using pip.

  • HERE Platform: All core operations for interacting with HERE platform catalogs, layers, projects, and schemas (package name: here-platform).
  • HERE Geotiles: Support methods for tile/partition calculations using HERE tile partitioning (here-geotiles).
  • HERE GeoPandas Adapter: Adapts the functionality of HERE platform and HERE Geotiles for seamless use with Pandas/GeoPandas data structures (here-geopandas-adapter).
  • HERE Content: Content bindings that enable you to more easily extract and manipulate HERE Map Content layers (here-content).
  • HERE Inspector: Component to visualize and inspect geospatial data from in Jupyter notebooks (here-inspector).

System requirements

To install and use all packages above, minimum values for available disk space and installed memory are

  • 100 MB available disk space
  • 2 GB RAM

Get a HERE account

Obtain access to the HERE platform through your organization administrator's invitation or contact us to get started.

  • If your company has already established a HERE platform organization, contact your organization admin who can invite you to join the organization.
  • If your company hasn’t established a HERE platform organization yet, contact us.

Prerequisites

Make sure you have the following before you install the SDK packages:

  • Python of one of the supported versions 3.10, 3.11, 3.12, 3.13, 3.14. We suggest to use version 3.13. You can try to use an older or newer version at your own risk.
  • pip installer
  • Some familiarity with managing Python environments (highly recommended).

Managing your Python working environment is important for professional software development but outside the scope of this documentation. You can have a look at this overview on venv, pipenv and others.

🚧

Caution

We recommend installing packages using pip because it works with different Python package managers. However, there are some situations where pip is known to be flaky. Pip installation errors related to GDAL and GeoPandas dependencies are especially common on Windows. If you must use pip on Windows, you can find advice for manually dealing with dependency problems here.

📘

Note

Please be aware that if you use intercepting VPN tools (e.g. Zscaler) which bring their own root certificate used for TLS connection you might experience issues when installing packages with pip. This is because pip doesn't recognize such unknown root certificate.

If this is the case for your system, and you cannot switch of the VPN tool then there are different workarounds depending on your Python version.

For Python 3.10 or newer you should tell pip to use the certificates which are installed on your local machine:

pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org pip_system_certs

For further details see https://pip.pypa.io/en/stable/topics/https-certificates/

To use the SDK after the installation you also need to create your credentials on the HERE platform. For more information, see Credentials.

Installing packages with Pip

You can install all SDK packages together with pip using the following syntax: pip install --extra-index-url https://repo.platform.here.com/artifactory/api/pypi/analytics-pypi/simple/ here-platform==2.32.0 here-geotiles==2.32.0 here-geopandas-adapter==2.32.0 here-content==2.32.0 here-inspector==2.32.0 You can also install only individual packages by using the relevant section of command above, e.g. pip install --extra-index-url https://repo.platform.here.com/artifactory/api/pypi/analytics-pypi/simple/ here-platform==2.32.0 here-content==2.32.0 It's always preferred to install the needed packages at once, with one single command.

Updated last month