# CesiumJS

[![Build Status](https://github.com/CesiumGS/cesium/actions/workflows/dev.yml/badge.svg)](https://github.com/CesiumGS/cesium/actions/workflows/dev.yml)
[![npm](https://img.shields.io/npm/v/cesium)](https://www.npmjs.com/package/cesium)
[![Docs](https://img.shields.io/badge/docs-online-orange.svg)](https://cesium.com/learn/)

![Cesium](https://github.com/CesiumGS/cesium/wiki/logos/Cesium_Logo_Color.jpg)

CesiumJS is a JavaScript library for creating 3D globes and 2D maps in a web browser without a plugin. It uses WebGL for hardware-accelerated graphics, and is cross-platform, cross-browser, and tuned for dynamic-data visualization.

Built on open formats, CesiumJS is designed for robust interoperability and scaling for massive datasets.

---

[**Examples**](https://sandcastle.cesium.com/) :earth_asia: [**Docs**](https://cesium.com/learn/cesiumjs-learn/) :earth_americas: [**Website**](https://cesium.com/cesiumjs) :earth_africa: [**Forum**](https://community.cesium.com/) :earth_asia: [**User Stories**](https://cesium.com/user-stories/)

---

# mars3d-cesium

Mars3D修改版Cesium库， 因为cesium本身也有一些bug或需要优化的地方，Mars3D使用的cesium也修改了部分cesium源码文件。我们修改Cesium的原则：

- 主要扩展都在mars3d类库中，没法外部扩展的，才会在内部去修改cesium底层；
- 尽量不改变ceisum本身逻辑，通过参数来可控改变；
- 并且所有修改都有完整注释说明。

> 更多说明：http://mars3d.cn/docs/advanced/cesium/

<p align="center">
<img src="//mars3d.cn/logo.png" width="300px" />
</p>

<p align="center">🌎 Mars3D 一款基于WebGL技术实现的三维地球客户端开发平台</p>

<p align="center">
  <a target="_black" href="https://www.npmjs.com/package/mars3d">
    <img alt="Npm version" src="https://img.shields.io/npm/v/mars3d.svg?style=flat&logo=npm&label=版本号" />
  </a>
  <a target="_black" href="https://www.npmjs.com/package/mars3d">
    <img alt="Npm downloads" src="https://img.shields.io/npm/dt/mars3d?style=flat&logo=npm&label=下载量" />
  </a>
  <a target="_black" href="https://github.com/marsgis/mars3d">
    <img alt="GitHub stars" src="https://img.shields.io/github/stars/marsgis/mars3d?style=flat&logo=github" />
  </a>
  <a target="_black" href="https://gitee.com/marsgis/mars3d">
    <img src="https://gitee.com/marsgis/mars3d/badge/star.svg?theme=dark" alt="star" />
  </a>
</p>

[**English**](./README_EN.md) |[**中文**](./README.md)

当前仓库包含SDK更新日志、和其他仓库导航。

Github：[https://github.com/marsgis/mars3d](https://github.com/marsgis/mars3d)

国内Gitee：[https://gitee.com/marsgis/mars3d](https://gitee.com/marsgis/mars3d)

更新日志: [CHANGE.md](./CHANGE.md)



## 功能示例
 对平台每个功能编写的案例代码，可以阅读每个示例代码来学习各功能，与官网功能示例一致效果。

| 说明 | 教程  | 视频  |Github源码 | 国内Gitee源码  |    
| ----|----  | ----  | ----| ----  |
|Vue版 |[查看](http://mars3d.cn/docs/guide/example-vue/) |[查看](https://www.bilibili.com/video/BV1PL41177SS/)、[高级篇](https://www.bilibili.com/video/BV1Xv4y1a74P/)| [mars3d-vue-example](https://github.com/marsgis/mars3d-vue-example) |[mars3d-vue-example](https://gitee.com/marsgis/mars3d-vue-example)  |  
|原生JS版 | [查看](http://mars3d.cn/docs/guide/example-es5/) | [查看](https://www.bilibili.com/video/BV1Hg411o7Js/) | [mars3d-es5-example](https://github.com/marsgis/mars3d-es5-example) |[mars3d-es5-example](https://gitee.com/marsgis/mars3d-es5-example)  | 
|React版 |[查看](http://mars3d.cn/docs/guide/example-react/)|[查看](https://www.bilibili.com/video/BV1xY4y1t7NR/)、[高级篇](https://www.bilibili.com/video/BV1tX4y1Q7v7/) | [mars3d-react-example](https://github.com/marsgis/mars3d-react-example) |[mars3d-react-example](https://gitee.com/marsgis/mars3d-react-example)  |  


##  最简项目模板
 提供了面向不同技术栈的最简项目模板，您可以直接使用或参考这些项目模板，了解SDK类库在不同技术栈项目中如何引入使用，快速搭建开发自己的项目。 

| 说明 | 视频  | Github源码 | 国内Gitee源码  |    
| ----| ----|----| ----  |
|Vue技术栈 |[查看](https://www.bilibili.com/video/BV17P4y1F7gv/)| [mars3d-vue-template](https://github.com/marsgis/mars3d-vue-template) |[mars3d-vue-template](https://gitee.com/marsgis/mars3d-vue-template)  | 
|原生JS技术栈 |[查看](https://www.bilibili.com/video/BV1za41177ZW/)| [mars3d-es5-template](https://github.com/marsgis/mars3d-es5-template) |[mars3d-es5-template](https://gitee.com/marsgis/mars3d-es5-template)  | 
|React技术栈 |[查看](https://www.bilibili.com/video/BV1nZ4y1b7W7/)| [mars3d-react-template](https://github.com/marsgis/mars3d-react-template) |[mars3d-react-template](https://gitee.com/marsgis/mars3d-react-template)  |   
|Angular技术栈 |[查看](https://www.bilibili.com/video/BV13Y411K7xs/) | [mars3d-angular-template](https://github.com/marsgis/mars3d-angular-template) |[mars3d-angular-template](https://gitee.com/marsgis/mars3d-angular-template)  |   
|CS桌面端程序 |[查看](https://www.bilibili.com/video/BV1N94y1R7ds/)| [mars3d-electron](https://github.com/marsgis/mars3d-electron) |[mars3d-electron](https://gitee.com/marsgis/mars3d-electron)  |   
|uni-app移动端程序 |[查看](https://www.bilibili.com/video/BV18F41157qR/)|[mars3d-uni-app](https://github.com/marsgis/mars3d-uni-app) |[mars3d-uni-app](https://gitee.com/marsgis/mars3d-uni-app)  |   



## 通用项目模版 
通用项目模版是具备一个GIS项目常见功能的项目模板，只用更换数据及叠加业务即可完成项目交付。
如果需要更多功能可以考虑购买[付费项目模板](http://mall.marsgis.cn/#/product-list?category=project)。

|说明 |教程  |视频  | Github源码 | 国内Gitee源码  |   
|----|----  |----  | ----| ----  |
|Vue通用项目模版 |[查看](http://mars3d.cn/docs/guide/project-vue/) |[查看](https://www.bilibili.com/video/BV1JF411q7Ut/)、[高级篇](https://www.bilibili.com/video/BV1rM411j78s/) | [mars3d-vue-project](https://github.com/marsgis/mars3d-vue-project) |[mars3d-vue-project](https://gitee.com/marsgis/mars3d-vue-project)  |  
| 原生JS通用项目模版 |[查看](http://mars3d.cn/docs/guide/project-es5/) | [查看](https://www.bilibili.com/video/BV1nF41157Rn/)| [mars3d-es5-project](https://github.com/marsgis/mars3d-es5-project) |[mars3d-es5-project](https://gitee.com/marsgis/mars3d-es5-project)  |
|React通用项目模版|[查看](http://mars3d.cn/docs/guide/project-react/) |[查看](https://www.bilibili.com/video/BV1n3411u7Dm/)、[高级篇](https://www.bilibili.com/video/BV1d84y1E7gR/) | [mars3d-react-project](https://github.com/marsgis/mars3d-react-project) |[mars3d-react-project](https://gitee.com/marsgis/mars3d-react-project)  |   
|APP项目模版(Vue3+H5)|  [查看](http://mars3d.cn/docs/guide/project-app/)  | [查看](https://www.bilibili.com/video/BV1iY4y1t7jk/)、[高级篇](https://www.bilibili.com/video/BV1CD4y137jK/) | [mars3d-vue-app](https://github.com/marsgis/mars3d-vue-app) |[mars3d-vue-app](https://gitee.com/marsgis/mars3d-vue-app)  |  





## 平台介绍

`Mars3D平台` 是一款基于WebGL技术实现的三维客户端开发平台，基于[Cesium](https://cesium.com/cesiumjs/)优化提升与B/S架构设计，支持多行业扩展的轻量级高效能GIS开发平台，能够免安装、无插件地在浏览器中高效运行，并可快速接入与使用多种GIS数据和三维模型，呈现三维空间的可视化，完成平台在不同行业的灵活应用。

## 学习资料

- 开发教程：[http://mars3d.cn/dev/](http://mars3d.cn/dev/)
- API文档：[http://mars3d.cn/api/](http://mars3d.cn/api/)
- Mars3D官网：[http://mars3d.cn](http://mars3d.cn)

### 反馈问题

为了方便交流及留存，所有bug及建议均统一提交至：[github issues](https://github.com/marsgis/mars3d/issues) 或
[国内gitee issues](https://gitee.com/marsgis/mars3d/issues)

## 平台相关效果

功能示例：
![image](http://marsgis.cn/img/project/mars3d-doc/example1.jpg)

基础项目：[在线体验](http://mars3d.cn/project/vue/jcxm.html)

![image](http://marsgis.cn/img/project/mars3d-vue-project-jcxm/1.jpg)

电子沙盘项目：[在线体验](http://mars3d.cn/project/es5/dzsp.html)

![image](http://marsgis.cn/img/project/mars3d-es5-project-dzsp/2.jpg)

智慧园区项目：[在线体验](http://mars3d.cn/project/vue/zhyq.html)

![image](http://marsgis.cn/img/project/mars3d-vue-project-zhyq/1.jpg)

综合态势项目：[在线体验](http://mars3d.cn/project/vue/login.html)

![image](http://marsgis.cn/img/project/mars3d-vue-project-zhts/2.jpg)

## 版权说明

1. Mars3D平台由[mars3d团队](http://mars3d.cn/)自主研发，拥有所有权利。
2. 任何个人或组织可以在遵守相关要求下可以免费无限制使用。