cartoload

Convert raster geodata into Garmin GPS raster maps (*.img).

cartoload is an open-source CLI tool and Python library that converts geodata from WMTS or GeoTIFF source into raster maps for Garmin GPS devices. It is the pipeline engine behind the Cartoload service, but is fully usable standalone.

Installation

pip install cartoload

or just run it with uvx

uvx cartoload --help

Quick Start

# Build a layer from example configs
cartoload build \
    --sources examples/configs/sources/swisstopo.yaml \
    --layers examples/configs/layers/switzerland.yaml \
    --layer ch_basemap_25k

Usage as a Library

from cartoload.config import SourceConfig, LayerConfig
from cartoload.pipeline import build_layer

source = SourceConfig(id="my_source", type="wmts", url_template="...")
layer = LayerConfig(id="my_layer", name="My Layer", source="my_source")
output_path = await build_layer(layer, cache_dir="/tmp/cache")

Documentation

Full documentation is available at burgdev.github.io/cartoload.

Development

git clone https://github.com/burgdev/cartoload.git
cd cartoload
uv sync --all-groups
just test

Docker Build

just docker build [--mkgmap]
./cartoload-docker build -c config.yaml -l my_layer          # server image
./cartoload-docker --local build -c config.yaml -l my_layer   # local image
./cartoload-docker --local --mkgmap build ...                  # local mkgmap image

License

LGPL - see LICENSE file.