快速开始 on async-geotiff

环境要求

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

库与示例

Rust 1.88 或更高版本，与 Cargo.toml 保持一致。
默认 feature 集需要系统 libproj 9.x。
从仓库开发时需要 Git。

macOS：

brew install proj

Debian 或 Ubuntu：

快速上手

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

克隆并运行

git clone https://github.com/mapseekai/async-geotiff-rs.git
cd async-geotiff-rs
COG_URL='https://raw.githubusercontent.com/cogeotiff/rio-tiler/0b08b7f35a8b639cee2f35a0cb565034f7b55bfd/tests/fixtures/cog.tif'
cargo run --release --example serve -- "$COG_URL"

固定提交版本的 rio-tiler 测试文件约 800 KiB，是一个公开且支持 Range 的 COG，适合首次运行验证。冒烟测试完成后再替换为自己的 COG。服务默认监听 127.0.0.1:8080，并在启动成功后打印查看器与瓦片 URL。

作为库使用

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

仓库当前设置了 publish = false，因此其他本地项目在开发期需要使用路径依赖。先在仓库旁创建应用；如果目录布局不同，请调整相对路径：

# 从 async-geotiff-rs 检出目录开始：
cd ..
cargo new async-geotiff-demo
cd async-geotiff-demo

[dependencies]
async-geotiff = { path = "../async-geotiff-rs" }
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }

如果要避免系统 libproj，同时保留示例服务使用的 mosaic API，可以在路径依赖上设置 default-features = false, features = ["mosaic"]；此时无法执行通用 CRS 转换。