MapStage은(는) 무엇을 하나요?
MapStage 장면을 구축하거나 튜닝할 때 이 기술을 사용하세요: 지도/지구본 투영, 위성, 고저차 음영, Mapterhorn 지형, 지역 분리, CSS 색상 보정, JSON 내보내기.
사용 시기
- 라이브 MapStage 튜너가 필요한 경우 (지도 대 지구본, 위성 대 음영, 분리).
- 페인트/CSS/카메라를 고정한 후 JSON을 다른 호스트로 내보내야 하는 경우.
- 계층화된 정착지(
capital/large/medium/small/pass/station/ordos)가 필요한 경우.
튜너 페이지를 최종 렌더링 호스트로 사용하지 마십시오.
모드
| 모드 | 목적 |
|---|---|
| 프로덕션 스택 | 앱에 MapStage를 내장: 선택적 위성/래스터 + Mapterhorn DEM (encoding: 'terrarium') + 언덕 음영 + OpenFreeMap 벡터 워터 + CSS 필터 + 도시 돌출. 내보낸 JSON으로 모양을 제어합니다. |
| 튜너 | tuner/ 아래의 로컬 HTTP 페이지: 슬라이더, 투영, 분리, 프리셋 로드/내보내기. |
워크플로우
- 튜너 제공:
cd tuner && python -m http.server 8765→http://localhost:8765/ - 타일: 기본 EOX Sentinel-2 클라우드리스 + Mapterhorn (
tuner/map-tiles.config.js). gitignore된map-tiles.config.local.js로 재정의 가능. - 기본 프리셋
tuner/preset-antique-default.json적용 (tuner/presets/antique-default.json과 동일). - 모양이 고정될 때까지 투영/위성/음영/분리/CSS/도시 조정.
- 튜너에서 JSON 내보내기 (복사 또는 다운로드).
- 페인트 + 카메라 + CSS 필드를 프로덕션 MapStage 장면으로 마이그레이션 (참조 문서 참조).
- 프로덕션에서:
jumpTo카메라;idle대기; 선택적으로 타일 사전 캐시. 녹화된 프레임의 경우easeTo/flyTo를 피하십시오. - 항상 **
encoding: 'terrarium'**으로 DEM을 설정하십시오. 잘못된 인코딩은 언덕 음영/지형을 망가뜨립니다. - 최종 프레임은 프로덕션 호스트에서 렌더링됩니다 — 튜너 UI에서가 아닙니다.
엄격한 규칙
- 타일이 번들되지 않음 — MapStage는 런타임에 설정된 URL에서만 DEM과 베이스맵을 가져옵니다.
- 사용이 허가된 베이스맵 엔드포인트만 사용하십시오 — 기본값은 공개 데모 타일(EOX)입니다. 필요시 설정을 통해 교체하십시오.
- 지형 소스의
encoding: 'terrarium'— 필수. - 녹화된 프로덕션 경로에서
easeTo/flyTo사용 금지;jumpTo+idle을 선호하십시오. - 튜너에서 최종 렌더링을 호스팅하지 마십시오.
- 워터는 내장된 OpenFreeMap / OpenMapTiles 벡터 레이어입니다.
tuner/assets/water-data.js를 기대하거나 커밋하지 마십시오.
참조
references/参数列表说明.md— 매개변수 테이블 + 기본값references/tested-config.md— 소스, 레이어 순서, jumpTo + idlereferences/tuner-workflow.md— HTTP 튜너 → 내보내기 → 프로덕션references/city-tier-schema.md— 정착지 계층schemas/map-preset.schema.jsonschemas/sample-sites.schema.jsontuner/— 라이브 페이지, 검증 스크립트, 기본 프리셋, 샘플 사이트
에이전트
표시 이름/기본 프롬프트는 agents/openai.yaml를 참조하십시오.