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)
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.
Note that this will install a version of gmaps compatible with IPython 2 and 3. For IPython 4 compatibility, you will have to install the development version.
The development version can be installed by cloning the git repository by running:
$ git clone https://github.com/pbugnion/gmaps.git
The master branch is currently compatible with IPython 4 only. If you are planning on using gmaps with IPython 2 or 3, check out the ipy23 branch with:
$ git checkout ipy23
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
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.
Report issues using the github issue tracker.
Contributions are welcome. Read the CONTRIBUTING guide to learn how to contribute.