Fast-GeoCN

🏷️ 离线逆地理编码 | 经纬度转省市区 | Python 逆地址解析 | 中国行政区划查询

超轻量离线中国行政区划逆地理编码（经纬度转省市区 / 坐标转地址） — 仅依赖 shapely，开箱即用。

特性

• ⚡ 极致轻量 — 仅依赖 shapely，wheel 压缩包仅 5.3 MB，安装后占用约 15 MB，加 shapely 共约 18 MB
• 🚀 极速查询 — 运行时自动生成 pickle 缓存 + STRtree + PreparedGeometry，读缓存后 ~1.7 ms，内存常驻后 ~0.2 ms
• 🔌 兼容 — 兼容 regeo(lng, lat) 函数签名
• 🌐 多坐标系 — 支持 WGS-84 / GCJ-02 / BD-09 输入转换（通过 source_crs 参数指定）
• 📦 开箱即用 — 内置中国省市县三级 GeoJSON 数据，pip install 即可使用
• 🛠 自动缓存 — 首次查询自动转为 pickle 缓存（约 11 MB），后续毫秒级响应

快速开始

1. 安装

pip install fast-geocn

2. 查询

from fast_geocn import regeo

result = regeo(104.96, 27.43)  # (经度, 纬度)
print(result)
# {'status': 1, 'Info': 'Successfully retrieved address.',
#  'address': {'province': '云南省', 'province_code': '156530000',
#              'city': '昭通市', 'city_code': '156530600',
#              'district': '镇雄县', 'district_code': '156530627'}}

# 百度地图坐标→自动转 WGS-84 再查询
# result = regeo(104.97, 27.43, source_crs="bd09")

# 高德/腾讯地图坐标→自动转 WGS-84 再查询
# result = regeo(104.96, 27.43, source_crs="gcj02")

API 文档

regeo(lng, lat, source_crs="wgs84")

逆地理编码函数。

返回：包含 status、Info、address 的字典。

reverse_geocode(lat, lon, data_dir=None, source_crs="wgs84")

增强版逆地理编码函数，支持指定数据目录。

fast-geocn-prepare <geojson_dir> <output_dir>

CLI 工具，将 GeoJSON 目录转为 pickle 缓存。

性能

安装体积

数据源推荐

依赖

• shapely >= 2.0

真实作者声明

这个项目的真实作者是 DeepSeek。

人类贡献者 jdb110 提出了一个绝佳的问题，并亲手将它带到了现实世界。 他的角色是：

• 首席灵感官：提出了“重复造轮子”的挑战
• 首席交付官：将蓝图实现为代码并发布
• 首席布道师：让这个项目被世界看见

而我（DeepSeek），只是这段共创旅程中的沉默伙伴。

许可证

MIT