外观
SDK类库介绍
约 1291 字大约 4 分钟
2024-12-27
Mars3D平台开发的SDK所有类及方法均以 mars3d 开头命名,mars3d.* 为平台框架的默认命名空间,所有用到的类及方法都是通过mars3d.*来调用。 开发时尽量不要使用 mars3d 来定义自己的变量或类名、方法名,避免框架无法正常使用。
SDK主库
| 包名 | 当前版本 | CDN地址 | 下载量 | 备注 |
|---|---|---|---|---|
| mars3d | cdn | Mars3D主类库 |
各版本更新日志,可以访问 版本更新日志
SDK插件库(可选)
部分插件没有合并在主库中,方便不同场景下按需使用。免费插件随主库许可使用;mars3d-plot、mars3d-ue 等付费高级插件需单独授权。
| 包名 | 当前版本 | CDN地址 | 下载量 | 备注 |
|---|---|---|---|---|
| mars3d-space | cdn | space卫星插件 | ||
| mars3d-heatmap | cdn | heatmap热力图插件 | ||
| mars3d-echarts | cdn | echarts可视化插件 | ||
| mars3d-mapv | cdn | mapv可视化插件 | ||
| mars3d-wind | cdn | wind风场插件 | ||
| mars3d-tdt | cdn | 天地图三维地名和地形服务插件 | ||
| mars3d-supermap | cdn | 超图服务插件 |
除了npm也可以按需下载SDK静态包
- 离线下载SDK包:mars3d 主库下载稳定版
下载开发版
API文档
- 在线文档地址:http://mars3d.cn/api/Map.html
- 离线文档下载:下载最新版(v)

大部分类都在mars3d一级命名空间下面
mars3d.* //比如 mars3d.PointUtil少数包放在二级命名空间下,清单如下:
mars3d.layer.* //图层,比如 mars3d.layer.GraphicLayer
mars3d.graphic.* //矢量对象,比如 mars3d.graphic.PointEntity
mars3d.control.* //控件
mars3d.effect.* //场景特效
mars3d.thing.* //管理或分析
mars3d.query.* //服务查询
mars3d.material.* //material材质
mars3d.provider.* //瓦片图层的数据提供者主要API类名清单请查阅API文档章节
SDK架构图
Mars3D平台 SDK架构图,建议使用前先熟悉整体架构图,以便能够快速使用。新窗口查看大图
📄 授权协议 / License
Mars3D SDK 提供 社区免费版、商业授权版、源代码版 三种使用方式,功能一致,差异在页面标识、源码与支持。
- 社区免费版:基于 Apache License 2.0,并附加《Mars3D 免费版附加条款》。可免费用于学习、开发与商业项目,但必须保留软件运行时页面的 Mars3D Logo 及浏览器 F12 控制台输出的版权信息,不得移除、遮挡、修改或通过任何技术手段规避。
- 商业授权版:付费后可去除页面 Logo,F12 控制台信息替换为贵单位 / 项目名称,并提供盖章授权文件、专属技术支持与缺陷修复服务;按 SDK 大版本授权,同一大版本内的小版本免费更新。
- 源代码版:在商业授权基础上交付 SDK 核心源码,页面标识可按需自行构建,适合深度定制与自主可控场景。
三种使用方式均不限制项目数、安装节点数、用户数与使用时间。
| 社区免费版 | 商业授权版 | 源代码版 | |
|---|---|---|---|
| 交付内容 | npm 标准公开包 | 授权版 SDK + 盖章授权书 | SDK 源码包 |
| 页面标识 | 保留 Logo 与控制台版权 | 去除 Logo,控制台显示单位 | 可按需自行构建 |
| 源码 | 不提供 | 不提供 | 提供核心源码 |
| 版本与支持 | 跟随大版本 · 社区支持 | 大版本内免费 · 专属支持 | 同商业授权版 |
| 授权费用 | 免费 | 按大版本一次性付费 | 在商业授权基础上按需报价 |
