vite-plugin-earth/README.md

# ⚡ vite-plugin-earth

[![npm](https://img.shields.io/npm/v/vite-plugin-earth.svg)](https://www.npmjs.com/package/vite-plugin-earth)
[![npm](https://img.shields.io/npm/dt/vite-plugin-earth)](https://www.npmjs.com/package/vite-plugin-earth)

Easily set up a [`Cesium`] & [`Mars3D`] project in [`Vite`].

[`cesium`]: https://cesium.com/platform/cesiumjs/
[`vite`]: https://vitejs.dev/
[`mars3d`]: http://mars3d.cn/

## Cesium

### Install

```bash
npm i cesium vite-plugin-earth vite -D
```

### Usage

add this plugin to `vite.config.js`

```js
import { defineConfig } from 'vite';
import { cesiumPlugin } from 'vite-plugin-earth';
export default defineConfig({
  plugins: [cesiumPlugin()]
});
```

## Mars3D

### Install

```bash
npm i mars3d mars3d-cesium vite-plugin-earth vite -D
```

### Usage

add this plugin to `vite.config.js`

```js
import { defineConfig } from 'vite';
import { mars3dPlugin } from 'vite-plugin-earth';
export default defineConfig({
  plugins: [mars3dPlugin()]
});
```

## Options

**useCDN**

- **Type :** `object`
- **Default :** `{ mars3d: '3.5.4', mars3dCesium: '1.104.3', turf: '6.5.0' }`

打包时使用 cdn 方式

```js
import { defineConfig } from 'vite';
import { mars3dPlugin } from 'vite-plugin-earth';
export default defineConfig({
  plugins: [
    mars3dPlugin({
      useCDN: true
    })
  ]
});
```

## Demo

### Cesium

```html
<div id="cesiumContainer"></div>
```

```js
import { Viewer } from 'cesium';

const viewer = new Viewer('cesiumContainer');
```

### Mars3D

```html
<div id="mars3dContainer"></div>
```

```js
import * as mars3d from 'mars3d';
import 'mars3d/dist/mars3d.css';

const map = new mars3d.Map('mars3dContainer', {});
```

## License

MIT