Skip to content

Latest commit

 

History

History
119 lines (68 loc) · 6.23 KB

README.md

File metadata and controls

119 lines (68 loc) · 6.23 KB

HERE Map Widget for Jupyter

Tests PyPI - Status PyPI - Python Version PyPI - Python Version PyPI - License Downloads Conda (channel only) Conda Downloads Anaconda-Server Badge Binder

Use HERE Maps API for JavaScript in your Jupyter Notebook.

Usage

Selecting a basemap:

Select base map

Loading a GeoJSON data on a map:

Use GeoJSON on map

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

Add marker to map

Using the search control to search GeoJSON layer data:

Add search control to map

Displaying GeoPandas data on map:

Add Geopandas data to map

Displaying XYZ Hub or HERE Data Hub space data on a map:

Add XYZ data to map

Use ipywidgets controls to build an interactive GUI:

Add ipywidgets controls

Selecting external basemaps:

Select external basemap

Prerequisites

Before you can install this package, or use the example notebooks to make sure your system meets the following prerequisities:

Installation

Install HERE Map Widget for Jupyter with conda from the Anaconda conda-forge channel using the below command:

$ conda install -c conda-forge here-map-widget-for-jupyter

Install HERE Map Widget for Jupyter from PyPI 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

Related projects

Below projects use here-map-widget-for-jupyter as plotting backend

License

Copyright (C) 2019-2021 HERE Europe B.V.

Unless otherwise noted in LICENSE files for specific directories, the LICENSE in the root applies to all content in this repository.