MapStage

O que MapStage faz?

Use esta habilidade ao construir ou ajustar uma cena do MapStage: projeção de mapa/globo, satélite, relevo hipsométrico, terreno Mapterhorn, isolamento de região, gradação de cores CSS e exportação JSON.

Quando usar

• Precisa de um sintonizador MapStage ao vivo (mapa vs globo, satélite vs relevo, isolamento).
• Precisa fixar pintura / CSS / câmera e, em seguida, exportar JSON para outro host.
• Precisa de hierarquia de assentamentos (capital / large / medium / small / pass / station / ordos).

Não use a página do sintonizador como host de renderização final.

Modos

Modo	Propósito
Pilha de produção	Incorpore o MapStage no seu aplicativo: satélite/raster opcional + DEM Mapterhorn (encoding: 'terrarium') + sombreamento de relevo + água vetorial OpenFreeMap + filtro CSS + extrusões de cidade. Controle a aparência a partir do JSON exportado.
Sintonizador	Página HTTP local em tuner/ para controles deslizantes, projeção, isolamento, carregar/exportar predefinições.

Fluxo de trabalho

1. Sirva o sintonizador: cd tuner && python -m http.server 8765 → http://localhost:8765/
2. Tiles: padrão EOX Sentinel-2 sem nuvens + Mapterhorn (tuner/map-tiles.config.js). Substitua por map-tiles.config.local.js (ignorado pelo git).
3. Aplique a predefinição padrão tuner/preset-antique-default.json (mesmo que tuner/presets/antique-default.json).
4. Ajuste projeção / satélite / relevo / isolamento / CSS / cidades até que a aparência esteja definida.
5. Exporte JSON do sintonizador (copie ou baixe).
6. Migre os campos de pintura + câmera + CSS para a cena MapStage de produção (consulte as referências).
7. Em produção: jumpTo na câmera; aguarde idle; opcionalmente pré-carregue tiles. Evite easeTo / flyTo para quadros gravados.
8. Sempre configure o DEM com encoding: 'terrarium'. A codificação errada quebra o sombreamento/terreno.
9. Os quadros finais são renderizados a partir do host de produção — não da interface do sintonizador.

Regras rígidas

• Tiles não incluídos — MapStage busca DEM e mapa base em tempo real apenas a partir de URLs configuradas.
• Use apenas endpoints de mapa base que você tem permissão para usar — os padrões são tiles de demonstração públicos (EOX); troque via configuração quando necessário.
• encoding: 'terrarium' na fonte de terreno — obrigatório.
• Sem easeTo / flyTo em caminhos de produção gravados; prefira jumpTo + idle.
• Não hospede a renderização final no sintonizador.
• Água são as camadas vetoriais integradas OpenFreeMap / OpenMapTiles. Não espere nem envie tuner/assets/water-data.js.

Referências

• references/参数列表说明.md — tabelas de parâmetros + padrões
• references/tested-config.md — fontes, ordem de camadas, jumpTo + idle
• references/tuner-workflow.md — sintonizador HTTP → exportação → produção
• references/city-tier-schema.md — hierarquia de assentamentos
• schemas/map-preset.schema.json
• schemas/sample-sites.schema.json
• tuner/ — página ao vivo, script de verificação, predefinição padrão, locais de exemplo

Agentes

Consulte agents/openai.yaml para nome de exibição / prompt padrão.