官方插件

451字约2分钟

2026-10-20

本页目标

了解 Mars2D 主库之外有哪些官方插件、各自解决什么问题、如何安装与引入。

1. 主库与插件的关系

主库 mars2d：地图核心（Map、图层、矢量对象、控件、分析）。
插件：按需引入的扩展能力，不放进主库以减小体积、方便按场景加载。

插件安装后，其提供的类会挂到 mars2d 命名空间下，用法与主库一致。

2. 官方插件清单

插件	作用	npm 包
ECharts 可视化	把 ECharts 图表叠加到地图上	`mars2d-echarts`
MapV 可视化	大数据量地图可视化（MapV）	`mars2d-mapv`
Esri 服务	接入 ArcGIS 服务	`mars2d-esri`

各插件的在线地址可在介绍SDK的“SDK插件库”一节查看。

3. 安装

npm

npm install mars2d-echarts --save
npm install mars2d-mapv --save
npm install mars2d-esri --save

pnpm

pnpm add mars2d-echarts
pnpm add mars2d-mapv
pnpm add mars2d-esri

4. 引入顺序

插件依赖主库，必须先引入 mars2d，再引入插件：

<!-- 1. 先引入主库 -->
<script src="https://registry.npmmirror.com/mars2d/latest/files/mars2d.js"></script>
<!-- 2. 再引入插件 -->
<script src="https://registry.npmmirror.com/mars2d-echarts/latest/files/mars2d-echarts.js"></script>

NPM 方式下：

import * as mars2d from "mars2d"
import "mars2d-echarts" // 引入后即注册插件能力

5. 使用

插件提供的可视化图层与主库图层用法一致，创建后 map.addLayer 即可：

ECharts：参阅其他可视化图层与功能示例
MapV：参阅功能示例
Esri：参阅功能示例

提示

具体参数、方法以在线 API 文档与功能示例为准，本页只说明“装什么、怎么引、按什么顺序”。