Skip to main content

Context geo-tiles in Python

Project description

contextily: context geo tiles in Python

contextily is a small Python 3 (3.8 and above) package to retrieve tile maps from the internet. It can add those tiles as basemap to matplotlib figures or write tile maps to disk 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.

Tests codecov Binder


The current tile providers that are available in contextily are the providers defined in the xyzservices package. This includes some popular tile maps, such as:


  • mercantile
  • numpy
  • matplotlib
  • pillow
  • rasterio
  • requests
  • geopy
  • joblib
  • xyzservices


Python 3 only (3.8 and above)

Latest released version, using pip:

pip3 install contextily

or conda:

conda install contextily


contextily is developed by a community of enthusiastic volunteers. You can see a full list here.

If you would like to contribute to the project, have a look at the list of open issues, particularly those labeled as good first contributions.


BSD compatible. See LICENSE.txt

Project details

Download files

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

Source Distribution

contextily-1.4.0.tar.gz (22.5 MB view hashes)

Uploaded source

Built Distribution

contextily-1.4.0-py3-none-any.whl (16.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page