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 次下载

价格

免费