Geo Data API: Cities, Countries, Postal Codes & Time Zones
收藏数据链接：
官方服务：
资源简介：
World geographic reference data in one API: 235k cities with population and coordinates, 252 countries, 1.8M postal codes (121 countries), IANA time zones by coordinates, nearby search and distance.
创建时间：
2026-09-09
原始信息汇总
Geo Data API: Cities, Countries, Postal Codes & Time Zones
数据集概述
这是一个提供全球地理参考数据的API，覆盖城市、国家、邮政编码和时区信息，适用于大多数应用所需的地理数据查询场景。
数据规模与内容
- 城市与城镇：235,694个（人口500+的居民点），包含名称、国家、地区/州、坐标、人口、IANA时区、GeoNames ID
- 国家与地区：252个，包含ISO代码（alpha-2、alpha-3、数字）、首都、大洲、面积、人口、TLD、货币、电话区号、语言、邮政编码格式和正则表达式、邻国、时区
- 邮政编码：1,826,904个，覆盖121个国家，包含地名、地区、区域和坐标
- 时区：每个城市对应时区，实时提供当前UTC偏移量、当地时间及夏令时标志
主要数据端点
| 端点 | 功能 |
|---|---|
GET /cities |
按名称前缀自动补全（不区分重音），按人口排名 |
GET /cities/nearby |
查询指定半径内的地点，按距离排序 |
GET /countries / GET /countries/{iso2} |
国家列表及完整国家档案 |
GET /postal |
邮政编码查询对应地点、地区及坐标 |
GET /timezone |
根据坐标获取IANA时区及当地时间 |
GET /timezones |
查询某国家的所有时区及实时偏移量 |
GET /distance |
计算两坐标间大圆距离 |
GET /stats |
数据集数量与构建日期 |
数据来源与更新
- 基于开放的GeoNames数据集（CC BY 4.0）构建
- 每条响应均包含
source和dataset_date字段 - 数据从源码重建，非请求时实时抓取，延迟不依赖第三方
典型应用场景
- 注册、结账和旅行表单中的城市/城镇自动补全
- 市场平台和目录的“附近门店”或“25公里内结果”查询
- 国家下拉列表填充和各国邮政编码格式验证
- 将坐标转换为用户当地时区以安排通知
- 用地区、人口和坐标丰富CRM或分析记录
已知局限
- 搜索仅匹配英文/ASCII名称和本地拉丁字母名称，非拉丁文字（如东京的“東京”）未索引
- 人口数据为GeoNames值，可能滞后于官方人口普查
- 坐标转时区通过最近居民点解析：陆地准确，开放海洋未定义（返回404）
- 邮政编码覆盖率因国家而异，响应会明确说明
coverage: country_not_in_dataset
错误处理
所有错误均为JSON格式，包含error和message字段。常见错误类型包括：MISSING_QUERY、INVALID_QUERY、INVALID_COUNTRY、UNKNOWN_COUNTRY、INVALID_COORDINATES、INVALID_RADIUS、INVALID_LIMIT、MISSING_CODE、NO_TIMEZONE等。
