Skip to content

heremaps/here-search-demo

Repository files navigation

Python package codecov lite-badge

HERE Search notebooks

A set of jupyter notebooks demonstrating the use of HERE Geocoding & Search endpoints /autosuggest, /discover, /browse, and /lookup.

searching for pizza

Requirements: a HERE API key and a Python environment. Note that HERE Base Plan Pricing allows you to get started for free.

The notebooks can be used in your browser without further installation.

Installation

If you need to install the notebooks or the underlying library on your workstation, run preferably in a virtual environment:

pip install 'here-search-demo[lab]'

Or as a developer:

pip install -r <(sort -u requirements/*) -e '.[lab]'

Link the virtual environment to a IPython kernel:

python -m ipykernel install \
  --prefix $(python -c "import sys; print(sys.prefix)") \
  --name search_demo --display-name "search demo"

Copy demo-config-example.json to demo-config.json and add your HERE API key to it.

Start JupyterLab:

python -m jupyterlab src/here_search/demo/notebooks

Or instead of JupyterLab, start JupyterLite

bash src/here_search/demo/scripts/lite-run.sh

(Additional notes)

License

Copyright (C) 2022-2025 HERE Europe B.V.

This project is licensed under the MIT license - see the LICENSE file in the root of this project for license details.