MapStage

Was macht MapStage?

Nutze diese Fähigkeit beim Erstellen oder Optimieren einer MapStage-Szene: Karten-/Globusprojektion, Satellit, hypsometrische Reliefdarstellung, Mapterhorn-Gelände, Regionsisolierung, CSS-Farbkorrektur und JSON-Export.

Wann verwenden

• Benötigen Sie einen Live-Tuner für MapStage (Karte vs. Globus, Satellit vs. Relief, Isolierung).
• Müssen Sie Farbe / CSS / Kamera festlegen und dann JSON in einen anderen Host exportieren.
• Benötigen Sie gestaffelte Siedlungen (capital / large / medium / small / pass / station / ordos).

Verwenden Sie die Tuner-Seite nicht als endgültige Render-Umgebung.

Modi

Modus	Zweck
Produktionsstack	Betten Sie MapStage in Ihre App ein: optionales Satelliten-/Raster + Mapterhorn DEM (encoding: 'terrarium') + Bergschattierung + OpenFreeMap-Vektor-Wasser + CSS-Filter + Stadtextrusionen. Steuern Sie das Aussehen über exportiertes JSON.
Tuner	Lokale HTTP-Seite unter tuner/ für Schieberegler, Projektion, Isolierung, Laden/Exportieren von Voreinstellungen.

Arbeitsablauf

1. Tuner starten: cd tuner && python -m http.server 8765 → http://localhost:8765/
2. Kacheln: Standard EOX Sentinel-2 wolkenlos + Mapterhorn (tuner/map-tiles.config.js). Überschreiben mit gitignoriertem map-tiles.config.local.js.
3. Standard-Voreinstellung anwenden tuner/preset-antique-default.json (identisch mit tuner/presets/antique-default.json).
4. Projektion / Satellit / Relief / Isolierung / CSS / Städte anpassen, bis das Aussehen stimmt.
5. JSON exportieren aus dem Tuner (kopieren oder herunterladen).
6. Migrieren Sie Paint + Kamera + CSS-Felder in die MapStage-Produktionsszene (siehe Referenzen).
7. In der Produktion: jumpTo Kamera; auf idle warten; optional Kacheln vorab cachen. Vermeiden Sie easeTo / flyTo für aufgezeichnete Frames.
8. Setzen Sie das DEM immer mit encoding: 'terrarium'. Eine falsche Kodierung bricht die Bergschattierung/das Gelände.
9. Endgültige Frames werden vom Produktionshost gerendert — nicht von der Tuner-Oberfläche.

Harte Regeln

• Kacheln nicht gebündelt — MapStage ruft DEM und Basiskarte zur Laufzeit nur von konfigurierten URLs ab.
• Verwenden Sie nur Basiskarten-Endpunkte, die Sie nutzen dürfen — Standard sind öffentliche Demo-Kacheln (EOX); bei Bedarf über Konfiguration austauschen.
• encoding: 'terrarium' auf der Geländequelle — zwingend erforderlich.
• Kein easeTo / flyTo in aufgezeichneten Produktionspfaden; stattdessen jumpTo + idle bevorzugen.
• Hosting der finalen Darstellung nicht auf dem Tuner.
• Wasser sind die integrierten OpenFreeMap / OpenMapTiles Vektorebenen. Erwarten oder committen Sie keine tuner/assets/water-data.js.

Referenzen

• references/参数列表说明.md — Parametertabellen + Standardwerte
• references/tested-config.md — Quellen, Ebenenreihenfolge, jumpTo + idle
• references/tuner-workflow.md — HTTP-Tuner → Export → Produktion
• references/city-tier-schema.md — Siedlungsstufen
• schemas/map-preset.schema.json
• schemas/sample-sites.schema.json
• tuner/ — Live-Seite, Verifikationsskript, Standard-Voreinstellung, Beispielseiten

Agents

Siehe agents/openai.yaml für Anzeigename / Standard-Prompt.