> [!IMPORTANT]
> ## 📣 作者正在求职 · 北京
>
> **AI 应用开发 · Agent 应用开发 · AI 产品全栈**
>
> 我是高鹏彬，有约 6 年软件开发经验。如果你们团队正在招人，欢迎联系，也感谢帮忙内推或转发！
>
> ### [📄 查看简历 PDF](https://laogao.xyz/platform-api/public/resume/gaopengbin-ai-20260906.pdf)　·　[✉️ 联系我](mailto:1804287165@qq.com)
>
> [查看我的项目与个人介绍 →](https://github.com/gaopengbin) · 邮箱：**1804287165@qq.com**

<h1 align="center">
<img width="2172" height="724" alt="ChatGPT Image 2026年6月9日 21_38_21" src="https://github.com/user-attachments/assets/107849ff-eb30-425a-91d8-b93b9048dae7" />

</h1>

<p align="center">
  <b>简体中文</b> · <a href="README_EN.md">English</a>
</p>

<p align="center">
  <a href="https://geodownloader.pages.dev"><b>官网</b></a> ·
  <a href="https://github.com/gaopengbin/geo-downloader/releases/latest"><b>下载安装</b></a> ·
  <a href="https://github.com/gaopengbin/geo-downloader/discussions"><b>Discussions</b></a> ·
  <a href="https://github.com/gaopengbin/geo-downloader/issues"><b>Issues</b></a>
</p>

<p align="center">
  <img src="https://img.shields.io/github/v/release/gaopengbin/geo-downloader?include_prereleases&color=2563eb" alt="Latest Release">
  <img src="https://img.shields.io/github/downloads/gaopengbin/geo-downloader/total?color=brightgreen&label=downloads" alt="Total Downloads">
  <img src="https://img.shields.io/github/downloads/gaopengbin/geo-downloader/latest/total?label=latest%20downloads" alt="Latest Downloads">
  <img src="https://img.shields.io/github/stars/gaopengbin/geo-downloader?style=flat" alt="Stars">
  <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License">
</p>

<p align="center">
  <img src="https://img.shields.io/badge/Windows-x64-0078D6?logo=windows" alt="Windows">
  <img src="https://img.shields.io/badge/macOS-arm64%20%7C%20x64-000000?logo=apple" alt="macOS">
  <img src="https://img.shields.io/badge/Linux-amd64-FCC624?logo=linux&logoColor=black" alt="Linux">
  <img src="https://img.shields.io/badge/tauri-2.x-24C8DB?logo=tauri" alt="Tauri">
  <img src="https://img.shields.io/badge/rust-1.77+-orange?logo=rust" alt="Rust">
</p>

**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](https://osm-apps.org/?app=1308821580&page=app)；该目录收录不代表 OpenStreetMap Foundation 对本项目的官方认可或背书。

> **使用提示**：本工具是基于开源协议发布的桌面客户端，**不内置任何地图数据**。所有数据来自使用者自行配置的第三方服务，**请自行获取合法授权并遵守相关条款与法规**。下载所得数据版权归原数据方所有。详见 [使用条款与免责声明](https://geodownloader.pages.dev/disclaimer.html)。

---

## 下载安装

**命令行调用 / AI 工具接入：** [GeoD CLI Windows x64 公开预览版](https://github.com/gaopengbin/geo-downloader/releases/tag/geod-cli-v0.1.1) 提供独立安装程序、便携 ZIP 和 npm 包，安装后可运行 `geod plan/fetch/inspect`。数据获取不依赖桌面端。详见 [包管理器安装](docs/geod-cli-package-managers.md)与[官网独立下载示例](https://geod.laogao.xyz/tools#cli-guide)；[浏览器在线体验](https://geod.laogao.xyz/geod/cli) 仅提供带水印预览。

Windows x64 已安装 Node.js 18+ 时，可直接运行 `npm install -g geod-cli`，再运行 `geod --help` 查看用法。

前往 [Latest Release](https://github.com/gaopengbin/geo-downloader/releases/latest) 下载最新稳定版。GeoD 免费提供 Windows、macOS 和 Linux 安装包：

| 平台 | 安装包 | 下载入口 |
|---|---|---|
| Windows x64 | `GeoDownloader_*_windows_x64-setup.exe` | [Latest Release](https://github.com/gaopengbin/geo-downloader/releases/latest) |
| macOS Apple Silicon | `GeoDownloader_*_macos_arm64.dmg` | [Latest Release](https://github.com/gaopengbin/geo-downloader/releases/latest) |
| macOS Intel | `GeoDownloader_*_macos_x64.dmg` | [Latest Release](https://github.com/gaopengbin/geo-downloader/releases/latest) |
| Linux (Debian/Ubuntu) | `GeoDownloader_*_linux_amd64.deb` | [Latest Release](https://github.com/gaopengbin/geo-downloader/releases/latest) |
| Linux (AppImage) | `GeoDownloader_*_linux_amd64.AppImage` | [Latest Release](https://github.com/gaopengbin/geo-downloader/releases/latest) |

每个版本的更新内容和校验信息以 [Releases](https://github.com/gaopengbin/geo-downloader/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](https://operations.osmfoundation.org/policies/tiles/)；使用 OSM 数据时还须遵守 [ODbL 与署名要求](https://www.openstreetmap.org/copyright)。

### 矢量瓦片
- MapboxVector / Mapbox GL Style 数据源
- 区域选择 + 缩放级别批量下载
- 模式独立的数据源记忆

### 3D Tiles
- Cesium Ion 资产、Google 3D Tiles（全球倾斜摄影）、自定义 URL
- 在 3D 视图框选区域裁剪下载
- 递归解析子 tileset，完整下载多层级 LOD
- 下载后 URI 自动本地化，支持离线 3D 浏览

<p align="center"><img src="site/images/3dtiles.png" alt="3D Tiles 下载与预览" width="640"></p>

### DEM 数字高程模型
- 多源 DEM（COP30 / SRTM 等）
- 按区域批量下载并拼接

### Esri Wayback 历史影像
- 浏览 Esri 卫星影像所有历史版本
- 时间轴交互，按拍摄日期切换
- 支持下载历史时刻的瓦片

<p align="center"><img src="site/images/wayback.png" alt="Wayback 历史影像" width="640"></p>

### 区域选择
- 地名搜索定位
- 中国省 / 市 / 区县三级行政区划
- 上传 GeoJSON / Shapefile（`.zip` / `.shp + .shx + .dbf`） / KML / KMZ
- 地图绘制矩形或多边形

### 任务系统
- 多任务并行，独立进度与日志
- 崩溃重启可恢复任务
- 下载历史，一键打开输出文件夹

<p align="center"><img src="site/images/geotiff.png" alt="GeoTIFF 导出预览" width="640"></p>

---

## 开发

### 环境要求
- [Rust](https://www.rust-lang.org/tools/install) 1.77+
- [Node.js](https://nodejs.org/) 20+（前端构建必需）

### 运行（开发模式）
```bash
# 安装前端依赖
npm ci --prefix frontend

# 启动 Tauri 开发服务（自动 vite dev + cargo build）
cd src-tauri
cargo tauri dev
```

### 构建发布
```bash
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

---

## 社区与反馈

- 使用问题、功能建议、案例分享 → [Discussions](https://github.com/gaopengbin/geo-downloader/discussions)
- Bug 报告 → [Issues](https://github.com/gaopengbin/geo-downloader/issues)
- 微信公众号 / 交流群

<p align="center">
  <img src="https://laogao.xyz/packages/qr-assets/gzh.jpg" alt="公众号" width="200">
  &nbsp;&nbsp;&nbsp;&nbsp;
  <img src="https://laogao.xyz/packages/qr-assets/wxq_sq.png" alt="微信群" width="200">
</p>

---

## 更新历史

完整发布说明见 [Releases](https://github.com/gaopengbin/geo-downloader/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](LICENSE) 免费开放使用。第三方地图与数据仍受各自许可和使用条款约束。

Copyright © 2025–2026 gaopengbin

---

## 赞助

如果这个项目对你有帮助，欢迎请作者喝杯咖啡。

<p align="center">
  <img src="static/images/wx.jpg" alt="微信赞赏" width="220">
  &nbsp;&nbsp;&nbsp;&nbsp;
  <img src="static/images/zfb.jpg" alt="支付宝赞赏" width="220">
</p>

### 感谢支持

感谢每一位愿意支持 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 支持者记录](docs/supporters.md)。如希望匿名、更改昵称或移除记录，请联系作者。

---

## Star History

[![Star History Chart](https://raw.githubusercontent.com/gaopengbin/geo-downloader/star-history-data/.github/star-history/chart.svg)](https://github.com/gaopengbin/geo-downloader)