@geoarrow/deck.gl-layers

中文文档
0.3.2发布于 2026/04/15MITTypeScriptESM + CJS近 30 天下载 1.1万

将大型地理空间数据集用于 甲板.gl (英语),通过 地理箭头。 。 。 .

此软件包已被标记为弃用

This package has been renamed to @geoarrow/deck.gl-geoarrow

中文使用文档
文档目录10 节
  1. 特征
  2. 实例
  3. 提供接入者
  4. 预计算箭头列
  5. 函数存取器
  6. 数据加载
  7. 箭头 IPC
  8. 公园
  9. 地标
  10. 平面胶纸

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

将大型地理空间数据集用于 甲板.gl (英语),通过 地理箭头。 。 。 .

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

320万点a GeoArrowScatterplotLayer。 。 。 .

特征

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

实例

独立实例存在于 examples/ 目录。 如果运行有困难, 请创建一个问题 .

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

提供接入者

所有甲板.gl地层具有两种属性: "招标选项" ——常数属性跨一层——和"数据存取器"——可以跨行变化的属性. 访问者是任何前缀属性 get一样 GeoArrowScatterplotLayer是因为 getFillColor。 。 。 .

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

预计算箭头列

如果您有箭头列(Vector 在Arrow JS术语中,您可以直接传递到一层:

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")!,
});

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

函数存取器

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

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。 。 。 .

您也可以使用指派到 target 如本报告所述,减少垃圾收集器间接费用的道具 deck.gl 性能指南。 。 。 .

数据加载

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

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

箭头 IPC

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

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 库可以装入这些文件.

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 库被发布,它读取 GeoParquet 文件到 GeoArrow 内存.

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请创建可复制的错误报告 这里。 。 。 .

平面胶纸

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

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请创建可复制的错误报告 这里。 。 。 .

版本与发布记录

@geoarrow/deck.gl-layers 共发布 33 个版本,首次发布于 2023/09/30;过去 12 个月发布了 1 个版本。

版本发布日期距今
0.3.2latest2026/04/157 个月前
0.4.0-beta.6beta2025/10/301 年前
0.4.0-beta.52025/10/301 年前
0.4.0-beta.42025/10/181.1 年前
0.4.0-beta.32025/10/111.1 年前
0.4.0-beta.22025/10/111.1 年前

关于 @geoarrow/deck.gl-layers 的常见问题

@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。作者已将其标记为弃用,新项目建议寻找替代方案。