contextily: context geo tiles in Python

contextily is a small Python 3 package to retrieve and write to disk tile maps from the internet into geospatial raster files. Bounding boxes can be passed in both WGS84 (EPSG:4326) and Spheric Mercator (EPSG:3857). See the notebook contextily_guide.ipynb for usage.

Tiles

• Toner and Terrain map tiles by Stamen Design, under CC BY 3.0. Data by OpenStreetMap, under ODbL.

• Watercolor map tiles by Stamen Design, under CC BY 3.0. Data by OpenStreetMap, under CC BY SA.

Dependencies

• mercantile

• numpy

• matplotlib

• pillow

• rasterio

• requests

• geopy

• joblib

Installation

Python 3 only

Latest released version:

pip3 install contextily # installs the latest released version (v0.99.0)

Latest release candidate (includes functionality such as add_basemap coming in version 1.0:

pip3 install contextily==1.0rc2 # installs the latest release candidate (v1.0rc2)

Contributors

• Dani Arribas-Bel (`@darribas <http://twitter.com/darribas>`__)

• Joris Van den Bossche `@jorisvandenbossche <https://twitter.com/jorisvdbossche>`__)

• Levi Wolf (`@levijohnwolf <https://twitter.com/levijohnwolf>`__)

• Chris Holdgraf (`@choldgraf <http://twitter.com/choldgraf>`__)

• Filipe Fernandes ([@ocefpaf](http://twitter.com/ocefpaf))

License

BSD compatible. See LICENSE.txt

Contents:

• contextily
  • Simplified plotting
  • Download tiles
  • Save tiles into raster files
  • Search for tiles with text
  • Read raster tiles and combine with vector data
  • Combine layers
  • Different backgrounds
• Tests for warping functionality
• Reference Guide
  • Plotting basemaps
  • Working with tiles
  • Geocoding and plotting places

Indices and tables

• Index

• Module Index

• Search Page

contextily