https://github.com/geopandas/contextily

Context geo-tiles in Python
https://github.com/geopandas/contextily

cartography geography mapping matplotlib openstreetmap osm python stamen stamen-maps tile tiles webtiles

Last synced: 6 days ago
JSON representation

Context geo-tiles in Python

• Host: GitHub
• URL: https://github.com/geopandas/contextily
• Owner: geopandas
• License: bsd-3-clause
• Created: 2016-09-08T16:03:34.000Z (over 8 years ago)
• Default Branch: main
• Last Pushed: 2024-11-18T07:57:23.000Z (2 months ago)
• Last Synced: 2025-01-10T20:38:26.028Z (11 days ago)
• Topics: cartography, geography, mapping, matplotlib, openstreetmap, osm, python, stamen, stamen-maps, tile, tiles, webtiles
• Language: Jupyter Notebook
• Homepage: https://contextily.readthedocs.io/en/latest/
• Size: 58.5 MB
• Stars: 534
• Watchers: 18
• Forks: 84
• Open Issues: 38
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# `contextily`: context geo tiles in Python

`contextily` is a small Python 3 (3.9 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](https://github.com/geopandas/contextily/actions/workflows/tests.yaml/badge.svg)](https://github.com/geopandas/contextily/actions/workflows/tests.yaml)

[![codecov](https://codecov.io/gh/geopandas/contextily/branch/main/graph/badge.svg?token=5Eu3L1peBb)](https://codecov.io/gh/geopandas/contextily)

[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/geopandas/contextily/main?urlpath=lab/tree/notebooks/intro_guide.ipynb)

![Tiles](tiles.png)

The current tile providers that are available in contextily are the providers

defined in the [`xyzservices`](https://xyzservices.readthedocs.io)

package. This includes some popular tile maps, such as:

* The standard [OpenStreetMap](http://openstreetmap.org) map tiles

* Toner, Terrain and Watercolor map tiles by [Stamen Design](http://stamen.com)

## Dependencies

* `mercantile`

* `numpy`

* `matplotlib`

* `pillow`

* `rasterio`

* `requests`

* `geopy`

* `joblib`

* `xyzservices`

## Installation

**Python 3 only** (3.9 and above)

[Latest released version](https://github.com/geopandas/contextily/releases/), using pip:

```sh

pip3 install contextily

```

or conda:

```sh

conda install contextily

```

## Contributors

`contextily` is developed by a community of enthusiastic volunteers. You can see a full list [here](https://github.com/geopandas/contextily/graphs/contributors).

If you would like to contribute to the project, have a look at the list of [open issues](https://github.com/geopandas/contextily/issues), particularly those labeled as [good first contributions](https://github.com/geopandas/contextily/issues?q=is%3Aissue+is%3Aopen+label%3Agood-first-contribution).

## License

BSD compatible. See `LICENSE.txt`