# @2gis/deck2gis-layer 中文文档

规范地址：https://npmcn.com/package/%402gis/deck2gis-layer/

版本：3\.0\.19
npm 元数据更新时间：2026-10-30T09:26:25.739Z
中文译文更新时间：2026-11-06T13:28:44.333Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%402gis/deck2gis-layer
原文对照：https://npmcn.com/package/%402gis/deck2gis-layer/?lang=original

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

- 包体积（解压后）：160 kB，23 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：3 个
- peer 依赖：@2gis/mapgl ^1\.70\.1
- 首次发布：2022-10-03T21:32:35.012Z
- 最新版本发布：2026-10-30T09:26:24.753Z
- 近 30 天下载量：3134（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：50（近 12 个月 7 个）

## 中文简介

Deck.gl 层执行为 2gis 映射

## 安装

```sh
npm install @2gis/deck2gis-layer
```

也可以使用：`pnpm add @2gis/deck2gis-layer`、`yarn add @2gis/deck2gis-layer`、`bun add @2gis/deck2gis-layer`

## README

# 甲板2gis莱尔

Deck.gl 层执行为 2gis 映射

## 使用量

与国家预防机制安装

```shell
npm install @2gis/deck2gis-layer
```

> **重要**
> 
> 当前版本 `Deck2gisLayer` 插件只兼容 `deck.gl@^8`

### 使用# 甲板2gisLayer

导入甲板2gisLayer插件到您的项目并使用它 :

```typescript
import { Deck2gisLayer, initDeck } from '@2gis/deck2gis-layer';
// Init mapgl
const map = new mapgl.Map('container', {
    center: [55.31878, 25.23584],
    zoom: 13,
    key: 'Your API access key',
});
// Init deck.gl
const deck = initDeck(map, Deck, { antialiasing: 'msaa' });

// create Deck2gisLayer
const layer = new Deck2gisLayer<HexagonLayer<any>>({
    id: 'deckgl-HexagonLayer',
    deck,
    type: HexagonLayer,
    data,
    antialiasing: true,
    parameters: { depthTest: true },
    radius: 480,
    getPosition: (d: any) => [d.point.lon, d.point.lat],
});

// add deck layer into map
 map.addLayer(deckLayer);
```

## 捐款

Deck2gisLayer 使用 github- flow来接受并合并修正和改进. 基本过程是:

-   叉取还相.
-   创建分行.
-   添加或修补一些代码.
-   **运行测试套件 `npm run test:screenshots` 保证一切正常**
-   为您的新代码添加一些测试或修复破解的测试 .
-   提交按下( P) .
-   创建新的拉取请求到原始 repo .

测试失败后拉动请求将不被接受 . 另外,如果修改软件包或添加到 `package.json`,确保您使用 `npm` 更新 `package-lock.json`。 。 。 .

## 测试

### 运行测试

```shell
npm run test:screenshots
```

## 释放

### 无

1.  通过运行更新软件包版本 `npm version patch|minor|major`。此命令返回一个新的软件包版本。 假设是1.2.3
2.  推动更改为 github 并将其合并到“ master” 分支
3.  转到 [https://github.com/2gis/deck2gisLayer/releases/ new (中文(简体) )](https://github.com/2gis/deck2gisLayer/releases/new)
4.  点击“ 选择标签” 按钮, 按照软件包中的版本创建新标签 。 json, 例如 v1.2.3
5.  确定释放目标为"主"分会
6.  粘贴释放标记到“ 释放标题” 字段, 例如 v1.2.3
7.  添加释放描述
8.  单击“ Publish 释放” 按钮
9.  转到 [https://github.com/2gis/deck2gisLayer/ 行动](https://github.com/2gis/deck2gisLayer/actions) 并等待完成发布工作流程

### 演示

1.  执行 `npm run deploy-gh-pages` 在本地的机器上,您想要作为演示部署.

## 常见问题

### @2gis/deck2gis-layer 是什么？

Deck\.gl 层执行为 2gis 映射

### 如何安装 @2gis/deck2gis-layer？

在项目目录运行 npm install @2gis/deck2gis-layer，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@2gis/mapgl（^1\.70\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @2gis/deck2gis-layer 支持 TypeScript 吗？

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

### @2gis/deck2gis-layer 支持 ESM 还是 CommonJS？

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

### @2gis/deck2gis-layer 可以商用吗？

@2gis/deck2gis-layer 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @2gis/deck2gis-layer 的下载量有多少？

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

### @2gis/deck2gis-layer 还在维护吗？

最新版本 3\.0\.19 发布于 2026/10/30（8 天前）；至今共发布 50 个版本，其中过去 12 个月发布了 7 个；首次发布于 2022/10/04。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。