thereabouts 离线地理编码开放数据集
地理空间
0 下载
2 浏览
2026-10-11
数据集简介
离线地理编码能力
thereabouts 的核心目标是在不依赖外部 API key 的前提下完成地理编码。用户只需提供本地输入,即可获得国家、地区、城市与时区四类结构化输出。这一设计使得地理编码流程可以完全在本地或私有环境中运行,避免了对在线服务的实时依赖。
支持的输入类型
数据集与配套工具接受多种类型的输入,覆盖常见的地理与标识信息:
- 坐标:经纬度点,用于反向解析行政层级与时区;
- H3 单元格:基于 H3 空间索引的单元格标识;
- 地名:文本形式的地点名称;
- 邮政编码:邮政编号;
- 机场:机场代码或相关标识;
- UN/LOCODE:联合国贸易与运输地点代码;
- 电话号码:通过号码归属解析地理信息;
- IP 地址:根据 IP 地址推断地理位置;
- 车牌:车辆牌照信息。
上述输入类型均可在同一套接口体系下调用,输出统一收敛到国家、地区、城市与时区四个字段。
输出字段
解析结果以表格型数据呈现,主要字段包括:
| 字段 | 说明 |
|---|---|
| country | 国家 |
| region | 地区(一级行政区) |
| city | 城市 |
| timezone | 时区 |
这些字段构成了数据集的核心结构,便于下游应用直接消费。
多语言接口与统一核心
thereabouts 提供四种使用方式:
- Python:适合数据科学与脚本集成;
- Node:面向 JavaScript/TypeScript 生态;
- CLI:命令行工具,便于快速查询与批处理;
- MCP server:以服务形式对外提供地理编码能力。
四种接口共享同一个 Rust 核心实现,保证不同语言绑定之间的行为一致性。
开放 Parquet 数据集
项目附带一份开放的 Parquet 格式数据集,以列式存储组织地理编码所需的参考数据。Parquet 格式便于在 Spark、Pandas 等工具中直接加载,也利于压缩与高效扫描。该数据集与上述接口配合使用,构成完整的离线地理编码解决方案。
获取方式
项目托管于 GitHub,仓库地址为 https://github.com/brightertiger/thereabouts,用户可从该页面获取源代码、接口文档与数据集文件。数据公开免费,无需申请密钥或授权即可使用。
基本信息
记录数量未知
文件大小未知
文件格式Parquet
数据来源brightertiger
输出字段country, region, city, timezone
接口类型Python, Node, CLI, MCP server
核心实现Rust
数据落地页https://github.com/brightertiger/thereabouts
发布日期2026-10-11
离线地理编码地理空间数据ParquetH3单元格时区解析
上架信息
数据集市运营
平台统一选品上架,经质量审核后公开
0 次下载