Metadata-Version: 2.4
Name: gcj-rectify
Version: 0.2.0
Summary: GCJ Rectify Server
Author-email: liuxspro <liuxspro@gmail.com>
Maintainer-email: liuxspro <liuxspro@gmail.com>
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.12
Requires-Dist: fastapi>=0.95.0
Requires-Dist: httpx>=0.24.0
Requires-Dist: pillow>=10.0.0
Requires-Dist: uvicorn>=0.20.0
Description-Content-Type: text/markdown

# gcj-rectify

将 GCJ-02（火星坐标系）地图瓦片实时纠正为 WGS-84 坐标系，作为 QGIS 插件使用。

## 安装

```bash
uv tool install gcj-rectify
```

或直接运行（无需安装）：

```bash
uvx gcj-rectify
```

## 运行服务

开发模式（热重载）：

```bash
uv run uvicorn gcj_rectify_server:app --reload
```

生产模式：

```bash
uv run uvicorn gcj_rectify_server:app --host 0.0.0.0 --port 8000
```

直接使用 `uvx` 运行：

```bash
uvx gcj-rectify
```

## 缓存

### 缓存目录

默认缓存目录为 `~/.cache/gcj-rectify-cache`，通过环境变量 `GCJRE_CACHE` 可自定义：

```bash
GCJRE_CACHE=/path/to/cache uvx gcj-rectify
```

### 缓存内容

- `cache.db` — GCJ 原始瓦片缓存（SQLite）
- `wgs84_cache.db` — 已纠正到 WGS-84 的瓦片缓存（SQLite）
- `maps.json` — 地图配置，可编辑此文件来增删地图源

## 地图配置

编辑缓存目录下的 `maps.json` 文件来增减地图源，格式如下：

```json
{
  "my-map": {
    "name": "我的地图",
    "url": "https://example.com/tiles/{z}/{x}/{y}.png",
    "min_zoom": 3,
    "max_zoom": 18
  }
}
```

## QGIS 插件

插件位于 `gcj_rectify_plugin` 目录，提供图形界面管理服务启停和地图加载。
