1 概述

很多网站在注册或者认证的时候，要求提供真实住宅地址，并且还伴随着地图认证要求，这个时候如何生成一个真实地址就显得很重要了，今天介绍一款住宅地址生成器: 27 国真实住宅地址生成器，支持 Google 地图/高德地图 定位核验。
Address 是真实住宅地址生成器。 发布池中的住宅基础地址来自官方开放数据、国家或地区地址登记、地图登记建筑及具有明确住宅用途证据的开放地图数据，不使用随机街道、门牌或邮编冒充真实地址。每条记录保留来源坐标，可用于 Google Maps、高德地图等覆盖相应地区的地图服务定位；具体平台的文字搜索结果取决于其地区覆盖、索引名称和更新时间。

1.1 核心功能

配置 27 个国家和地区，并按国家实际行政结构提供州省、城市、区县和邮编筛选。
严格筛选：所选范围没有合格记录时返回错误，不会悄悄切换到其他地区。
从当前筛选范围的全部合格地址中快速随机选择，不会反复读取数据库前几条。
支持原文、英文、简体中文、繁体中文、日语、韩语、德语、法语、西班牙语和葡萄牙语展示路径。
地址语言和资料语言分别记忆；浏览器首次打开默认 English，生成和切换国家不会重置选择。
地址收藏保存在浏览器中，支持按大洲或国家分组与筛选、拖动或序号排序、复制、删除，以及跳转 Google Maps 或高德地图。
每个国家可配置热门行政区、热门城市和特殊区域；美国包含无州级销售税州。
提供公开覆盖监控，以及管理员仪表盘、地址数据规则、同步队列与同步历史、快捷区域、平台凭据、访问控制、黑名单和 API Token 页面。
JSON API 提供健康检查、国家、可用性、地区选项、搜索、地址/资料生成、批量生成和监控接口，并包含 Python、cURL 和 JavaScript 示例。
运行时完全使用 PostgreSQL，包含连接池、事务发布、地区索引和预构建随机地址索引。

2 项目演示

PS：项目最大优势：地址全部 "真实" 且是 "住宅" 地址 ！！！所有地址均可以在谷歌/高德地图找到，并且项目内置 谷歌/高德地图 预览。
项目地址： https://github.com/daimon3332/address
在线体验： https://address.daimonna.com/ 或者 https://address.333186.xyz/
截图演示：
美国住宅地址

中国住宅地址

数据监控：

地址数据

仪表盘

快捷区域

同步队列

地图key

3 部署

地址、基本资料等支持9种常用国际语言（英语、简体中文、繁体中文、德语、法语、西班牙语、日语、韩语、葡萄牙语）以及各个国家的本土语言。
支持Docker Compose部署。
支持谷歌的Geocoding API导入地址数据。

3.1 选择docker部署

git clone https://github.com/daimon3332/address.git
cd address
sh ops/init-compose.sh
docker compose up -d

其他部署细节可以访问作者部署教程：https://github.com/daimon3332/address/blob/main/docs/DEPLOYMENT.zh-CN.md

3.2 配置与 API Key

1）前端密码、管理员密码、API Token、平台密钥、额度和快捷区域均在管理员后台设置。
2）平台密钥默认可选；只有所选同步策略需要时才必须配置。
3）多个 Key 独立轮换。当前 Key 失败时先冷却并尝试其他 Key；全部不可用时等待最早恢复时间。
4）各平台用途、官方申请入口和后台配置名称见独立的 API Key 配置文档：https://github.com/daimon3332/address/blob/main/docs/API_KEYS.zh-CN.md。