Metadata-Version: 2.4
Name: here-search-demo
Version: 0.24.2
Summary: HERE Geocoding and Search demo and widgets
Author-email: "HERE Global B.V. and its affiliate(s)" <590094+decitre@users.noreply.github.com>
License-Expression: MIT
Project-URL: homepage, https://here.com
Project-URL: repository, https://github.com/heremaps/here-search-demo
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: WebAssembly :: Emscripten
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: Implementation :: CPython
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp
Requires-Dist: ipyleaflet==0.20.0
Requires-Dist: ipywidgets==8.1.8
Requires-Dist: orjson
Requires-Dist: xyzservices==2025.11.0
Requires-Dist: yarl
Provides-Extra: lab
Requires-Dist: ipykernel==6.31.0; extra == "lab"
Requires-Dist: jupyterlab; extra == "lab"
Provides-Extra: route
Requires-Dist: flexpolyline==0.1.0; extra == "route"
Requires-Dist: pyproj==3.7.2; extra == "route"
Requires-Dist: shapely; extra == "route"
Provides-Extra: dev
Requires-Dist: build; extra == "dev"
Requires-Dist: bumpver; extra == "dev"
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-asyncio; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Requires-Dist: twine; extra == "dev"
Requires-Dist: wheel; extra == "dev"
Dynamic: license-file

[![Python package][6]][7]
[![codecov][8]][9]
[![lite-badge][10]][3]


# HERE Search notebooks

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

![searching for pizza][11]

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

| Use Case            | Installation                                          |
|:--------------------|:------------------------------------------------------|
| Online use          | Run the notebooks [in your browser][3]                |
| Local use           | [Install and try locally](#install-and-try-locally)   |
| Package maintenance | [Install from the sources](#install-from-the-sources) |

## 0-install use

`here-search-demo` notebooks are available in a [Github page][3] 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:
   ```shell
   uv pip install 'here-search-demo[lab,route]'
   ```
   
2. Grab the notebooks from the [GitHub release asset][12]
3. Add your [HERE API key][1] 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:
   ```shell
   (cd packages/demo; 
    uv pip install -r <(sort -u requirements/*) -e '.[dev,lab,route]' )
   ```

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

3. Link the virtual environment to a IPython kernel:

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

4. Start either

     - JupyterLab:
       ```shell
       python -m jupyterlab notebooks
       ```
     - or JupyterLite
       ```shell
       bash scripts/lite-build.sh
       ```



(Additional [notes][2])

## License

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

This project is licensed under the MIT license - see the [LICENSE](./LICENSE) file in the root of this project for license details.

[1]: https://www.here.com/docs/bundle/geocoding-and-search-api-developer-guide/page/topics/quick-start.html#get-an-api-key
[2]: https://github.com/heremaps/here-search-demo/blob/main/docs/developers.md
[3]: https://heremaps.github.io/here-search-demo/lab/?path=demo.ipynb
[4]: https://www.here.com/docs/category/geocoding-search-v7
[5]: https://www.here.com/get-started/pricing

[6]: https://github.com/heremaps/here-search-demo/actions/workflows/test.yml/badge.svg
[7]: https://github.com/heremaps/here-search-demo/actions/workflows/test.yml
[8]: https://codecov.io/gh/heremaps/here-search-demo/branch/main/graph/badge.svg?token=MVFCS4BUFN
[9]: https://codecov.io/gh/heremaps/here-search-demo
[11]: https://github.com/heremaps/here-search-demo/raw/main/docs/screenshot.jpg
[10]: https://jupyterlite.rtfd.io/en/latest/_static/badge.svg
[12]: https://github.com/heremaps/here-search-demo/releases/latest/download/here-search-demo-notebooks.zip
