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 controlreferences/initialization.md- Engine initialization, resource configuration, Baidu Map adapter
1. Data Management
references/datasource.md- DataSource base classreferences/datasource/geojson-datasource.md- GeoJSON data sourcereferences/datasource/json-datasource.md- JSON data sourcereferences/datasource/csv-datasource.md- CSV data sourcereferences/datasource/dataitem.md- DataItem
2. Point Objects and Labels
references/simple-point.md- SimplePointreferences/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 labelsreferences/text.md- Text text componentreferences/cluster.md- ClusterPoint point clustering
3. Lines and Polygons
references/polyline.md- Polyline (the flat parameter controls the rendering mode)references/simple-line.md- SimpleLinereferences/wall.md- Wall wall/fencereferences/polygon.md- Polygonreferences/pillar.md- Pillar
4. Overlays
references/marker.md- Markerreferences/popup.md- Popupreferences/dom-overlay.md- DOMOverlay
5. Trackers
references/tracker.md- Tracker overview and lifecyclereferences/path-tracker.md- PathTracker path trackingreferences/object-tracker.md- ObjectTracker object trackingreferences/orbit-tracker.md- OrbitTracker orbit tracking
6. Editing and Measurement
references/editor.md- Editorreferences/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 methodreferences/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 ofobj.setColor(value) - MeasureType: Use
mapvthree.Measure.MeasureType - Layer Settings: Through
MapViewset image/vector/terrain providers, instead ofengine.map