gmaps 0.1.1

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 (data taken from the Google maps API documentation):

In [1]: import gmaps

In [2]: data = [ [ 37.782, -122.447 ], # [ latitude, longitude ] pairs
                 [ 37.782, -122.445 ],
                 [ 37.782, -122.443 ],
                 [ 37.782, -122.441 ],
                 [ 37.782, -122.439 ],
                 [ 37.782, -122.437 ] ]
        map = gmaps.heatmap(data)
        gmaps.display(map)

Installation

gmaps can only be installed from source. Clone 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

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. The heatmap example is also visible 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.