here-search-demo 0.25.2

HERE Geocoding and Search demo and widgets

HERE Search notebooks

A set of 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 for immediate use in a Github page hosting a JupyterLite instance based on the xeus stack (CPython running on xeus-python kernel).

A version of these pages based on the Pyodide stack and the jupyterlite-pyodide-kernel is also available here.

Install and try locally

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

1. Install the widgets:

   uv pip install 'here-search-demo[lab,route]'
   

2. Grab the notebooks from the GitHub release asset

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

Install from the sources

If you need to maintain this package:

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

   uv pip install -e '.[dev,lab,route]'
   

2. Copy example-credentials.properties to notebooks/credentials.properties and update the later one with your HERE credentials.

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 notebooks
     

   • or JupyterLite

     bash scripts/lite-build.sh
     

(Additional notes)

License

Copyright (C) 2022-2026 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.