基于传统JS技术栈的 Mars3D🌎功能示例
功能示例项目，是基于Mars3D 平台做的一个按每个单独功能进行单页面展示、并且支持修改编辑代码实时运行的一个演示功能的系统。 主要用于开发人员学习了解 Mars3D 每个功能的使用、用于业务人员了解体验 Mars3D 具备的功能点。
首先建议您学习浏览一遍我们功能示例的源码（源码中会有大量注释），阅读源码时可以结合查阅API文档来理解类及方法的作用和参数说明等。
这是一个基于原生JS开发的 Mars3D 功能示例 演示项目。
如果您不熟悉原生JS，也可以阅读：功能示例Vue版、功能示例React版
- 独立页面：每一个页面是一个单独的示例，依赖少，独立运行。
- 适合不同技术栈: 原生JS开发, 适合不同技术栈用户理解
建议先看一遍视频讲解，再实际操作，您可以新页面查看高清视频
git clone git@github.com:marsgis/mars3d-es5-example.git
- Gitee：国内码云，下载速度快些。
git clone git@gitee.com:marsgis/mars3d-es5-example.git
- 如果本地没有git软件，可以浏览器输入https://github.com/marsgis/mars3d-es5-example地址后，按下图下载zip包。
运行前建议从http://mars3d.cn/download.html下载最新mars3d类库后覆盖至lib/目录下，更新mars3d为最新版本。
在任意开发编辑器（如vscode等）或http服务器(如node、nginx、tomcat、IIS等)下直接运行浏览index.html或example目录下各对应示例页面即可。
建议使用VScode工具打开代码目录（请参考开发环境搭建教程安装好VScode 及 Live Server插件），运行index.html页面即可。
如果只想浏览单个示例，也可以参考下图通过Live Server访问对应示例的页面
npm install
//或使用代理
npm i --registry=http://registry.taobao.org
npm run serve
npm run build //编译后生成在dist目录，拷贝出去发布即可
npm run serve:dist //测试dist运行状态
// 或者将dist文件夹发布在自己的服务数据上
- 发现您发现项目中存在的问题或者需要优化的地方；
- 如果您有一些自己全新编写的示例，希望也开源与大家分享。
提交方式：
- 欢迎在github或gitee上提交PR
- 如果对git不熟悉，也可以整理示例代码发送邮件到 wh@marsgis.cn 由我们来整理集成。
mars3d-es5-example
│───config 列表配置信息及截图
│───example 示例代码，每个示例页面可以单独运行【重要】
│───css 公共CSS样式文件
│───img 公共图片文件
│───js 公共JS文件
│───lib 示例依赖的类库
│ └─include-lib.js lib类库统一配置文件
│───widgets 基础项目模块资源，便于演示部分示例
└───index.html 列表页（访问入口）
与示例相关的2个主要目录是：example、lib。
我们当前原生JS版本功能示例页面，第三方类库及我们的sdk类库都存放在lib目录下，每个目录均有README.md文件说明该类库的github地址、官网和用途等信息。
为了方便切换和引入第3方lib，我们编写了一个独立的js文件include-lib.js来统一调用使用第3方lib,在需要的页面按下面方式引入lib：
<!--第三方lib-->
<script type="text/javascript" src="/lib/include-lib.js" libpath="/lib/"
include="font-awesome,mars3d"></script>该方式等价于（如不习惯include-lib.js，也可以改为下面演示的直接引入方式）：
<!--对应font-awesome-->
<link rel="stylesheet" href="/lib/fonts/font-awesome/css/font-awesome.min.css">
<!--对应turf-->
<script type="text/javascript" src="/lib/turf/turf.min.js"></script>
<!--对应mars3d-->
<link rel="stylesheet" href="/lib/Cesium/Widgets/widgets.css">
<script type="text/javascript" src="/lib/Cesium/Cesium.js"></script>
<link rel="stylesheet" href="/lib/mars3d/mars3d.css">
<script type="text/javascript" src="/lib/mars3d/mars3d.js"></script>复制example\00_model.html文件后改名，并修改代码即可。
示例的目的是演示平台的每个功能点，可以按需求或兴趣去学习每一个示例，
- （1）学习中可以查询相关类的API文档
- （2）尝试修改源码中参数、方法等，来体验不同的呈现效果。
平台所有代码层面来说支持离线运行和使用的，但需要注意的是离线时的地图服务的相关处理。
如果局域网内有相关地形、卫星底图服务可以按内网服务类型和URL地址替换下config.json或构造Map的代码中的默认地形和底图。
如果局域网内没有相关服务，可以按下面处理：
- 修改config.json中
terrain配置中，将已有的"show": true配置，改为"show": false - 修改config.json中
basemaps数组配置中，将已有的"show": true的图层，将该值改为"show": false，并将单张图片或离线地图加上"show": true，并修改相关URL地址。 - 您也可以参考教程发布三维数据服务进行部署离线地图服务，里面也有一些示例离线数据。
Mars3D平台是一款基于 WebGL 技术实现的三维客户端开发平台，基于Cesium优化提升与B/S架构设计，支持多行业扩展的轻量级高效能GIS开发平台，能够免安装、无插件地在浏览器中高效运行，并可快速接入与使用多种GIS数据和三维模型，呈现三维空间的可视化，完成平台在不同行业的灵活应用。
Mars3D平台可用于构建无插件、跨操作系统、 跨浏览器的三维 GIS 应用程序。平台使用 WebGL 来进行硬件加速图形化，跨平台、跨浏览器来实现真正的动态大数据三维可视化。通过 Mars3D产品可快速实现浏览器和移动端上美观、流畅的三维地图呈现与空间分析。
-
Mars3D官网：http://mars3d.cn
-
Mars3D开源项目列表：https://github.com/marsgis/mars3d
mars3d-es5-example 的项目源代码（包括但不限于 example/ 目录下的页面、
组件、路由、状态管理、配置及项目模板代码）基于 Apache License 2.0
完全开源。在遵守协议的前提下，您可以自由地使用、复制、修改、合并、
发布、分发和再授权，包括用于商业目的。
本项目是 Mars3D SDK 的示例工程 / 项目模板，运行时依赖 Mars3D SDK
核心类库（mars3d 命名空间下的类库文件，通常位于 lib/mars3d/
目录、通过 npm install mars3d 安装，或通过 CDN 引入）。Mars3D SDK 是
独立授权的产品，其授权条款与本项目相互独立：
| 对比项 | 本项目（mars3d-es5-example） | Mars3D SDK |
|---|---|---|
| 授权方式 | Apache License 2.0 | 免费版：Apache-2.0 ＋ 附加条款；商业版：商业授权 |
| 是否开源 | 完全开源 | 以编译后的类库形式分发 |
| 页面 Logo | 免费版必须保留，不得移除 / 遮挡 / 规避；商业授权版可去除 | |
| F12 控制台版权信息 | 免费版不得修改；商业授权版替换为被授权方单位名称 | |
| 商业用途 | 自由使用 | 免费版可商用（须保留署名）；去除 Logo 需购买商业授权 |
| 协议依据 | 本仓库根目录 LICENSE |
SDK 随附授权文件，或见 https://mars3d.cn |
特别说明：
- 本项目源代码的 Apache-2.0 授权仅覆盖项目自身代码，不覆盖、不改变 Mars3D SDK 的授权条款，也不构成对 SDK 附加条款（Logo、F12 控制台 信息保留义务）的豁免。
- 您基于本项目进行二次开发、打包、部署或对外交付时，只要运行时使用了 Mars3D SDK，即应同时遵守 SDK 的授权条款。
- 仓库内随附的 SDK 类库文件（如
lib/mars3d/目录）不属于 本项目的开源代码，其著作权归mars3d团队所有，适用 SDK 自身的授权协议。
如您需要：去除页面周边的 Mars3D Logo；将 F12 控制台版权信息替换为 贵单位 / 项目名称；或在对外商业交付、政企招投标中取得盖章授权文件， 请购买 Mars3D SDK 商业授权👉 http://mars3d.cn/buy.html
购买后只需用授权版 SDK 覆盖项目中的类库文件，项目代码无需任何修改。