参考手册 on async-geotiff

示例 HTTP API

Mon, 01 Jan 0001 00:00:00 +0000

HTTP API 属于 examples/serve.rs，不会进入库本身的依赖表面。

支持的 TMS 名称是 WebMercatorQuad 和 WorldCRS84Quad。扩展名支持 png，以及 feature 控制的 webp、jpg、jpeg。

Mon, 01 Jan 0001 00:00:00 +0000

Feature	默认	作用
`proj`	是	通过系统 `libproj` 启用通用 CRS 转换。
`mosaic`	是	启用 `MosaicTiler`、`MosaicSource`、MosaicJSON 和异步资产扇出。
`webp`	否	通过 `image` 启用无损 WebP 编码。
`jpeg`	否	启用 JPEG；由于 JPEG 没有 alpha，透明度会被压平。
`stac`	否	添加 STAC 客户端，并隐含启用 `mosaic`。
`perf-tracing`	否	发出更详细的内部耗时事件。
`tokio-console`	否	启用 Tokio Console，并隐含启用 `perf-tracing`。

示例：

Mon, 01 Jan 0001 00:00:00 +0000

以下变量配置 cargo run --example serve。它们是示例服务约定，不是库的全局配置。

变量	默认值	含义
`ASYNC_GEOTIFF_BIND`	`127.0.0.1:8080`	HTTP 服务监听地址。
`ASYNC_GEOTIFF_BLOCK_CACHE_MB`	`512`	共享解码块缓存容量（MiB），必须为正数。
`ASYNC_GEOTIFF_MAX_DECODE_TASKS`	可用并行度	最大并发解码/拼接 CPU 任务数，必须为正数。
`ASYNC_GEOTIFF_MAX_TILE_TASKS`	可用并行度	最大并发重投影/渲染 CPU 任务数，必须为正数。
`ASYNC_GEOTIFF_PREFETCH_RING`	`1`	围绕读取范围预取的原生块圈数；`0` 为关闭。
`ASYNC_GEOTIFF_SLOW_TILE_MS`	未设置	超过此正整数毫秒阈值时发出慢瓦片警告。
`ASYNC_GEOTIFF_MOSAIC`	未设置	启动时加载的 MosaicJSON 文件路径。
`ASYNC_GEOTIFF_STAC_URL`	未设置	固定 STAC API URL；需要 `stac` 及后两个变量。
`ASYNC_GEOTIFF_STAC_COLLECTION`	未设置	固定 STAC collection ID。
`ASYNC_GEOTIFF_STAC_ASSET_KEY`	未设置	固定 STAC COG 资产 key。
`ASYNC_GEOTIFF_TOKIO_CONSOLE`	关闭	使用 `tokio-console` 编译时，以 `1`、`true`、`yes` 或 `on` 启用 Tokio Console。
`RUST_LOG`	`async_geotiff=debug,warn`	示例服务的标准 tracing 过滤器。

ASYNC_GEOTIFF_MOSAIC 与 STAC 配置互斥；三个 STAC 变量必须一起提供。