Installation

The Data SDK for Python is divided into packages that you can install using either conda or 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

Prerequisites

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

  • Python, version 3.7 or higher.
  • One of these installers: conda or pip.
  • 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 and this specific one on conda. Detailed, official conda documentation on managing environments and packages is also very useful.

Conda comes with any Anaconda distribution of Python or a minimal bootstrap version of it named Miniconda. Pip is included with Python versions 3.4 or later.

Caution

We recommend installing packages using conda because it effectively handles GDAL and C++ dependencies. 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.

Do not install SDK packages in the conda base environment. Activate a new or existing environment before installing.

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 Conda

You can install all SDK packages together with conda using the following syntax:

conda install -c conda-forge -c https://repo.platform.here.com/artifactory/api/conda/olp_analytics/analytics_sdk here-platform=2.12.1 here-geotiles=2.12.1 here-geopandas-adapter=2.12.1 here-content=2.12.1 here-inspector=2.12.1

You can also install only individual packages by using the relevant section of command above, e.g.

conda install -c conda-forge -c https://repo.platform.here.com/artifactory/api/conda/olp_analytics/analytics_sdk here-platform=2.12.1 here-content=2.12.1

It's always preferred to install the needed packages at once, with one single command.

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.12.1 here-geotiles==2.12.1 here-geopandas-adapter==2.12.1 here-content==2.12.1 here-inspector==2.12.1

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.12.1 here-content==2.12.1

It's always preferred to install the needed packages at once, with one single command.

results matching ""

    No results matching ""