IPython plugin for Google Maps JavaScript API
Project description
gmaps is a plugin for including interactive Google maps in the IPython Notebook.
Let’s plot a heatmap of taxi pickups in San Francisco:
In [1]: import gmaps
# load a Numpy array of (latitude, longitude) pairs
In [2]: data = gmaps.datasets.load_dataset('taxi_rides')
In [3]: map = gmaps.heatmap(data)
gmaps.display(map)
Installation
Dependencies
To use gmaps, you will need IPython version 3 or higher. If using IPython 4, you need to install ipywidgets:
$ pip install ipywidgets
Using pip or easy_install
The easiest way to install gmaps is with pip:
$ pip install gmaps
or, if you don’t have pip:
$ easy_install gmaps
You may need to run these commands as root if you are using the system wide Python installation.
Development version
The development version can be installed by cloning the git repository by running:
$ git clone https://github.com/pbugnion/gmaps.git
Change to the project’s root directory and run:
$ python setup.py install
Alternatively, if you are planning on doing development with gmaps, install gmaps in development mode using:
$ python setup.py install_data $ python setup.py develop
Getting started
Currently, only heatmaps are supported. Draw a heatmap by passing a list of (latitude, longitude) pairs to the heatmap command.
There are example notebooks in the examples directory. You can view these on nbviewer, but note that you need to download the notebook to actually see the Google Map.
Issue reporting and contributing
Report issues using the github issue tracker.
Contributions are welcome. Read the CONTRIBUTING guide to learn how to contribute.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.