HERE Search notebooks

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

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

Use Case	Installation
Online use	Run the notebooks in your browser
Local use	Install and try locally
Package maintenance	Install from the sources

0-install use

here-search-demo notebooks are available in a Github page hosting a JupyterLite instance. This allows users to not have to install anything.

Install and try locally

If you want to use the library and try it through existing notebooks, do:

1. Install the widgets:

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

2. Grab the notebooks from the GitHub release asset

3. Add your HERE API key to demo-config.json file.

Install from the sources

1. git clone it and into a virtualenv/venv, do:

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

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

3. 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"

4. Start either

   • JupyterLab:

     python -m jupyterlab src/here_search/demo/notebooks

   • or 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.