# @geoarrow/deck\.gl-layers 中文文档

规范地址：https://npmcn.com/package/%40geoarrow/deck.gl-layers/

版本：0\.3\.2
npm 元数据更新时间：2026-04-15T19:31:37.936Z
中文译文更新时间：2026-11-16T04:17:17.077Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40geoarrow/deck.gl-layers
原文对照：https://npmcn.com/package/%40geoarrow/deck.gl-layers/?lang=original
项目主页：https://github.com/geoarrow/deck.gl-layers#readme
源码仓库：https://github.com/geoarrow/deck.gl-layers

弃用说明：This package has been renamed to @geoarrow/deck\.gl-geoarrow

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

- 包体积（解压后）：950 kB，60 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：apache-arrow \>=15，@deck\.gl/core ^9\.0\.12，@deck\.gl/layers ^9\.0\.12，@math\.gl/polygon ^3\.6\.2，@deck\.gl/geo-layers ^9\.0\.12，@deck\.gl/aggregation-layers ^9\.0\.12
- 首次发布：2023-09-29T17:34:41.669Z
- 最新版本发布：2026-04-15T14:56:08.311Z
- 近 30 天下载量：10681（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：33（近 12 个月 1 个）

## 中文简介

将大型地理空间数据集用于 [甲板.gl (英语)](https://deck.gl/),通过 [地理箭头](https://geoarrow.org/)。 。 。 .

## 安装

```sh
npm install @geoarrow/deck.gl-layers
```

也可以使用：`pnpm add @geoarrow/deck.gl-layers`、`yarn add @geoarrow/deck.gl-layers`、`bun add @geoarrow/deck.gl-layers`

## README

# @geoarrow/deck.gl-layers (英语)

将大型地理空间数据集用于 [甲板.gl (英语)](https://deck.gl/),通过 [地理箭头](https://geoarrow.org/)。 。 。 .

这只是一个 _胶水库_ 到甲板. gl. (英语). 它产生与上游甲板相同的层对象. gl ,但使用 a [低级二进制接口](https://deck.gl/docs/developer-guide/performance#supply-attributes-directly) 表现最好 直接使用二进制接口是很容易搞砸的. 相反,层类暴露于 `@geoarrow/deck.gl-layers` 专注于使进程易于使用并验证用户输入,并在头罩通关缓冲器下到甲板.gl的二进制接口.

![](https://npmcn.com/package/%40geoarrow/deck.gl-layers/assets/hero.jpg)

320万点a `GeoArrowScatterplotLayer`。 。 。 .

## 特征

-   **快点**: 直接从一个 [箭头联署材料](https://www.npmjs.com/package/apache-arrow) [`Table`](https://arrow.apache.org/docs/js/classes/Arrow_dom.Table.html) 使用 [date.gl 二进制数据接口](https://deck.gl/docs/developer-guide/performance#supply-attributes-directly)。 。 。 .
-   **内存效率**:没有中间数据表示,也没有垃圾收集机间接费用.
-   **全层定制**:使用与上游甲板.gl层文档相同的层属性. 任意 _访问器_ (层属性前缀为: `get*`)可以通过箭头 [`Vector`](https://arrow.apache.org/docs/js/classes/Arrow_dom.Vector.html)。 。 。 .
-   **输入验证**。验证可通过 `_validate` 属性.
-   **多条形多边形三角形**当渲染多边形层时,一个进程叫做 [多边形三角形](https://en.wikipedia.org/wiki/Polygon_triangulation) 必须在CPU上实现,然后才能将数据复制到GPU。 通常,这可以阻断主线几秒钟,但 `GeoArrowSolidPolygonLayer` 将在8个网络工作人员中完成这项工作.
-   **渐进式支持**。对于Arrow IPC 和 Parquet 等可流动的数据格式,您可以在数据负载时使每个块的地理箭层成像.

## 实例

独立实例存在于 [`examples/`](https://npmcn.com/package/%40geoarrow/deck.gl-layers/examples/) 目录。 如果运行有困难, 请创建一个问题 .

计划在可观察号上提供更多的托管实例.

## 提供接入者

所有甲板.gl地层具有两种属性: ["招标选项"](https://deck.gl/docs/api-reference/layers/scatterplot-layer#render-options) ——常数属性跨一层——和"数据存取器"——可以跨行变化的属性. 访问者是任何前缀属性 `get`一样 `GeoArrowScatterplotLayer`是因为 `getFillColor`。 。 。 .

与 `@geoarrow/deck.gl-layers` 具体来说,通过这些数据访问器有两种方式,要么作为预计算列,要么在"箭"数据上带有函数回调.

### 预计算箭头列

如果您有箭头列([`Vector`](https://arrow.apache.org/docs/js/classes/Arrow_dom.Vector.html) 在Arrow JS术语中,您可以直接传递到一层:

```ts
import { Table } from "apache-arrow";
import { GeoArrowScatterplotLayer } from "@geoarrow/deck.gl-layers";

const table = new Table(...);
const deckLayer = new GeoArrowScatterplotLayer({
  id: "scatterplot",
  data: table,
  /// Geometry column
  getPosition: table.getChild("geometry")!,
  /// Column of type FixedSizeList[3] or FixedSizeList[4], with child type Uint8
  getFillColor: table.getChild("colors")!,
});
```

譬如说, [龙板](https://github.com/developmentseed/lonboard) 为所有属性计算 Python 一侧的箭头列,使终端用户具备全部能力 Python. 然后,这些柱子被序列化到Python 以及由此产生的 `arrow.Vector` 传递到相关层.

### 函数存取器

GeoArrow 层接受一个带对象的回调 `index` 财务报告和审定财务报表 `data`。 。 。 . `data` 是一个 `arrow.RecordBatch` 对象(输入的垂直部分) `Table`),以及 `index` 是该批中当前行的位置索引。 在 TypeScript 中,您应该看到准确的类型检查.

```ts
const deckLayer = new GeoArrowPathLayer({
  id: "geoarrow-path",
  data: table,
  getColor: ({ index, data, target }) => {
    const recordBatch = data.data;
    const row = recordBatch.get(index)!;
    return COLORS_LOOKUP[row["scalerank"]];
  },
}),
```

整个例子在 [`examples/multilinestring/app.tsx`](https://npmcn.com/package/%40geoarrow/deck.gl-layers/examples/multilinestring/app.tsx)。 。 。 .

您也可以使用指派到 `target` 如本报告所述,减少垃圾收集器间接费用的道具 [deck.gl 性能指南](https://deck.gl/docs/developer-guide/performance#supply-binary-blobs-to-the-data-prop)。 。 。 .

## 数据加载

要使用此库创建 dace. gl 层, 您需要先将 GeoArrow 格式化的数据输入浏览器, 下面讨论 .

[OGR/全球司](https://gdal.org/) 用于在后端的数据格式中转换,它包括两个 [地理箭头](https://gdal.org/drivers/vector/arrow.html#vector-arrow) 财务报告和审定财务报表 [地标](https://gdal.org/drivers/vector/parquet.html) 司机们 过 `-lco GEOMETRY_ENCODING=GEOARROW` 转换为Arrow或Parquet文件,以便将几何存储在地理箭头-内生几何列中.

### 箭头 IPC

如果您已经拥有了箭头的 IPC 文件( 也叫 Feather 文件) , 并带有地理箭头几何栏, 您可以使用 [`apache-arrow`](https://www.npmjs.com/package/apache-arrow) 要装入这些文件.

```ts
import { tableFromIPC } from "apache-arrow";
import { GeoArrowScatterplotLayer } from "@geoarrow/deck.gl-layers";

const resp = await fetch("url/to/file.arrow");
const jsTable = await tableFromIPC(resp);
const deckLayer = new GeoArrowScatterplotLayer({
  id: "scatterplot",
  data: jsTable,
  /// Replace with the correct geometry column name
  getPosition: jsTable.getChild("geometry")!,
});
```

注意这些 IPC 文件必须保存 **未压缩** (至少不是内部压缩). 截至v14,Arrow JS目前不支持以内部压缩方式加载IPC文件.

### 公园

如果您有一个 Parquet 文件, 几何柱被存储为 _地理箭头_ 编码(即不作为带有 WKB 编码的相位元的二进制列),可以使用相位元 `parquet-wasm` 库可以装入这些文件.

```ts
import { readParquet } from "parquet-wasm"
import { tableFromIPC } from "apache-arrow";
import { GeoArrowScatterplotLayer } from "@geoarrow/deck.gl-layers";

const resp = await fetch("url/to/file.parquet");
const arrayBuffer = await resp.arrayBuffer();
const wasmTable = readParquet(new Uint8Array(arrayBuffer));
const jsTable = tableFromIPC(wasmTable.intoIPCStream());
const deckLayer = new GeoArrowScatterplotLayer({
  id: "scatterplot",
  data: jsTable,
  /// Replace with the correct geometry column name
  getPosition: jsTable.getChild("geometry")!,
});
```

下面关于加载 GeoParquet 1.0 文件的说明, 这些文件有 WKB 编码的几何美图, 需要解码后才能使用 `@geoarrow/deck.gl-layers`。 。 。 .

### 地标

最初版本 [`@geoarrow/geoparquet-wasm`](https://www.npmjs.com/package/@geoarrow/geoparquet-wasm) 库被发布,它读取 GeoParquet 文件到 GeoArrow 内存.

```ts
import { readGeoParquet } from "@geoarrow/geoparquet-wasm";
import { tableFromIPC } from "apache-arrow";
import { GeoArrowScatterplotLayer } from "@geoarrow/deck.gl-layers";

const resp = await fetch("url/to/file.parquet");
const arrayBuffer = await resp.arrayBuffer();
const wasmTable = readGeoParquet(new Uint8Array(arrayBuffer));
const jsTable = tableFromIPC(wasmTable.intoTable().intoIPCStream());
const deckLayer = new GeoArrowScatterplotLayer({
  id: "scatterplot",
  data: jsTable,
  /// Replace with the correct geometry column name
  getPosition: jsTable.getChild("geometry")!,
});
```

如果你用它撞到一个错误 `@geoarrow/geoparquet-wasm`请创建可复制的错误报告 [这里](https://github.com/geoarrow/geoarrow-rs/issues/new)。 。 。 .

### 平面胶纸

最初版本 [`@geoarrow/flatgeobuf-wasm`](https://www.npmjs.com/package/@geoarrow/flatgeobuf-wasm) 库被发布,它将一个 FlatGeobobuf 文件读取到 GeoArrow 内存。 截至0.2.0-β.1版本,此库尚不支持远程文件,并期望完整的FlatGeobuf文件存在于内存中.

```ts
import { readFlatGeobuf } from "@geoarrow/flatgeobuf-wasm";
import { tableFromIPC } from "apache-arrow";
import { GeoArrowScatterplotLayer } from "@geoarrow/deck.gl-layers";

const resp = await fetch("url/to/file.fgb");
const arrayBuffer = await resp.arrayBuffer();
const wasmTable = readFlatGeobuf(new Uint8Array(arrayBuffer));
const jsTable = tableFromIPC(wasmTable.intoTable().intoIPCStream());
const deckLayer = new GeoArrowScatterplotLayer({
  id: "scatterplot",
  data: jsTable,
  /// Replace with the correct geometry column name
  getPosition: jsTable.getChild("geometry")!,
});
```

如果你用它撞到一个错误 `@geoarrow/flatgeobuf-wasm`请创建可复制的错误报告 [这里](https://github.com/geoarrow/geoarrow-rs/issues/new)。 。 。 .

## 常见问题

### @geoarrow/deck\.gl-layers 是什么？

将大型地理空间数据集用于 甲板\.gl \(英语\),通过 地理箭头。 。 。 \.注意：该包已被作者标记为弃用——This package has been renamed to @geoarrow/deck\.gl-geoarrow

### 如何安装 @geoarrow/deck\.gl-layers？

在项目目录运行 npm install @geoarrow/deck\.gl-layers，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：apache-arrow（\>=15）、@deck\.gl/core（^9\.0\.12）、@deck\.gl/layers（^9\.0\.12）、@math\.gl/polygon（^3\.6\.2）、@deck\.gl/geo-layers（^9\.0\.12）、@deck\.gl/aggregation-layers（^9\.0\.12）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @geoarrow/deck\.gl-layers 支持 TypeScript 吗？

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

### @geoarrow/deck\.gl-layers 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @geoarrow/deck\.gl-layers 可以商用吗？

@geoarrow/deck\.gl-layers 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @geoarrow/deck\.gl-layers 的下载量有多少？

根据 npm 官方下载统计，@geoarrow/deck\.gl-layers 在 2026/10/16 – 2026/11/14 这 30 天内被下载 10,681 次，日均约 356 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @geoarrow/deck\.gl-layers 还在维护吗？

最新版本 0\.3\.2 发布于 2026/04/15（7 个月前）；至今共发布 33 个版本，其中过去 12 个月发布了 1 个；首次发布于 2023/09/30。作者已将其标记为弃用，新项目建议寻找替代方案。

