smopy

OpenStreetMap image tiles in Python


Keywords
openstreetmap, matplotlib, map, maps, ipython
License
BSD-3-Clause
Install
pip install smopy==0.0.8

Documentation

Smopy

New: you may be interested in Folium for interactive maps with Leaflet.js

Give a box in geographical coordinates (latitude/longitude) and a zoom level, Smopy returns an OpenStreetMap tile image!

import smopy
map = smopy.Map((42., -1., 55., 3.), z=4)
map.show_ipython()

Europe map

You can also import the map in matplotlib and convert from geographical coordinates to pixels easily.

x, y = map.to_pixels(48.86151, 2.33474)
ax = map.show_mpl(figsize=(8, 6))
ax.plot(x, y, 'or', ms=10, mew=2);

Europe map

Alternative OSM tile servers can be used as well. An example is in the example notebook.

See the example notebook

Installation

Smopy currently requires:

  • Pillow
  • NumPy
  • matplotlib
  • IPython (optional)

To install Smopy run pip install smopy.

For IPython support run pip install smopy[ipython].

To install Smopy directly from the repository run:

git clone git@github.com:rossant/smopy.git
cd smopy
python setup.py develop

Terms of use

This module fetches image maps from OpenStreetMap's servers. See the usage policy. In particular, be careful not to retrieve large maps as this can overload the servers.