# @galaxyproject/rustgis 中文文档

规范地址：https://npmcn.com/package/%40galaxyproject/rustgis/

版本：0\.0\.1
npm 元数据更新时间：2026-10-27T08:35:20.587Z
中文译文更新时间：2026-11-15T21:38:20.410Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40galaxyproject/rustgis
原文对照：https://npmcn.com/package/%40galaxyproject/rustgis/?lang=original

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

- 包体积（解压后）：40.4 MB，18 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-10-27T08:14:32.514Z
- 最新版本发布：2026-10-27T08:35:20.321Z
- 近 30 天下载量：5173（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：3（近 12 个月 3 个）

## 中文简介

用于银河系统的 RustGIS 浏览器 GIS,包括 LAS/LAZ 和被推迟的 HTTP(S) 数据集

## 安装

```sh
npm install @galaxyproject/rustgis
```

也可以使用：`pnpm add @galaxyproject/rustgis`、`yarn add @galaxyproject/rustgis`、`bun add @galaxyproject/rustgis`

## README

# 银河轨道导航系统

装满了 [RustGIS (俄罗斯语)](https://github.com/opengeos/RustGIS) 银河系中的浏览器应用程序. 打开历史数据集以探索地图、图层样式、属性表格、编辑、布局和 浏览器支持的分析. 该应用程序运行在银河源上,没有额外的GIS服务器.

支持的数据集扩展名 : `geojson`, (中文(简体) ), `las`, (中文(简体) ), `laz` 财务报告和审定财务报表 `geocsv`,Galaxy为 CSV 指定的 带有纬度和经度列的文件。 银河系统没有GeoTIFF、GeoParquet或 已拉链的形状文件及其通用 `csv`, (中文(简体) ), `tsv`, (中文(简体) ), `tiff`, (中文(简体) ), `parquet` 财务报告和审定财务报表 `zip` 大部分没有 地理,所以插件不为它们提供本身. 原生GDAL/DuckDB和 数据库特性在此浏览器构建中没有.

保存并导出使用 RustGIS 的正常本地下载. 在浏览器中进行更改 不被自动保存到 Galaxy 可视化或上传到历史中。 使用 应用程序在离开查看器前是保存/输出.

## LAS、LAZ和延期数据

LAS/LAZ,包括COPC LAZ,作为点层开放,具有高地,强度,分类, 返回编号和 RGB 当存在。 浏览器保留了50万个抽样点 最多考虑4000万个LAZ分来解压/取样. 远程 LiDAR 文件全下载,有256个米B下载限制. 未使用COPC空间指数. 对于更大的云,在取景前生成更小的取材. 缺少/不支持坐标 系统在 RustGIS 中报告;检查点云出现在预期位置.

对于已准备好的数据集,适配器使用Galaxy认证的显示 URL. 用于延迟数据集 它获取元数据,然后将主源的 HTTP(S) URL 直接传递到 RustGIS. 银河 未实现延迟数据集。 这仍然将远程LAZ下载到浏览器中. 外部来源必须允许CORS从Galaxy提出的请求,并提供无Galaxy的访问权限 会话证书(例如公开或签名的HTTPS URL). 已签名的查询字符串是 保留了下来 HTTPS Galaxy页面需要HTTPS来源. Galaxy 文件源 URI, 嵌入式登录 证书和已申报的源码转换均予拒绝,但附有解释.

存储数据集使用无扩展的Galaxy显示URL并全下载. 下载 限制适用于他们.

## 构建和运行

需要Node.js 22+; 不需要货物/Trunk来建造银河适配器.

```sh
npm ci
npm run build
npm run dev
```

默认开发页面打开捆绑的GeoJSON样本数据. 现有银河系统 会话, 使用 `?dataset_id=ENCODED_ID&root=https://your-galaxy.example/galaxy/` 从银河系 源代码。 用于本地开发 相对于本地银河系统,设定 `GALAXY_ROOT=http://127.0.0.1:8080` 在此之前 `npm run dev`; 虚拟代理 `/api` 而用户必须通过此程序拥有有效的会话 源代码。 没有 API 密钥捆绑成资产 . `?webgl` 在演示页上强制WebGL2.

`npm run prepare:vendor` 下载 **准确预建的上游应用程序** 编号 [上游地区](https://npmcn.com/package/%40galaxyproject/rustgis/upstream.json),验证每个文件的 Git blob ID 和长度。 来源 修订版为 `797ccab15bf97a2f4c3cbda689bc5a2447ef1a8d` (RustGIS 0.4.0);其出版的建筑是: `cb2c8a3823b51838809d6e211a300eca8dee8093` 内 `opengeos/rustgis-web`没有改变的瓦斯姆, Java 脚本和片断被缓存到下面 `.vendor/` 并在 `public/vendor/rustgis/`。 。 。 . 最早的构建下载了约39个米B;随后的构建验证了缓存并下线工作. 建造失败从不默默地取代新的上游。 需要更新应用程序 更新源/构建修改和每个文件散列,然后重运行浏览器测试.

当地 `viewer/` shell提供相对的资产路径并报告网络故障. 没错 不包括公共部署的分析人员、名单或服务人员。 任择行动 rustGIS内部(bastmaps,字体,插件,外部服务或AI)可以联系他们的提供者. 生产包的 `static/` 输出包括完整的浏览器应用程序,它的Apache-2.0 许可证和第三方通知。 只有"银河"适配器是麻省理工学院的许可.

银河系统通过注射初始化可视化 `index.js` 财务报告和审定财务报表 `index.css` 变成 `about:blank` 边框为 `#app[data-incoming]`。切入点解决了视图相对 并使用所提供的Galaxy root,包括部署前缀. 上游需要光线 `?embed` 旗帜。 包装检查信件的来源和来源; 当地人 `ready` 财务报告和审定财务报表 `project` 信件分别确认启动和实际导入 .

## 测试

```sh
npx playwright install chromium
npm test
```

Playwright 建造并服务于制作的艺术品, 复制银河的剧本注入 在前缀 URL 下进入空白框。 测试使用 **真实WASM 引擎** 与合成 GeoJSON、LAS、LAZ和GeoCSV装置。 它们包括经会议认证的存储 数据、直接延后源和保存的已签名的 URL、本地的 LiDAR 分类解码, GeoCSV 点、源/存取/大小错误、伪造消息、嵌入式资产 道路、登记和许可证。 所有外部服务 测试不需要运行银河系统或公共数据服务。 现场部署 目标Galaxy的代理、认证和对象存储路由仍需要检查.

`PLAYWRIGHT_PORT` 选择服务器端口. `PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH` 可以指点 现有铬。 软件WebGL为无头CI启用.

`tests/fixtures/berlin.las` 财务报告和审定财务报表 `berlin.laz` 包含三个生成,虚构的 LiDAR 记录 位于柏林坐标处,有2,5和6级以及高地35,48和70. 里面没有 第三方调查数据.

## 常见问题

### @galaxyproject/rustgis 是什么？

用于银河系统的 RustGIS 浏览器 GIS,包括 LAS/LAZ 和被推迟的 HTTP\(S\) 数据集

### 如何安装 @galaxyproject/rustgis？

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

### @galaxyproject/rustgis 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/galaxyproject\_\_rustgis 是否存在。

### @galaxyproject/rustgis 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @galaxyproject/rustgis 可以商用吗？

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

### @galaxyproject/rustgis 的下载量有多少？

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

### @galaxyproject/rustgis 还在维护吗？

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