Contextily

Contextily now uses OpenStreetMap Humanitarian as the default tiles due to [Stamen moving under Stadia](https://maps.stamen.com/stadia-partnership/) and requiring an API key.

What's Changed
* Fix bug in auto computation of zoom levels by jelson in https://github.com/geopandas/contextily/pull/214
* Added support for parallel tile downloads and control of cache by JacobJeppesen in https://github.com/geopandas/contextily/pull/217
* Bump actions/checkout from 3 to 4 by dependabot in https://github.com/geopandas/contextily/pull/219
* Use OpenStreetMap.HOT as default tiles by martinfleis in https://github.com/geopandas/contextily/pull/221
* MAINT: update infrastructure by martinfleis in https://github.com/geopandas/contextily/pull/222

New Contributors
* jelson made their first contribution in https://github.com/geopandas/contextily/pull/214
* JacobJeppesen made their first contribution in https://github.com/geopandas/contextily/pull/217

**Full Changelog**: https://github.com/geopandas/contextily/compare/v1.3.0...v1.4.0

This is a minor release adding more flexible querying of tile services, to bring it on par and in line with the API in `GeoDataFrame.explore` (added in 208 , thanks martinfleis!!!). In addition, a few updates and bug fixes are also included.

This is a minor release that does not add any new user functionality but switches the backend of tile providers from the original built-in one to that provided by [`XYZservices`](https://github.com/geopandas/xyzservices). In addition, the following changes and fixes are included:

- More documentation for the `Place` API (180, thanks to chrstnbwnkl )
- Update docs website to render it fully functional (175, thanks to jorisvandenbossche )
- Update of tests to accommodate changes in Stament tiles

This is a release adds functionality for overlay tiles that have transparency (e.g. to add labels only) and includes a few bug fixes along the way.

New functionality:

- Map tile overlays (114): see [new section](https://contextily.readthedocs.io/en/latest/intro_guide.html#Using-transparent-layers) added to documentation for the feature. This feature was contributed by jpn-- (thanks!)

Bug fixes:

- Documentation website bug fixed so side bar navigation is visible 168

Small bug fix release:

* Fix bug (and potential segfault) in the warping of tiles using rasterio (159, 160, 163, 165).
* Fix bug in resetting the extent when warping local tiles (155, 156) .
* Improved documentation, see https://contextily.readthedocs.io/en/latest/

This is the 1.0 release, bringing a stable API to the library and a first set of basic functionality available to end users.

Besides all the changes introduced initially in the previous two release candidates (`rc1` and [`rc2`](https://github.com/geopandas/contextily/releases/tag/v1.0rc2)), the following features have been added:

* Support for memory-efficient, window-based reading from local files (86).
* The `url` keyword is deprecated in favor of `source` (90, 125).
* The `zoom` level is now validated if the minimum and maximum zoom of the provider is known (108).
* Optionally set cache directory to a permanent directory with `set_cache_dir` (106).

The project has also graduated from an individual account ([`darribas`](https://github.com/darribas/contextily/)) to an organisational one, kindly hosted by the `geopandas` project:

> [`https://github.com/geopandas/contextily/`](https://github.com/geopandas/contextily/)

This is to better reflect the broader community involved in the development of the project, as well as to increase its visibility. Issues and Pull Requests should be directed at `contextily`'s new home.

Documentation

A new documentation site has been created and made available at:

> [`https://contextily.readthedocs.io/en/latest/`](https://contextily.readthedocs.io/en/latest/)

Installation

You can install `contextily` through pip:


pip install contextily


Or conda:


conda install -c conda-forge contextily


Contributors

A full list of contributors to the project is available [here](https://github.com/geopandas/contextily/graphs/contributors).