SuperAPI AI Directory

bmap-jsapi-three

Coding & development

View repository

Updated 10-15 17:24

About this skill

MapV-Three Development Guide

Build high-performance 3D maps and GIS applications with MapV-Three - a cross-browser WebGL library using a Z-up coordinate system.

When to Use

Refer to these guidelines in the following scenarios:

  • 3D map editing and feature drawing
  • Map measurement tool development
  • 3D visualization of buildings, areas, etc.
  • Real-time traffic data display
  • Path tracking animation development

Quick Reference

0. Core Engine

  • references/engine.md - Engine core: initialization, scene management, rendering control
  • references/initialization.md - Engine initialization, resource configuration, Baidu Map adapter

1. Data Management

  • references/datasource.md - DataSource base class
  • references/datasource/geojson-datasource.md - GeoJSON data source
  • references/datasource/json-datasource.md - JSON data source
  • references/datasource/csv-datasource.md - CSV data source
  • references/datasource/dataitem.md - DataItem

2. Point Objects and Labels

  • references/simple-point.md - SimplePoint
  • references/effect-point.md - EffectPoint (Fan, Bubble, Wave, Breath, Radar, etc.)
  • references/marker-types.md - Marker types (Icon, BallonPoint, DOMPoint, EffectModelPoint)
  • references/circle.md - Circle (screen-space rendering)
  • references/label.md - Label text/icon labels
  • references/text.md - Text text component
  • references/cluster.md - ClusterPoint point clustering

3. Lines and Polygons

  • references/polyline.md - Polyline (the flat parameter controls the rendering mode)
  • references/simple-line.md - SimpleLine
  • references/wall.md - Wall wall/fence
  • references/polygon.md - Polygon
  • references/pillar.md - Pillar

4. Overlays

  • references/marker.md - Marker
  • references/popup.md - Popup
  • references/dom-overlay.md - DOMOverlay

5. Trackers

  • references/tracker.md - Tracker overview and lifecycle
  • references/path-tracker.md - PathTracker path tracking
  • references/object-tracker.md - ObjectTracker object tracking
  • references/orbit-tracker.md - OrbitTracker orbit tracking

6. Editing and Measurement

  • references/editor.md - Editor
  • references/measure.md - Measure tools

7. 3D Models

  • references/model.md - 3D model loading (SimpleModel/AnimationModel/LODModel)
  • references/twin.md - Twin digital twin traffic flow (real-time traffic flow visualization, DataProvider data processing)
  • references/mock-twin.md - MockTwin simulated traffic flow (traffic flow simulation generation based on route data)

8. Materials and Effects

  • references/materials.md - Material system (WaterMaterial, ExtendMeshStandardMaterial, etc.)
  • references/easing-function.md - Easing functions (LINEAR, QUINTIC_IN_OUT, CUBIC_OUT)

9. Sky and Weather

  • references/sky-weather.md - Sky system (EmptySky/DynamicSky/StaticSky) and weather

10. Heatmap

  • references/heatmap.md - Heatmap

11. Map Layer Loading

  • references/imagery-tile-provider.md - Imagery tile loading (Baidu, Tianditu, Bing, OSM, Stadia)
  • references/vector-tile-provider.md - Vector tile loading (Baidu, Mapbox)
  • references/third-party-imagery.md - Third-party layer integration (WMS, WMTS, XYZ standard protocols)
  • references/terrain-tile-provider.md - Terrain tile loading (Cesium, flat terrain)
  • references/tile-mask.md - TileMask tile mask (clips tile layer display by region)

12. LBS Location Services

  • references/services.md - Location-based services (geocoding, search, route planning, administrative divisions, etc.)

13. 3DTiles Loading

  • references/3dtiles-loading.md - 3D Tiles loading (Default3DTiles, HDMap3DTiles)

14. Basic Concepts

  • references/common/coordinate-system.md - Coordinate system: Z-up, projection method
  • references/common/event-binding.md - Event binding mode

Key Notes

  • Engine Initialization:new mapvthree.Engine(container, { map: { center: [lng, lat], range: meters } })
  • Coordinate System: Z-up (X-east, Y-north, Z-up), different from the default Y-up of Three.js
  • View Control: Use range(camera distance, meters) instead of zoom
  • Property Assignment: Use property proxy obj.color = value, instead of obj.setColor(value)
  • MeasureType: Use mapvthree.Measure.MeasureType
  • Layer Settings: Through MapView set image/vector/terrain providers, instead of engine.map