Use HERE Maps API for JavaScript in your Jupyter Notebook.
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 data on map:
Displaying XYZ Hub or HERE Data Hub space data on a map:
Use ipywidgets controls to build an interactive GUI:
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
pipcommand available to install dependencies - A Node.js installation, 10.13.0+ recommended, with the
npmcommand available to install dependencies - A HERE developer account, free and available under HERE Developer Portal
- An API key from the HERE Developer Portal
In order to be able to use the HERE Maps API for JavaScript with npm the HERE public repository must be added to your npm configuration:
$ npm config set @here:registry https://repo.platform.here.com/artifactory/api/npm/here-node/
Install HERE Map Widget for Jupyter Notebook using the commands below:
$ pip install here-map-widget-for-jupyter
$ jupyter nbextension install --py --sys-prefix here_map_widget
$ jupyter nbextension enable here_map_widget --py --sys-prefix
Install HERE Map Widget for JupyterLab (version 2 or older):
$ jupyter labextension install @jupyter-widgets/jupyterlab-manager @here/map-widget-for-jupyter
For a development installation (requires npm to be pre-installed) run:
$ git clone https://github.com/heremaps/here-map-widget-for-jupyter.git
$ cd here-map-widget-for-jupyter
$ pip install -e .
$ jupyter nbextension install --py --symlink --sys-prefix here_map_widget
$ jupyter nbextension enable --py --sys-prefix here_map_widget
$ jupyter labextension install @jupyter-widgets/jupyterlab-manager js
If you are actively developing your extension, we recommend you build JupyterLab with the command below:
$ jupyter lab --watch
It does take a minute or so to get started, but then hot-reload your JavaScript extension changes. For every change, save your JavaScript and then watch the terminal for an update.
Note on first jupyter lab --watch, you may need to touch a file to get Jupyter Lab to open.
A collection of example notebooks is provided in the /examples directory.
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.