gmaps 0.1.5

IPython plugin for Google Maps JavaScript API

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.dataset.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.