MineMap 是一套"二维地图引擎能力 + 三维场景引擎能力"统一 runtime,主入口为 Map。
本技能库按主题拆包,让 AI 编码助手在生成 MineMap 代码时,优先使用源码一致、版本匹配、可直接落地的 API 与模式。
GitHub 源仓库: https://github.com/ming1zhou88/minemap-skills
按需求主题加载对应 SKILL.md:
需求对应技能包初始化地图、控件、生命周期minemap-fundamentals官网入口、账号开通、文档导航minemap-official-resources-and-onboardingkey/solution、域名与资源配置minemap-global-configuration控件体系、自定义控件minemap-widget-and-controlsMarker / Popup / DOM 覆盖物minemap-marker-and-popup图层、Source、样式更新minemap-style-and-data图层系统与渲染顺序minemap-layer-systemstyle v8 结构、setStyle()minemap-style-system二三维叠加、贴地、贴模型minemap-2d-3d-overlay-and-classificationThreeLayer / threejs 融合minemap-threejs-integrationSceneModel / SceneTileset / SceneObjectminemap-scene-components3D Tiles 运行时着色、显隐minemap-3d-tiles-runtime-control模型运行时调试、线框、材质更新minemap-model-runtime-debugPrimitive、几何、材质minemap-primitives-and-materials包围体、碰撞检测、BVHminemap-collision-and-bounding坐标变换与锚点矩阵minemap-transforms数学对象与姿态表达minemap-math-foundations光照、阴影minemap-lighting-and-shadows材质选型与着色minemap-material-system-and-shadingPrimitive 贴地minemap-primitive-adapt-terrain屏幕空间反射(SSR)minemap-screen-space-reflection水面材质、折射/反射minemap-water-surface-and-refraction事件、hover、GPU 拾取minemap-events-and-picking地形、量算、空间分析minemap-terrain-and-analysisWebGL 后端选择、性能实践minemap-performance-and-backend后处理链、描边、雨雪、雾效minemap-post-process-and-render-pipeline抗锯齿与图像质量minemap-anti-aliasing相机限制、近裁剪面、截图minemap-camera-constraints-and-screenshot卷帘对比 Compare 插件minemap-plugin-compare-swipe编辑插件minemap-plugin-editECharts 叠加插件minemap-plugin-echarts-integration在线示例编辑器minemap-plugin-demo-editor视频投影minemap-business-video-projection可视域 / 通视minemap-business-visibility-analysis淹没 / 阴影分析minemap-business-flood-and-shadow漫游 / 跟踪minemap-business-roaming-and-tracking粒子系统与特效minemap-business-particle-and-special-effects北斗网格码minemap-business-beidou-grid行政区划拉伸minemap-business-admin-divisionGaussian Splattingminemap-business-gaussian-splatting倾斜摄影 / BIM / 3D Tiles 装载minemap-business-oblique-bim航线、飞线、流动轨迹minemap-business-airline-and-lines三维量算、贴地面积minemap-business-measurement地形裁剪面minemap-business-spatial-analysis-suite
map.addSceneComponent(),避免继续扩散废弃的 3d-tiles source/layer 写法。load / style.load 后执行,避免时序错误。auto,按 webgpu -> webgl2 -> webgl1 降级,针对特效做能力判断。minemap.SceneModel、 minemap.SceneTileset、 minemap.Primitive 等)而非内部私有对象。minemap-3d-engine@4.23.0source/api/map.js、 source/index.js、 source/style/style.js、 demo/html/*.htmlhtml
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<script src="https://minedata.cn/minemapapi/v4.23.0/minemap.js"></script>
<link href="https://minedata.cn/minemapapi/v4.23.0/minemap.css" rel="stylesheet" />
</head>
<body>
<div id="map" style="width:100%;height:100vh;"></div>
<script>
minemap.key = "YOUR_KEY";
minemap.solution = YOUR_SOLUTION_ID;
minemap.domainUrl = "https://minedata.cn";
const map = new minemap.Map({
container: "map",
style: "minemap://styles/street",
position: [116.39, 39.9, 3000],
pitch: 60,
bearing: 0,
renderBackend: "auto" // auto -> webgpu / webgl2 / webgl1
});
map.on("load", () => {
// 加三维模型
map.addSceneComponent({
id: "building",
type: "3d-model",
data: "https://example.com/building.glb",
position: new minemap.Math.Vector3(116.39, 39.9, 0),
rotation: [90, 0, 0],
scale: [1, 1, 1],
allowPick: true
});
});
</script>
</body>
</html>