{"id":18542166,"url":"https://github.com/heremaps/here-search-demo","last_synced_at":"2026-03-08T18:06:13.232Z","repository":{"id":154621703,"uuid":"558274559","full_name":"heremaps/here-search-demo","owner":"heremaps","description":"HERE Search Python widgets","archived":false,"fork":false,"pushed_at":"2025-12-20T08:37:18.000Z","size":3428,"stargazers_count":1,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-12-22T09:43:02.750Z","etag":null,"topics":["heremaps","ipywidgets","jupyter-notebooks","jupyterlite","pyodide","python","search"],"latest_commit_sha":null,"homepage":"https://www.here.com/docs/category/geocoding-search-v7","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/heremaps.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-10-27T08:17:35.000Z","updated_at":"2025-12-20T08:37:22.000Z","dependencies_parsed_at":"2024-01-14T00:21:12.491Z","dependency_job_id":"1f952bd5-1e7b-4231-92e4-3e47d7c1eb22","html_url":"https://github.com/heremaps/here-search-demo","commit_stats":{"total_commits":340,"total_committers":4,"mean_commits":85.0,"dds":"0.47352941176470587","last_synced_commit":"dc519434cf4916dc907eedc171b287fe7f1216fb"},"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/heremaps/here-search-demo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heremaps%2Fhere-search-demo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heremaps%2Fhere-search-demo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heremaps%2Fhere-search-demo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heremaps%2Fhere-search-demo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/heremaps","download_url":"https://codeload.github.com/heremaps/here-search-demo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heremaps%2Fhere-search-demo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29965405,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T06:55:38.174Z","status":"ssl_error","status_checked_at":"2026-03-01T06:53:04.810Z","response_time":124,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["heremaps","ipywidgets","jupyter-notebooks","jupyterlite","pyodide","python","search"],"created_at":"2024-11-06T20:07:36.038Z","updated_at":"2026-03-08T18:06:13.226Z","avatar_url":"https://github.com/heremaps.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Python package][6]][7]\n[![codecov][8]][9]\n[![lite-badge][10]][3]\n\n\n# HERE Search notebooks\n\nA set of jupyter widgets and notebooks demonstrating the use of [HERE Geocoding \u0026 Search][4] endpoints `/autosuggest`,  `/discover`, `/browse`, and `/lookup`.\n\n![searching for pizza][11]\n\nRequirements: a [HERE API key][1] and a Python environment. Note that HERE Base Plan [Pricing][5] allows you to get started for free.\n\n| Use Case            | Installation                                          |\n|:--------------------|:------------------------------------------------------|\n| Online use          | Run the notebooks [in your browser][3]                |\n| Local use           | [Install and try locally](#install-and-try-locally)   |\n| Package maintenance | [Install from the sources](#install-from-the-sources) |\n\n## 0-install use\n\n`here-search-demo` notebooks are available in a [Github page][3] hosting a JupyterLite instance. \nThis allows users to not have to install anything.\n\n## Install and try locally\n\nIf you want to use the library and try it through existing notebooks, do:\n\n1. Install the widgets:\n   ```shell\n   uv pip install 'here-search-demo[lab,route]'\n   ```\n   \n2. Grab the notebooks from the [GitHub release asset][12]\n3. Add your [HERE API key][1] to `demo-config.json` file.\n\n## Install from the sources\n\nIf you need to maintain this package:\n\n1. `git clone` it and into a `virtualenv`/`venv`, do:\n   ```shell\n   (cd packages/demo; \n    uv pip install -r \u003c(sort -u requirements/*) -e '.[dev,lab,route]' )\n   ```\n\n2. Copy `demo-config-example.json` to `demo-config.json` and add your [HERE API key][1] to it.\n\n3. Link the virtual environment to a IPython kernel:\n\n   ```shell\n   python -m ipykernel install \\\n     --prefix $(python -c \"import sys; print(sys.prefix)\") \\\n     --name search_demo --display-name \"search demo\"\n   ```\n\n4. Start either\n\n     - JupyterLab:\n       ```shell\n       python -m jupyterlab notebooks\n       ```\n     - or JupyterLite\n       ```shell\n       bash scripts/lite-build.sh\n       ```\n\n\n\n(Additional [notes][2])\n\n## License\n\nCopyright (C) 2022-2026 HERE Europe B.V.\n\nThis project is licensed under the MIT license - see the [LICENSE](./LICENSE) file in the root of this project for license details.\n\n[1]: https://www.here.com/docs/bundle/geocoding-and-search-api-developer-guide/page/topics/quick-start.html#get-an-api-key\n[2]: https://github.com/heremaps/here-search-demo/blob/main/docs/developers.md\n[3]: https://heremaps.github.io/here-search-demo/lab/?path=demo.ipynb\n[4]: https://www.here.com/docs/category/geocoding-search-v7\n[5]: https://www.here.com/get-started/pricing\n\n[6]: https://github.com/heremaps/here-search-demo/actions/workflows/test.yml/badge.svg\n[7]: https://github.com/heremaps/here-search-demo/actions/workflows/test.yml\n[8]: https://codecov.io/gh/heremaps/here-search-demo/branch/main/graph/badge.svg?token=MVFCS4BUFN\n[9]: https://codecov.io/gh/heremaps/here-search-demo\n[11]: https://github.com/heremaps/here-search-demo/raw/main/docs/screenshot.jpg\n[10]: https://jupyterlite.rtfd.io/en/latest/_static/badge.svg\n[12]: https://github.com/heremaps/here-search-demo/releases/latest/download/here-search-demo-notebooks.zip\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheremaps%2Fhere-search-demo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fheremaps%2Fhere-search-demo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheremaps%2Fhere-search-demo/lists"}