# QuickEarth-Free

**Repository Path**: mofangbao/quick-earth-free

## Basic Information

- **Project Name**: QuickEarth-Free
- **Description**: QuickEarth（以下简称QE）是一个二三维一体化的Web端矢量和栅格数据渲染引擎，适用于气象、海洋、水文、环境等领域的数据可视化。目前二维版本面向个人免费开放。如需要商用，可以与我们联系购买（微信：mofangbao）。
- **Primary Language**: TypeScript
- **License**: LGPL-3.0
- **Default Branch**: master
- **Homepage**: http://qecloud.91weather.com/
- **GVP Project**: No

## Statistics

- **Stars**: 173
- **Forks**: 51
- **Created**: 2022-06-27
- **Last Updated**: 2025-12-10

## Categories & Tags

**Categories**: gis

**Tags**: None

## README


QuickEarth（以下简称QE）是一个二三维一体化的Web端矢量和栅格数据渲染引擎，适用于气象、海洋、水文、环境等领域的数据可视化。目前二维版本面向个人免费开放。如需要商用或者需要三维版本，可以与我们联系购买。

**注意：当前二维版本已经完全免费，不需要证书即可部署使用，三维需要证书才能部署到生产环境，但是可以在本地免费学习测试，也可以联系我们获取三维免费试用版本证书。**

Cesium 1.136版本已经支持，有需要的用户请联系我们获取。

### 开始之前

QE引擎本身的使用需要具备一定的前端代码开发能力，如果还不具备，建议先学习一些基础的前端开发知识。

#### [点击查看更新日志](UPDATE.md)

### 快速开始

QE支持使用打包器进行模块化开发，也支持直接使用Script标签引入进行开发。

#### 使用Webpack+Typescript开发

```bash
# 将代码克隆到本地，也可以在页面直接下载zip包
git clone https://gitee.com/mofangbao/quick-earth-free
# 安装依赖（建议先设置npm为国内镜像： npm config set registry http://registry.npm.taobao.org
npm install
# 启动开发调试
npm start
# 打包发布版本
npm run build
```
[详细教程可以点此查看文档](http://book.dev.91weather.com/books/11b98/page/webpack)

#### 使用srcipt标签和原生JS开发

本脚手架的umd目录中的js文件是用来在umd模式下开发的，具体可以查看同目录中的index.html，也可以[点此查看详细教程](http://book.dev.91weather.com/books/11b98/page/js)。


### 前端工具支持

当前测试支持的有webpack和vite，理论上只要Leaflet和Cesium支持的工具均可以使用。

我们建议使用[Typescript](http://book.dev.91weather.com/books/11b98/page/typescript)
+[React](http://book.dev.91weather.com/books/11b98/page/react)/[Vue](http://book.dev.91weather.com/books/11b98/page/vue)进行开发。

### 相关资源

[查看教程文档](http://book.dev.91weather.com/shelves/quickearth)

**[在线体验（支持2D和3D的在线开发）](http://qecloud.91weather.com)**

[访问示范应用Web版（二维）](https://serv.91weather.com)

扫描下方访问示范应用微信小程序版

![扫描访问小程序](./demo.qrcode.jpg)

备注：示范站点改版中，部分数据可能不全，主要用来演示功能。

### 关于在线平台

学习一个新的框架最好的莫过于上手体验了，因此我们特别开发了[这个在线体验的平台](http://qecloud.91weather.com)，这里有非常多的DEMO可以用来学习参考。

![DEMO平台截图](./playground.jpg)

### 常见问题

#### 底层使用了开源库吗

是的。

- 二维上QE使用了[Leaflet](https://github.com/Leaflet/Leaflet)作为底层GIS框架。

- 三维上使用了[Cesium](https://github.com/CesiumGS/cesium)。

我们自研的部分是数据渲染的图层，底层是基于现有轮子的，方便复用社区已有的大量组件。

#### 什么格式的数据才能被QE渲染

QE的数据解析和渲染是分开的，因此本身没有限定数据格式，只是限定了数据结构。

对于矢量数据，只要能转换为GeoJSON形式，即可被渲染。

对于栅格数据，QE本质上定义的是一个一维数组和格点的开始、结束、间隔信息。任意格式的栅格数据只要通过自己编写解析器转换为这个数据结构都可以被渲染。

具体可以参考教程文档中[关于数据源方面的描述](http://book.dev.91weather.com/books/ed3d2/chapter/821fa)