# @dataforsyningen/saul 中文文档

规范地址：https://npmcn.com/package/%40dataforsyningen/saul/

版本：5\.0\.1
npm 元数据更新时间：2026-10-22T12:29:29.076Z
中文译文更新时间：2026-11-11T14:31:29.459Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：5.1 MB，20 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：2 个
- 首次发布：2022-10-18T18:15:20.457Z
- 最新版本发布：2026-10-22T12:29:28.711Z
- 近 30 天下载量：19765（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：26（近 12 个月 5 个）

## 中文简介

这是用于"Danske Skråfotos"摄影测量计算和API相互作用的独立方法集.

## 安装

```sh
npm install @dataforsyningen/saul
```

也可以使用：`pnpm add @dataforsyningen/saul`、`yarn add @dataforsyningen/saul`、`bun add @dataforsyningen/saul`

## README

# 绍尔

这是摄影测量计算和API相互作用的独立方法集,主要用于 [https://github.com/克利马达塔斯泰雷尔森/斯克拉阿福托 frontend](https://github.com/Klimadatastyrelsen/skraafoto_frontend)

您可以将这些作为您自己的网络应用程序的构件, 用于 Danske Skråfotos 与 STAC API 接口 .

## 安装

1.  通过国家预防机制安装:

```
npm i --save @dataforsyningen/saul
```

2.  创建配置文件或 Javascript 对象, 并带有适当的值, 在使用任何 SAUL 工具之前, 确保将其载入您的应用程序 。 此套件船, 有示例配置文件 : [`config.js.example`](https://npmcn.com/package/%40dataforsyningen/saul/config.js.example)

## 如何使用

这是Javascript中如何进口和使用这些公用事业的例子:

```
import auth from './config.js' // This is the path to your configuration file
import {getSTAC} from '@dataforsyningen/saul'

let response = await getSTAC('/some-stac-endpoint', auth)
console.log(response)
```

## API 文件

为了阅读这些文件,首先用JSDoc编写文件:

```
npm run docs
```

A 类 `docs` 将创建包含文档的一组 HTML 文件.

## 如何测试

从内部 `node_modules/@dataforsyningen/saul` 你可以运行 `test` 命令检查 saul 核心特性是否还在工作.

```
npm run test
```

或者,如果你有多克, 你可以运行测试在一个容器:

```shell
docker compose run --rm saul
```

## 更新本地地形模型

Saul软件包包括一个地形高地模型,作为单一的GeoTiff文件托管,用于无法从Datafordeler服务获取地形数据的事件。 要更新地形模型,只需从 Datafordeler 下载新的 GeoTiff, 并附带以下 URL( 提供您自己的用户名/ 密码) 并保存到 `/assets/dk-terrain.tiff` 在软件包目录中.

https://wcs.datafordeler.dk/DHMNedboer/dhm wcs/1.0.0/WCS?SERVICE=WCS&CVERAGE=dhm terraen&RESPONSE CRS=epsg:25832&CRS=epsg:25832&FORMAT=Gtiff&REQULEST=GetCoverage&VERSION=1.0.0&apikey=xxxxxx&pheight=1000&width=1260&bbox=430000,604000000900,6413000

## 鸣谢

SAUL根据麻省理工学院许可证提供 Skråfoto团队 @ [科发系统](https://kds.dk/)

## 常见问题

### @dataforsyningen/saul 是什么？

这是用于"Danske Skråfotos"摄影测量计算和API相互作用的独立方法集\.

### 如何安装 @dataforsyningen/saul？

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

### @dataforsyningen/saul 支持 TypeScript 吗？

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

### @dataforsyningen/saul 支持 ESM 还是 CommonJS？

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

### @dataforsyningen/saul 可以商用吗？

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

### @dataforsyningen/saul 的下载量有多少？

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

### @dataforsyningen/saul 还在维护吗？

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