cschulz/rd13_tile_server
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
rd13_tile_server/docs/adr/002-no-highzoom-no-satellite-build.md

3.7 KiB
Raw Blame History

ADR-002: Kein Selbst-Build für z16-Extrakte und Satelliten-Tiles

Date: 2026-06-13
Status: Accepted

Context

Es wurden zwei Erweiterungen evaluiert:

  1. OSM Vektor-Tiles für Europa/Deutschland bis Zoom 16 Zoom 16 liefert Details wie Hausnummern, Fußwege, einzelne Gebäudeumrisse – deutlich mehr Detail als das vorhandene Planet-MBTiles (z0–14).

  2. Satelliten-Raster-Tiles für den gesamten Planeten Satellitenkarte als zweiter Kartenstil in Kartographer und Home Assistant.

Decision

Beide Optionen werden auf der aktuellen Hardware nicht gebaut (Self-Build ausgeschlossen).

Begründung

z16 Vektor-Europa/Deutschland

Quelle Verfügbar? Anmerkung
OpenFreeMap Download ❌ Nur Planet z0–14
Protomaps PMTiles ❌ Täglich Planet, aber max. z14–15
Geofabrik ❌ Nur OSM-Rohdaten (PBF), keine Tiles
Planetiler Self-Build ❌ ausgeschlossen RAM-Anforderung: ≥16 GB (Europa), ≥64 GB (Planet); Buildzeit: 8–12h Europa

Ergebnis: Kein freier Pre-Build verfügbar. Selbst-Build auf aktueller Hardware nicht möglich.

Satelliten-Planet

Quelle Verfügbar? Anmerkung
Pre-built Planet MBTiles ❌ Kein Anbieter bietet komplettes Planet-Satellit-MBTiles
EOX Sentinel-2 (tile-by-tile) ✅ z0–11 Download via download-satellite.py, ~38 GB, ~24h
EOX Sentinel-2 z12 ⚠️ möglich ~140 GB, 3–5 Tage Download, grenzwertig
EOX Sentinel-2 z13+ ❌ Nicht praktikabel (TB-Bereich)

Ergebnis: Kein Planet-Download verfügbar. Tile-by-tile z0–11 ist die einzige praktikable Option (~38 GB).

Hardware-Einschränkung (dokumentiert)

Die aktuelle Hardware (rd13docker) erfüllt die Mindestanforderungen für Planetiler-Builds nicht:

Anforderung Planetiler Europa Aktuell verfügbar
RAM ≥ 16 GB nicht bekannt / begrenzt
SSD-Temp ≥ 500 GB begrenzt
Buildzeit 8–12h akzeptabel, aber RAM ist Blocker

Diese Einschränkung ist dauerhaft in diesem ADR festgehalten. Kein Agent oder Maintainer soll einen Planetiler-Build auf dieser Hardware starten.

Consequences

Was bleibt

  • Vektor-Planet z0–14 bleibt die Datenbasis (OpenFreeMap, 95 GB, vorhanden)
  • Satelliten-Download z0–11 kann jederzeit gestartet werden (Script vorhanden)

Akzeptierte Einschränkungen

  • Zoom 15–16 (Hausnummern, Einfahrten) nicht verfügbar → akzeptiert
  • Satellitkarte maximal z11 (Stadtebene ohne Straßendetail) → akzeptiert
  • Kein Live-OSM-Update-Zyklus (separat: ADR-001)

Zukunft / Upgrade-Pfad

Falls Hardware aufgerüstet wird (≥ 16 GB RAM, ≥ 500 GB SSD-Temp):

# Deutschland z0-16 (~12 GB Output, ~2h, 8 GB RAM)
docker run --rm -v ./data:/data \
  -e JAVA_TOOL_OPTIONS="-Xmx8g" \
  ghcr.io/onthegomap/planetiler:latest \
  --download --area=germany --output=/data/osm-de.mbtiles

# Europa z0-16 (~80 GB Output, ~12h, 16 GB RAM)
docker run --rm -v ./data:/data \
  -e JAVA_TOOL_OPTIONS="-Xmx16g" \
  ghcr.io/onthegomap/planetiler:latest \
  --download --area=europe --output=/data/osm-eu.mbtiles

Satellit z0–11 (jetzt möglich, Script vorhanden):

SAT_MAX_ZOOM=11 python3 scripts/download-satellite.py data/satellite.mbtiles
# Schätzung: ~38 GB, ~24h bei 8 Threads

References