Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/heremaps/here-map-widget-for-jupyter
Use HERE Maps API for JavaScript in your Jupyter Notebook.
https://github.com/heremaps/here-map-widget-for-jupyter
here heremaps jupyter-notebook maps python widget
Last synced: 5 days ago
JSON representation
Use HERE Maps API for JavaScript in your Jupyter Notebook.
- Host: GitHub
- URL: https://github.com/heremaps/here-map-widget-for-jupyter
- Owner: heremaps
- License: mit
- Created: 2020-12-17T09:25:59.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2024-11-28T03:29:49.000Z (3 months ago)
- Last Synced: 2025-02-06T04:34:27.043Z (13 days ago)
- Topics: here, heremaps, jupyter-notebook, maps, python, widget
- Language: JavaScript
- Homepage: https://here-map-widget-for-jupyter.readthedocs.io/en/latest/
- Size: 39.3 MB
- Stars: 39
- Watchers: 8
- Forks: 8
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.rst
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# HERE Map Widget for Jupyter

[](https://pypi.org/project/here-map-widget-for-jupyter/)
[](https://pypi.org/project/here-map-widget-for-jupyter/)
[](https://pypi.org/project/here-map-widget-for-jupyter/)
[](https://pypi.org/project/here-map-widget-for-jupyter/)
[](https://pepy.tech/project/here-map-widget-for-jupyter)
[](https://anaconda.org/conda-forge/here-map-widget-for-jupyter)
[](https://anaconda.org/conda-forge/here-map-widget-for-jupyter)
[](https://anaconda.org/conda-forge/here-map-widget-for-jupyter)
[](https://mybinder.org/v2/gh/heremaps/here-map-widget-for-jupyter/master?urlpath=lab/tree/examples)Use [HERE Maps API for JavaScript](https://developer.here.com/develop/javascript-api) in your [Jupyter Notebook](https://jupyter.org/).
## Usage
### Selecting a basemap:

### Loading a GeoJSON data on a map:

### Making use of HERE Maps API for JavaScript primitives such as Marker to draw a SVG icon on the map:

### Using the search control to search GeoJSON layer data:

### Displaying [GeoPandas](https://geopandas.org/) data on map:

### Displaying [XYZ Hub](https://github.com/heremaps/xyz-hub) or [HERE Data Hub](https://developer.here.com/products/data-hub) space data on a map:

### Use [ipywidgets](https://ipywidgets.readthedocs.io/) controls to build an interactive GUI:

### Selecting external basemaps:
## Prerequisites
Before you can install this package, or use the example notebooks to make sure your system meets the following prerequisities:
- A Python installation, 3.6+ recommended, with the `pip` command available to install dependencies
- A HERE developer account, free and available under [HERE Developer Portal](https://developer.here.com)
- An [API key](https://developer.here.com/documentation/identity-access-management/dev_guide/topics/dev-apikey.html) from the [HERE Developer Portal](https://developer.here.com)## Installation
Install HERE Map Widget for Jupyter with conda from the Anaconda [conda-forge channel](https://anaconda.org/conda-forge/here-map-widget-for-jupyter) using the below command:
$ conda install -c conda-forge here-map-widget-for-jupyter
Install HERE Map Widget for Jupyter from [PyPI](https://pypi.org/project/here-map-widget-for-jupyter/) using the below command:
$ pip install here-map-widget-for-jupyter
Below extra commands are required only if you are using classic Jupyter Notebook (version 5.3 or older):
$ jupyter nbextension install --py --sys-prefix here_map_widget
$ jupyter nbextension enable here_map_widget --py --sys-prefix
Below extra commands are required only if you are using JupyterLab (version 2 or older):
$ npm config set @here:registry https://repo.platform.here.com/artifactory/api/npm/here-node/
$ jupyter labextension install @jupyter-widgets/jupyterlab-manager @here/map-widget-for-jupyter
### Installation from source repository on GitHub
For a development installation (requires yarn, you can install it with `conda install -c conda-forge yarn`):
$ npm config set @here:registry https://repo.platform.here.com/artifactory/api/npm/here-node/
$ git clone https://github.com/heremaps/here-map-widget-for-jupyter.git
$ cd here-map-widget-for-jupyter
$ pip install -e .If you are using the classic Jupyter Notebook you need to install the nbextension:
$ jupyter nbextension install --py --sys-prefix here_map_widget
$ jupyter nbextension enable here_map_widget --py --sys-prefix
Note for developers:
- the ``-e`` pip option allows one to modify the Python code in-place. Restart the kernel in order to see the changes.
- the ``--symlink`` argument on Linux or OS X allows one to modify the JavaScript code in-place. This feature is not available with Windows.For developing with JupyterLab:
$ jupyter labextension develop --overwrite here_map_widget
## Documentation
Documentation is available [here](https://here-map-widget-for-jupyter.readthedocs.io/en/latest/)
## Related projects
Below projects use `here-map-widget-for-jupyter` as plotting backend
- [leafmap](https://github.com/giswqs/leafmap)
- [HERE Inspector](https://developer.here.com/documentation/sdk-python-v2/dev_guide/topics/usage/here-inspector.html) package of [HERE Data SDK for Python v2](https://developer.here.com/documentation/sdk-python-v2/dev_guide/index.html)## License
Copyright (C) 2019-2021 HERE Europe B.V.
Unless otherwise noted in `LICENSE` files for specific directories, the [LICENSE](https://github.com/heremaps/here-map-widget-for-jupyter/raw/master/LICENSE) in the root applies to all content in this repository.