<div align="center"> <img src="docs/source/_static/favicon.png" alt="cartes logo" width="200"/> </div>

Cartes

Cartes is a Python library providing facilities to produce meaningful maps.

Cartes builds on top of most common Python visualisation libraries (Matplotlib/Cartopy, Altair, ipyleaflet) and data manipulation libraries (Pandas, Geopandas) and provides mostly:

• a comprehensive set of geographic projections, built on top of Cartopy and Altair/d3.js;
• an interface to OpenstreetMap Nominatim and Overpass API. Result of requests are parsed in a convenient format for preprocessing and storing in standard formats;
• beautiful default parameters for quality visualisations;
• advanced caching facilities. Do not download twice the same content in the same day.

The cartes library is a powerful asset to publish clean, lightweight geographical datasets; and to produce decent geographical visualisations in few lines of code.

Gallery

<a href="https://cartes-viz.github.io/gallery/mercantour.html"><img width="20%" src="https://cartes-viz.github.io/_static/homepage/mercantour.png"></a> <a href="https://cartes-viz.github.io/gallery/footprint.html"><img width="20%" src="https://cartes-viz.github.io/_static/homepage/antibes.png"></a> <a href="https://cartes-viz.github.io/gallery/airports.html"><img width="20%" src="https://cartes-viz.github.io/_static/homepage/airports.png"></a> <a href="https://cartes-viz.github.io/gallery/tokyo_metro.html#zoom-in-to-downtown-tokyo"><img width="20%" src="https://cartes-viz.github.io/_static/homepage/tokyo.png"></a>

More in the documentation

Installation

Latest release:

Recommended for beginners, with conda:

conda install -c conda-forge cartes

or with pip:

pip install cartes

Development version, with uv:

git clone https://github.com/xoolive/cartes
cd cartes
uv sync --dev

Documentation

Documentation available at https://cartes-viz.github.io/