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)
        gmaps.display(map)

Installation

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.

Release history Release notifications

This version
History Node

0.1.6

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
gmaps-0.1.6.tar.gz (98.8 kB) Copy SHA256 hash SHA256 Source None Dec 8, 2014
gmaps-0.1.6.zip (108.7 kB) Copy SHA256 hash SHA256 Source None Dec 8, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page