这个项目能做什么

该仓库提供一个由社区维护的综合性国家、州/省、城市和邮政编码数据集。数据以12种格式发布：JSON、MySQL、PostgreSQL、SQLite、SQL Server、MongoDB、XML、YAML、CSV、GeoJSON、TOON（面向LLM优化）和Parquet。数据内容包括ISO2/ISO3代码、国家代码、首都、母语、时区（100%覆盖IANA标准），以及19种语言的翻译。 **数据规模：** - 6个大区，22个次区域 - 250个国家 - 5,299个州/省/地区/直辖市 - 153,765个城市/城镇/区县 - 844,248个邮政编码（覆盖125个国家） - 427个时区 **使用方式：** - **REST API**（`api.countrystatecity.in`）：可从任何语言查询数据，提供免费层用于原型开发，另有付费层用于生产环境。已有官方Python客户端（`countrystatecity-api`）。 - **导出工具**（`export.countrystatecity.in`）：在浏览器中定制数据集，可自定义字段选择。 - **NPM包**：`@countrystatecity/countries`、`-browser`、`-currencies`、`-timezones`、`-translations`，以及一个CLI工具。 - **PyPI包**：提供国家、时区、货币、翻译、电话区号、地区和邮政代码的离线快照。 - **直接下载**：每个GitHub发布版本均提供gzip压缩的导出文件。 - **其他平台**：数据库浏览器、百科全书、用于数据修正的社区管理器、CLI、Kaggle和Data.world。 **贡献指南：** - 可通过社区管理器Web界面轻松提交修正，或直接编辑`contributions/`目录下的JSON文件。 - 新增城市的必填字段：名称、州ID、州代码、国家ID、国家代码、纬度、经度。可选字段：时区、wikiDataId、本地名称。 - 请勿编辑自动生成的目录；这些目录在每次发布时都会从MySQL重新构建。 **许可协议：**开放数据库许可证（ODbL v1.0）。允许商业使用、修改和再分发，但需注明出处。衍生作品必须以相同许可证共享。 **免责声明：**社区维护的数据可能存在错误或滞后于地缘政治变化。关键数据请以官方来源核实。