An open API service indexing awesome lists of open source software.

https://github.com/heremaps/here-search-demo

A set of python notebooks illustrating a few recommended uses of HERE Geocoding & Search endpoints
https://github.com/heremaps/here-search-demo

heremaps ipywidgets jupyter-notebooks jupyterlite pyodide python search

Last synced: 7 months ago
JSON representation

A set of python notebooks illustrating a few recommended uses of HERE Geocoding & Search endpoints

Awesome Lists containing this project

README

          

[![Python package](https://github.com/heremaps/here-search-demo/actions/workflows/test.yml/badge.svg)](https://github.com/heremaps/here-search-demo/actions/workflows/test.yml)
[![codecov](https://codecov.io/gh/heremaps/here-search-demo/branch/main/graph/badge.svg?token=MVFCS4BUFN)](https://codecov.io/gh/heremaps/here-search-demo)
[![lite-badge](https://jupyterlite.rtfd.io/en/latest/_static/badge.svg)][3]

# HERE Search notebooks

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

![searching for restaurants](https://github.com/heremaps/here-search-demo/raw/main/docs/screenshot.png)

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

The notebooks can be [used in your browser][3] 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"
```

Start Jupyter Lab with your HERE API Key:

```
API_KEY="your API key" python -m jupyterlab src/here_search/demo/notebooks
```

(Additional [notes][2])

## License

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