Back to Details

bmap-jsapi-three

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

MapV-Three 开发指南

MapV-Three 开发指南

使用 MapV-Three 构建高性能的 3D 地图和 GIS 应用 - 一个采用 Z-up 坐标系的跨浏览器 WebGL 库。
使用 MapV-Three 构建高性能的 3D 地图和 GIS 应用 - 一个采用 Z-up 坐标系的跨浏览器 WebGL 库。

何时适用

何时适用

在以下场景中参考这些指南：
  • 3D 地图编辑和要素绘制
  • 地图测量工具开发
  • 建筑物、区域等 3D 可视化
  • 实时交通数据展示
  • 路径追踪动画开发
在以下场景中参考这些指南：
  • 3D 地图编辑和要素绘制
  • 地图测量工具开发
  • 建筑物、区域等 3D 可视化
  • 实时交通数据展示
  • 路径追踪动画开发

快速参考

快速参考

0. 核心引擎

0. 核心引擎

  • reference/engine.md
    - Engine 引擎核心：初始化、场景管理、渲染控制
  • reference/initialization.md
    - 引擎初始化、资源配置、百度地图适配器
  • reference/engine.md
    - Engine 引擎核心：初始化、场景管理、渲染控制
  • reference/initialization.md
    - 引擎初始化、资源配置、百度地图适配器

1. 数据管理

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 数据项
  • 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. 点对象与标签

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 点聚合
  • 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. 线与面

3. 线与面

  • reference/polyline.md
    - Polyline 折线（flat 参数控制渲染模式）
  • reference/simple-line.md
    - SimpleLine 简单线
  • reference/wall.md
    - Wall 墙体/围栏
  • reference/polygon.md
    - Polygon 多边形
  • reference/pillar.md
    - Pillar 柱体
  • reference/polyline.md
    - Polyline 折线（flat 参数控制渲染模式）
  • reference/simple-line.md
    - SimpleLine 简单线
  • reference/wall.md
    - Wall 墙体/围栏
  • reference/polygon.md
    - Polygon 多边形
  • reference/pillar.md
    - Pillar 柱体

4. 覆盖物

4. 覆盖物

  • reference/marker.md
    - Marker 标记
  • reference/popup.md
    - Popup 弹出窗口
  • reference/dom-overlay.md
    - DOMOverlay DOM 覆盖物
  • reference/marker.md
    - Marker 标记
  • reference/popup.md
    - Popup 弹出窗口
  • reference/dom-overlay.md
    - DOMOverlay DOM 覆盖物

5. 追踪器

5. 追踪器

  • reference/tracker.md
    - 追踪器总览与生命周期
  • reference/path-tracker.md
    - PathTracker 路径追踪
  • reference/object-tracker.md
    - ObjectTracker 对象追踪
  • reference/orbit-tracker.md
    - OrbitTracker 轨道追踪
  • reference/tracker.md
    - 追踪器总览与生命周期
  • reference/path-tracker.md
    - PathTracker 路径追踪
  • reference/object-tracker.md
    - ObjectTracker 对象追踪
  • reference/orbit-tracker.md
    - OrbitTracker 轨道追踪

6. 编辑与测量

6. 编辑与测量

  • reference/editor.md
    - Editor 编辑器
  • reference/measure.md
    - Measure 测量工具
  • reference/editor.md
    - Editor 编辑器
  • reference/measure.md
    - Measure 测量工具

7. 3D 模型

7. 3D 模型

  • reference/model.md
    - 3D 模型加载（SimpleModel/AnimationModel/LODModel）
  • reference/twin.md
    - Twin 孪生车流（实时车流可视化、DataProvider 数据处理）
  • reference/mock-twin.md
    - MockTwin 模拟车流（基于路线数据的车流模拟生成）
  • reference/model.md
    - 3D 模型加载（SimpleModel/AnimationModel/LODModel）
  • reference/twin.md
    - Twin 孪生车流（实时车流可视化、DataProvider 数据处理）
  • reference/mock-twin.md
    - MockTwin 模拟车流（基于路线数据的车流模拟生成）

8. 材质与特效

8. 材质与特效

  • reference/materials.md
    - 材质系统（WaterMaterial、ExtendMeshStandardMaterial 等）
  • reference/easing-function.md
    - 缓动函数（LINEAR、QUINTIC_IN_OUT、CUBIC_OUT）
  • reference/materials.md
    - 材质系统（WaterMaterial、ExtendMeshStandardMaterial 等）
  • reference/easing-function.md
    - 缓动函数（LINEAR、QUINTIC_IN_OUT、CUBIC_OUT）

9. 天空与天气

9. 天空与天气

  • reference/sky-weather.md
    - 天空系统（EmptySky/DynamicSky/StaticSky）和天气
  • reference/sky-weather.md
    - 天空系统（EmptySky/DynamicSky/StaticSky）和天气

10. 热力图

10. 热力图

  • reference/heatmap.md
    - Heatmap 热力图
  • reference/heatmap.md
    - Heatmap 热力图

11. 地图图层加载

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 瓦片掩膜（按区域裁剪瓦片图层显示）
  • 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 位置服务

12. LBS 位置服务

  • reference/services.md
    - 位置基础服务（地理编码、搜索、路线规划、行政区划等）
  • reference/services.md
    - 位置基础服务（地理编码、搜索、路线规划、行政区划等）

13. 3DTiles 加载

13. 3DTiles 加载

  • reference/3dtiles-loading.md
    - 3D Tiles 加载（Default3DTiles、HDMap3DTiles）
  • reference/3dtiles-loading.md
    - 3D Tiles 加载（Default3DTiles、HDMap3DTiles）

14. 基础概念

14. 基础概念

  • reference/common/coordinate-system.md
    - 坐标系：Z-up、投影方式
  • reference/common/event-binding.md
    - 事件绑定模式
  • 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
  • 引擎初始化：
    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