102 lines
3.7 KiB
Markdown
102 lines
3.7 KiB
Markdown
# 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):
|
||
|
||
```bash
|
||
# 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):
|
||
```bash
|
||
SAT_MAX_ZOOM=11 python3 scripts/download-satellite.py data/satellite.mbtiles
|
||
# Schätzung: ~38 GB, ~24h bei 8 Threads
|
||
```
|
||
|
||
## References
|
||
|
||
- [ADR-001: Martin + tileserver-gl Stack](001-martin-tileserver-gl-stack.md)
|
||
- [OpenFreeMap Downloads](https://openfreemap.org) – nur Planet z0–14
|
||
- [Protomaps Builds](https://maps.protomaps.com/builds/) – nur Planet z0–14/15
|
||
- [EOX Sentinel-2 cloudless](https://s2maps.eu) – tile-by-tile via Script
|
||
- [Planetiler Hardware Requirements](https://github.com/onthegomap/planetiler)
|