# sat-earth

**Repository Path**: dolphinee-lu/sat-earth

## Basic Information

- **Project Name**: sat-earth
- **Description**: SatEarth是基于 Vite + TypeScript + Vue + Element Plus 等技术架构以及 Mars3D 和 Cesium 的底层API，实现的三维地球NPM组件库，以支持前端开发者快速搭建三维场景。
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: http://kbe3d.top/sat-earth-docs/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 12
- **Created**: 2025-05-21
- **Last Updated**: 2025-05-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 简介

## 什么是SatEarth?
> **[SatEarth](https://gitee.com/gengkaibo/sat-earth)是基于 [Vite](https://vitejs.dev/) + [TypeScript](https://www.typescriptlang.org/) + [Vue](https://v3.vuejs.org/) + [Element Plus](http://element-plus.org/zh-CN/) 等技术架构以及 [Mars3D](http://mars3d.cn/) 和 [Cesium](https://cesium.com/) 的底层API，实现的三维地球NPM组件库，以支持前端开发者快速搭建三维场景。**

## 组件列表
> 已完成的组件：
- 主入口（`SatGlobe`）组件
- 公共UI（`SatPanel`）组件
- 任务视图（`SatTaskView`）组件
- 菜单（`SatMenu`）组件
- 菜单树（`SatMenuTree`）组件
- 数据源（`SatSource`）组件
- 搜索定位（`SatLocation`）组件
- 量测工具（`SatMeasure`）组件
- 图上标绘（`SatPlot`）组件
- 出图工具（`SatPicture`）组件
- 分析工具（`SatSpatialAnalysis`）组件

> 计划中的组件：
- 飞行漫游（`SatRoam`）组件

## 亮点
  - ⚡️ 基于`Vite`、`TypeScript`、`Vue`等最新技术栈开发，在开发过程中如果使用`VSCode`开发，有相应的[Volar](https://marketplace.visualstudio.com/items?itemName=johnsoncodehk.volar)插件代码提示支持
  - 💡 对常用功能进行组件化封装，统一维护，满足基础工作需求
  - 🛠️ 暴露了`SatEarth`等API，在使用过程中除了可以使用内置的组件外，可以灵活根据业务和需求进行个性化开发
  - 🔑 同`Element Plus`的主题配置及黑暗主题适配
  - ✨ 支持在同一个界面构造多个`Cesium`球而互不影响

## 浏览器支持
- `Chrome`
- `Firefox`
- `Microsoft Edge 13` 及以上
- `Safari 9+`
- 各类以`Chrominum`为核心的第三方浏览器，如360浏览器，傲游浏览器等
- IOS，安卓及鸿蒙操作系统上的现代手机浏览器
- 微信或手机QQ上的浏览器

同Vue3一样不支持IE浏览器（包括`IE11`），主要考虑到以下几个原因：
- `IE`不支持最新的Javascript标准，极大的增加了工程的开发和维护难度
- `IE11`的WebGL性能很弱
- `IE`不支持`WASM`，很多基于WASM的功能或优化都无法支持
- `IE`的市场占有率极低，自2022年6月15日起，`IE11`停止维护

## 相关地址
- [SatEarth仓库](https://gitee.com/gengkaibo/sat-earth)
- [SatEarth在线文档](http://kbe3d.top/sat-earth-docs/)
- [SatEarth在线体验](http://kbe3d.top/sat-earth-demo/)