全球国家、州、城市数据 JSON

全球国家、州、城市数据库：一站式地理信息解决方案

如果你正在寻找一份覆盖全球、格式齐全、免费开源的地理数据资源，那么这个项目不容错过。countries-states-cities-database 提供了包含国家、州/省、城市的完整数据库，支持超过 11 种数据格式，满足从个人开发到企业级应用的各种需求。

数据规模与质量：

• 250 个国家/地区，100% 覆盖所有时区

• 5,084 个州/省/地区

• 153,000+ 个城市（精确版本含 150,573 个城市）

• 多语言支持：提供 19 种语言名称，便于国际化应用

• 数据每月更新，由社区维护并经过数千名开发者的生产环境验证，可靠且及时。

支持的数据格式：

你可以根据自己的技术栈选择合适的格式：

格式	说明
JSON	轻量级数据交换，最常用
MySQL	含完整架构的数据库转储
PSQL	PostgreSQL 专用导出
SQLite	可移植的单文件数据库
SQLSERVER	Microsoft SQL Server 脚本
MongoDB	NoSQL 文档集合 + 转储
CSV	电子表格友好，便于分析
XML	结构化标记语言
YAML	人类可读的配置格式
Toon	其他备选格式

所有格式均由 GitHub Actions 自动从主 JSON 文件生成，保证一致性。
方式一：直接下载最新导出文件（推荐）
使用 curl 下载城市数据（JSON 格式，压缩包）：

curl -LO https://github.com/dr5hn/countries-states-cities-database/releases/latest/download/json-cities.json.gz
gunzip json-cities.json.gz

方式二：在线演示与交互

访问在线演示地址，可直接搜索、浏览数据：
https://dr5hn.github.io/countries-states-cities-database/

仓库地址：
https://github.com/dr5hn/countries-states-cities-database

开源许可与使用限制

• 许可证：ODbL（Open Database License），数据库内容采用 Database Contents License。

• 免费：完全免费，无隐藏费用。

• 无使用限制：可用于商业项目、闭源应用、学术研究等。

• 社区驱动：欢迎提交 Issue 或 Pull Request 来修正数据错误或增加新内容。

免责声明与注意事项

尽管项目团队和贡献者力求数据准确完整，但该数据库由社区维护，可能包含错误或不反映最新的地缘政治变化（例如国界变更、行政区划调整、城市改名等）。因此：

• 在关键应用或决策中（如金融系统、法律文件、官方统计），请务必与官方渠道或其他可靠来源交叉验证。

• 项目不对数据的绝对准确性或时效性提供担保。

• 使用者需自行承担风险，并遵守 ODbL 许可条款。

• 如果你发现任何错误，欢迎在 GitHub 仓库创建 Issue 或直接提交修正。你的贡献将帮助成千上万的其他开发者。
  

无论你是在构建电商网站、天气应用、旅游平台，还是进行地理数据分析，这份免费、全面、格式灵活的地理数据库都能为你节省大量数据清洗和整理的时间。赶快试试吧！