# @aerisweather/mapsgl 中文文档

规范地址：https://npmcn.com/package/%40aerisweather/mapsgl/

版本：1\.7\.4
npm 元数据更新时间：2026-06-18T21:56:59.097Z
中文译文更新时间：2026-11-06T00:15:46.750Z
软件包许可：BSD

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40aerisweather/mapsgl
原文对照：https://npmcn.com/package/%40aerisweather/mapsgl/?lang=original
项目主页：https://www.xweather.com/

弃用说明：Starting with version 1\.8\.0, the MapsGL Javascript SDK has moved to @xweather/mapsgl\. Please upgrade your dependecies to use the latest versions\.

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.2 MB，6 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2023-01-12T17:04:39.478Z
- 最新版本发布：2025-08-28T14:38:02.136Z
- 近 30 天下载量：8274（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：69（近 12 个月 0 个）

## 中文简介

一个易于使用,高度自定义的Javascript库,用于在WebGL的各种网络映射平台上可视化天气和自定义数据.

## 安装

```sh
npm install @aerisweather/mapsgl
```

也可以使用：`pnpm add @aerisweather/mapsgl`、`yarn add @aerisweather/mapsgl`、`bun add @aerisweather/mapsgl`

## README

[![Xweather MapsGL](https://www.xweather.com/docs/mapsgl/img/mapsgl-cover.png)](https://www.xweather.com/mapsgl)

Xweather MapsGL SDK使开发者能够快速自定义并整合各种高品质,以矢量为基础的天气映射图像和可视化,并将其纳入他们的应用和自定义解决方案. 您可以使用各种支持的第三方绘图库,使开发人员能够方便地将天气内容和视觉内容添加到他们现有的绘图平台.

活动 [Xweather API 订阅和地图](https://signup.xweather.com/) 为 MapsGL 需要.

检查出来 [Xweather 现场直播](http://live.xweather.com/)完全由MapsGL和我们 [地图 UI SDK](https://www.xweather.com/docs/maps-ui-sdk)我们也有 [地图GL 演示](https://demos.xweather.com/) 适合具体用途.

支持第三方绘图库:

-   [映射框](https://docs.mapbox.com/mapbox-gl-js/guides/)
-   [地图libre](https://maplibre.org/projects/maplibre-gl-js/)
-   [谷歌地图](https://developers.google.com/maps/documentation/javascript)
-   [传单](https://leafletjs.com/)

使用下列 MapsGL 资源来学习更多或开始 :

-   [开始](https://www.xweather.com/docs/mapsgl/getting-started)
-   [开发者文档](https://www.xweather.com/docs/mapsgl)
-   [实例](https://www.xweather.com/docs/mapsgl/examples)
-   演示词: [Xweather 现场直播](http://live.xweather.com/), (中文(简体) ), [工业演示](https://demos.xweather.com/)

## 支助

[联系支持](https://www.xweather.com/support) 包含您对 MapsGL 的任何问题、错误报告或特征建议.

## 常见问题

### @aerisweather/mapsgl 是什么？

一个易于使用,高度自定义的Javascript库,用于在WebGL的各种网络映射平台上可视化天气和自定义数据\.注意：该包已被作者标记为弃用——Starting with version 1\.8\.0, the MapsGL Javascript SDK has moved to @xweather/mapsgl\. Please upgrade your dependecies to use the latest versions\.

### 如何安装 @aerisweather/mapsgl？

在项目目录运行 npm install @aerisweather/mapsgl，或使用 pnpm add / yarn add / bun add。

### @aerisweather/mapsgl 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @aerisweather/mapsgl 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @aerisweather/mapsgl 可以商用吗？

@aerisweather/mapsgl 使用 BSD 许可。声明的许可为 BSD，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @aerisweather/mapsgl 的下载量有多少？

根据 npm 官方下载统计，@aerisweather/mapsgl 在 2026/10/05 – 2026/11/03 这 30 天内被下载 8,274 次，日均约 276 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @aerisweather/mapsgl 还在维护吗？

最新版本 1\.7\.4 发布于 2025/08/28（1\.2 年前）；至今共发布 69 个版本，其中过去 12 个月发布了 0 个；首次发布于 2023/01/13。作者已将其标记为弃用，新项目建议寻找替代方案。