MapV-Three 开发指南
使用 MapV-Three 构建高性能的 3D 地图和 GIS 应用 - 一个采用 Z-up 坐标系的跨浏览器 WebGL 库。
何时适用
在以下场景中参考这些指南：
- 3D 地图编辑和要素绘制
- 地图测量工具开发
- 建筑物、区域等 3D 可视化
- 实时交通数据展示
- 路径追踪动画开发
快速参考
0. 核心引擎
reference/engine.md- Engine 引擎核心：初始化、场景管理、渲染控制reference/initialization.md- 引擎初始化、资源配置、百度地图适配器
1. 数据管理
reference/datasource.md- DataSource 数据源基类reference/datasource/geojson-datasource.md- GeoJSON 数据源reference/datasource/json-datasource.md- JSON 数据源reference/datasource/csv-datasource.md- CSV 数据源reference/datasource/dataitem.md- DataItem 数据项
2. 点对象与标签
reference/simple-point.md- SimplePoint 简单点reference/effect-point.md- EffectPoint 特效点（Fan、Bubble、Wave、Breath、Radar 等）reference/marker-types.md- 标记类型（Icon、BallonPoint、DOMPoint、EffectModelPoint）reference/circle.md- Circle 圆形（屏幕空间渲染）reference/label.md- Label 文本/图标标签reference/text.md- Text 文本组件reference/cluster.md- ClusterPoint 点聚合
3. 线与面
reference/polyline.md- Polyline 折线（flat 参数控制渲染模式）reference/simple-line.md- SimpleLine 简单线reference/wall.md- Wall 墙体/围栏reference/polygon.md- Polygon 多边形reference/pillar.md- Pillar 柱体
4. 覆盖物
reference/marker.md- Marker 标记reference/popup.md- Popup 弹出窗口reference/dom-overlay.md- DOMOverlay DOM 覆盖物
5. 追踪器
reference/tracker.md- 追踪器总览与生命周期reference/path-tracker.md- PathTracker 路径追踪reference/object-tracker.md- ObjectTracker 对象追踪reference/orbit-tracker.md- OrbitTracker 轨道追踪
6. 编辑与测量
reference/editor.md- Editor 编辑器reference/measure.md- Measure 测量工具
7. 3D 模型
reference/model.md- 3D 模型加载（SimpleModel/AnimationModel/LODModel）reference/twin.md- Twin 孪生车流（实时车流可视化、DataProvider 数据处理）reference/mock-twin.md- MockTwin 模拟车流（基于路线数据的车流模拟生成）
8. 材质与特效
reference/materials.md- 材质系统（WaterMaterial、ExtendMeshStandardMaterial 等）reference/easing-function.md- 缓动函数（LINEAR、QUINTIC_IN_OUT、CUBIC_OUT）
9. 天空与天气
reference/sky-weather.md- 天空系统（EmptySky/DynamicSky/StaticSky）和天气
10. 热力图
reference/heatmap.md- Heatmap 热力图
11. 地图图层加载
reference/imagery-tile-provider.md- 影像瓦片加载（Baidu、Tianditu、Bing、OSM、Stadia）reference/vector-tile-provider.md- 矢量瓦片加载（Baidu、Mapbox）reference/third-party-imagery.md- 第三方图层接入（WMS、WMTS、XYZ 标准协议）reference/terrain-tile-provider.md- 地形瓦片加载（Cesium、平面地形）reference/tile-mask.md- TileMask 瓦片掩膜（按区域裁剪瓦片图层显示）
12. LBS 位置服务
reference/services.md- 位置基础服务（地理编码、搜索、路线规划、行政区划等）
13. 3DTiles 加载
reference/3dtiles-loading.md- 3D Tiles 加载（Default3DTiles、HDMap3DTiles）
14. 基础概念
reference/common/coordinate-system.md- 坐标系：Z-up、投影方式reference/common/event-binding.md- 事件绑定模式
关键注意事项
- 引擎初始化：
new mapvthree.Engine(container, { map: { center: [lng, lat], range: meters } }) - 坐标系：Z-up（X-东、Y-北、Z-上），与 Three.js 默认 Y-up 不同
- 视野控制：使用
range（相机距离，米）而非 zoom - 属性赋值：使用属性代理
obj.color = value，而非obj.setColor(value) - MeasureType：使用
mapvthree.Measure.MeasureType - 图层设置：通过
MapView设置影像/矢量/地形提供者，而非engine.map