GeoD CLI GeoD Use this command to install GeoD CLI with WinGet:
winget install --id=GeoD.CLI -e Copy WinGet command to clipboard GeoD CLI accepts structured JSON requests to plan data acquisition, download GeoTIFF and GeoJSON data bundles, and inspect their manifests and hashes.
Data acquisition does not require the GeoD desktop application, Rust, Node.js, or GDAL. Optional GeoStyle import and browser rendering require a compatible GeoStyle service, Node.js 22 or later, and Chrome or Edge; these are not included in this package.
Version 0.1.1 is the first public Windows x64 preview. Map data is downloaded separately from the configured providers.
> [!IMPORTANT]
> ## 📣 作者正在求职 · 北京
>
> AI 应用开发 · Agent 应用开发 · AI 产品全栈
>
> 我是高鹏彬，有约 6 年软件开发经验。如果你们团队正在招人，欢迎联系，也感谢帮忙内推或转发！
>
> ### 📄 查看简历 PDF · ✉️ 联系我
>
> 查看我的项目与个人介绍 → · 邮箱：1804287165@qq.com
简体中文 · English
官网 下载安装 Discussions Issues
GeoD is a free and open-source desktop tool for browsing OpenStreetMap layers, downloading OSM vector features through Overpass, and exporting data from user-authorized XYZ tile services. It runs on Windows, macOS and Linux.
GeoD 是一款免费开源的跨平台地理空间数据工具，支持浏览 OpenStreetMap 底图、通过 Overpass 下载 OSM 矢量要素，以及从用户合法授权的 XYZ 瓦片服务导出 GeoTIFF 等本地格式。
GeoD 已收录于社区维护的 OSM Apps Catalog ；该目录收录不代表 OpenStreetMap Foundation 对本项目的官方认可或背书。
> 使用提示 ：本工具是基于开源协议发布的桌面客户端，不内置任何地图数据 。所有数据来自使用者自行配置的第三方服务，请自行获取合法授权并遵守相关条款与法规 。下载所得数据版权归原数据方所有。详见 使用条款与免责声明 。
下载安装
命令行调用 / AI 工具接入： GeoD CLI Windows x64 公开预览版 提供独立安装程序、便携 ZIP 和 npm 包，安装后可运行 geod plan/fetch/inspect。数据获取不依赖桌面端。详见 包管理器安装 与官网独立下载示例 ；浏览器在线体验 仅提供带水印预览。
Windows x64 已安装 Node.js 18+ 时，可直接运行 npm install -g geod-cli，再运行 geod --help 查看用法。
前往 Latest Release 下载最新稳定版。GeoD 免费提供 Windows、macOS 和 Linux 安装包：
每个版本的更新内容和校验信息以 Releases 页面为准。
> macOS 首次打开提示"无法验证开发者"时：右键安装包 → 打开，或在「系统设置 → 隐私与安全性」放行。
功能总览
影像瓦片下载
内置 OpenStreetMap（OSM）标准底图用于交互预览，并提供 ArcGIS、天地图、Carto、高德等图源配置
支持自定义任意 {z}/{x}/{y} 模板，可配置 Subdomains、Referer、API Key
多任务并行 + 可调并发（10–100），实时进度
缩放级别区间下载，自动按图源最大级别约束
导出 GeoTIFF（带地理坐标，可选 LZW / Deflate 压缩）/ PNG / JPEG
按多边形边界裁剪（透明背景）
> OpenStreetMap 标准瓦片服务器不允许批量抓取、预取或离线下载。此类任务请使用自建服务，或选择明确允许下载和离线使用的服务商。详见 OSMF Tile Usage Policy ；使用 OSM 数据时还须遵守 ODbL 与署名要求 。
矢量瓦片
MapboxVector / Mapbox GL Style 数据源
区域选择 + 缩放级别批量下载
模式独立的数据源记忆
3D Tiles
Cesium Ion 资产、Google 3D Tiles（全球倾斜摄影）、自定义 URL
在 3D 视图框选区域裁剪下载
递归解析子 tileset，完整下载多层级 LOD
下载后 URI 自动本地化，支持离线 3D 浏览
DEM 数字高程模型
多源 DEM（COP30 / SRTM 等）
按区域批量下载并拼接
Esri Wayback 历史影像
浏览 Esri 卫星影像所有历史版本
时间轴交互，按拍摄日期切换
支持下载历史时刻的瓦片
区域选择
地名搜索定位
中国省 / 市 / 区县三级行政区划
上传 GeoJSON / Shapefile（.zip / .shp + .shx + .dbf） / KML / KMZ
地图绘制矩形或多边形
任务系统
多任务并行，独立进度与日志
崩溃重启可恢复任务
下载历史，一键打开输出文件夹
开发
环境要求
运行（开发模式）
# 安装前端依赖
npm ci --prefix frontend
# 启动 Tauri 开发服务（自动 vite dev + cargo build）
cd src-tauri
cargo tauri dev
构建发布
cd src-tauri
cargo tauri build
产物位于 src-tauri/target/release/bundle/。
项目结构
geo-downloader/
├── src-tauri/ # Rust 后端 (Tauri 2.x)
│ └── src/
│ ├── lib.rs / main.rs
│ ├── commands.rs # Tauri 命令入口
│ ├── config.rs # 内置图源 + 全局配置
│ ├── tile.rs # 瓦片坐标计算
│ ├── downloader.rs # 异步并发下载器
│ ├── merger.rs # 拼接 / 裁剪
│ ├── exporter.rs # GeoTIFF / PNG / JPEG 导出
│ ├── streaming_tiff.rs # BigTIFF 流式写入器
│ ├── wayback.rs # Esri Wayback
│ ├── tiles3d/ # 3D Tiles 模块
│ ├── task.rs / history.rs / settings.rs
│ └── ...
├── frontend/ # React 19 + Vite + shadcn/ui + Tailwind
│ └── src/
├── site/ # 官网静态站（Cloudflare Pages）
└── docs/ # 设计 / 工作日志
配置说明
在应用「设置 / 高级选项」中可配置：
天地图 / Cesium Ion / Google API Token代理 ：访问 Google 等海外图源时启用并发数 ：根据网络稳定性调整TIFF 压缩 ：无压缩 / LZW / Deflate
社区与反馈
更新历史
完整发布说明见 Releases 。近期亮点：
v3.4.0 ：前端整体迁移到 React 19 + shadcn/ui；浏览即缓存（browse-as-cache）；3D Tiles 表面拾取与 Cesium Ion 自动预览；Wayback 时间轴重设计；矢量区域选择器v3.3.x ：Wayback 历史影像批量下载；DEM 下载模块v3.2.x ：TIFF 压缩三选一；任务日志系统；断点续传增强；BigTIFF 兼容性修复v3.0.0 ：产品更名 GeoDownloader；3D Tiles 下载与离线预览
许可证
GeoD 源代码按照 MIT License 免费开放使用。第三方地图与数据仍受各自许可和使用条款约束。
Copyright © 2025–2026 gaopengbin
赞助
如果这个项目对你有帮助，欢迎请作者喝杯咖啡。
感谢支持
感谢每一位愿意支持 GeoD 的朋友。金额不分大小，每一份认可都会被认真记下。
日期 支持者 金额 2026-08-13 林冲 ¥20.00 2026-07-20 Hi-cc ¥0.01 2026-05-10 lulu ¥10.00 2026-05-08 jojo ¥19.90 2026-04-22 可以超载 ¥9.90 2026-04-20 风停在左肩 ¥10.00 2026-04-18 注定风雨兼程😊 ¥10.00 2026-04-13 邓 ¥10.00 2026-04-10 jojo ¥3.99
目前共记录 9 次支持，累计 ¥93.80 。完整记录与说明见 GeoD 支持者记录 。如希望匿名、更改昵称或移除记录，请联系作者。
Star History
