地理数据来源与许可证
当前邮编地理数据来自 GeoNames 按国家发布的 postal code files,采用 CC BY 4.0 许可。导入清单记录每个国家的源文件 URL、SHA-256、原始行数、导入日期和处理说明。
日本地名使用日本邮政公开的日文与罗马字邮编数据进行对照,保留原地理记录的邮编、坐标与时区。无法可靠匹配的下级地名不输出,来源日期和校验和另行记录。
地址书写顺序不从 GeoNames 推断,而是分别参考 USPS、日本邮便、Deutsche Post、PTT 或 UPU 等邮政资料。每个国家工具页的格式区会列出对应规范链接。
行政区与城市记录如何选择
导入流程首先保留所有一级行政区,再按邮编覆盖选择每个行政区最多 8 个代表城市或地区记录。每条记录中的行政区、城市、下级地区、邮编、经纬度和推导出的 IANA 时区保持在一起,不会分别随机。
哪些字段是合成的
街道、门牌、单元、人物、公司、职业、带 TEST 标识的证件字段和不关联真实账户的财务字段由本地生成器创建。姓名、公司、部门与职位由 Faker 的对应语言词库生成,德语和土耳其语的缺失职业词条及土耳其语公司格式使用本地扩展,职位与部门保持对应。邮箱使用 example.com 保留域名,电话由 Faker 按国家模板生成,不进行完整号段校验或接通验证。完整结果不会被描述为真实个人、真实账户或可投递地址。
Seed 与可复现性
相同国家、地区、城市、Seed 和数据版本会产生相同结果。数据版本改变后,即使 Seed 相同也可能得到不同记录,因此缺陷报告和自动化用例应同时保存 Seed 与数据版本。
质量检查与已知限制
每个发布国家都需要固定 Seed 样例测试、一级行政区完整性检查、城市与邮编关联检查以及当地语言与单行/多行排版测试。当前记录是代表性覆盖而不是完整国家地址数据库;坐标表示邮编记录位置,不是合成门牌的精确坐标。
更新与纠错
数据版本显示在生成器和国家页的覆盖区。重新导入数据时会记录新日期、校验和与处理版本。若发现地区遗漏、邮编关系或格式说明错误,请附国家、页面 URL、数据版本和依据来源联系编辑团队。