hopechen067/MapStage

Que fait MapStage ?

Utilisez cette compétence lors de la construction ou de l'ajustement d'une scène MapStage : projection carte/globe, satellite, relief hypsométrique, terrain Mapterhorn, isolement de région, calque CSS et export JSON.

Quand l'utiliser

• Besoin d'un ajusteur en direct MapStage (carte vs globe, satellite vs relief, isolement).
• Besoin de verrouiller la peinture / CSS / caméra, puis d'exporter le JSON vers un autre hôte.
• Besoin de peuplements hiérarchisés (capital / large / medium / small / pass / station / ordos).

N'utilisez pas la page d'ajustement comme hôte de rendu final.

Modes

Mode	Objectif
Pile de production	Intégrez MapStage dans votre application : option satellite/raster + Mapterhorn DEM (encoding: 'terrarium') + ombrage + vecteur eau OpenFreeMap + filtre CSS + extrusions urbaines. Pilotez l'apparence via le JSON exporté.
Ajusteur	Page HTTP locale sous tuner/ pour les curseurs, la projection, l'isolement, le chargement/export de préréglages.

Workflow

1. Servir l'ajusteur : cd tuner && python -m http.server 8765 → http://localhost:8765/
2. Tuiles : par défaut EOX Sentinel-2 sans nuage + Mapterhorn (tuner/map-tiles.config.js). Surcharger avec map-tiles.config.local.js (ignoré par git).
3. Appliquer le préréglage par défaut tuner/preset-antique-default.json (identique à tuner/presets/antique-default.json).
4. Ajuster la projection / satellite / relief / isolement / CSS / villes jusqu'à ce que l'apparence soit verrouillée.
5. Exporter le JSON depuis l'ajusteur (copier ou télécharger).
6. Migrer les champs peinture + caméra + CSS vers la scène MapStage de production (voir références).
7. En production : jumpTo caméra ; attendre idle ; éventuellement pré-mettre en cache les tuiles. Évitez easeTo / flyTo pour les images enregistrées.
8. Toujours définir le MNT avec encoding: 'terrarium'. Un mauvais encodage casse l'ombrage/le terrain.
9. Les images finales sont rendues depuis l'hôte de production — pas depuis l'interface de l'ajusteur.

Règles strictes

• Tuiles non groupées — MapStage récupère le MNT et le fond de carte à l'exécution uniquement à partir des URL configurées.
• Utilisez uniquement les points d'accès de fond de carte que vous êtes autorisé à utiliser — les valeurs par défaut sont des tuiles de démonstration publiques (EOX) ; échangez via la configuration si nécessaire.
• encoding: 'terrarium' sur la source de terrain — obligatoire.
• Pas de easeTo / flyTo dans les chemins de production enregistrés ; préférez jumpTo + idle.
• N'hébergez pas le rendu final sur l'ajusteur.
• L'eau correspond aux couches vectorielles intégrées OpenFreeMap / OpenMapTiles. N'attendez pas et ne validez pas tuner/assets/water-data.js.

Références

• references/参数列表说明.md — tableaux de paramètres + valeurs par défaut
• references/tested-config.md — sources, ordre des couches, jumpTo + idle
• references/tuner-workflow.md — ajusteur HTTP → export → production
• references/city-tier-schema.md — hiérarchies de peuplements
• schemas/map-preset.schema.json
• schemas/sample-sites.schema.json
• tuner/ — page en direct, script de vérification, préréglage par défaut, sites d'exemple

Agents

Voir agents/openai.yaml pour le nom d'affichage / l'invite par défaut.