Skip to main content

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)


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

Change to the project’s root directory and run:

$ python install

Alternatively, if you are planning on doing development with gmaps, install gmaps in development mode using:

$ python install_data
$ python 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.

Release history Release notifications | RSS feed

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions (108.7 kB view hashes)

Uploaded source

gmaps-0.1.6.tar.gz (98.8 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page