API指南
学习如何有效使用我们的地址生成器
快速开始指南
1
选择位置
选择特定的州或城市，或留空进行随机生成
2
生成数据
点击生成按钮创建新的地址信息
3
使用数据
根据需要复制、导出或查看生成的信息
详细使用说明
位置筛选
使用侧边栏筛选器控制生成地址的地理范围：
- 州筛选器：选择特定的美国州来限制地址生成
- 城市筛选器：从热门城市中选择以获得针对性结果
- 门牌号筛选：通过API参数has_number=1可以筛选包含数字的街道地址（即带有门牌号的地址）
复制和导出功能
多种方式提取和使用生成的数据：
- 单字段复制：点击任何数据行复制该特定信息
- 批量复制：使用"复制全部信息"获取包含所有数据的格式化文本
- JSON导出：下载结构化数据用于编程和数据库使用
地图集成
在交互式地图上查看生成的地址位置，了解地理背景并验证位置准确性。
专业技巧和最佳实践
键盘快捷键
按Ctrl+R（Mac上为Cmd+R）快速重新生成新的地址数据
移动设备友好
该工具在移动设备上完美运行，具有触摸优化界面
书签筛选器
将带有州/城市参数的URL加入书签，快速访问特定位置
语言支持
使用语言选择器在中英文界面之间切换
API和集成
为需要程序化访问的开发者，我们提供了RESTful API接口。使用API需要先获取Key，请联系管理员获取API访问权限。
// 使用curl调用API示例
curl -X GET "https://www.usaddrgen.com/api/generate.php?key=YOUR_API_KEY&state=CA&city=Los-Angeles"
已复制
// 仅指定州
curl -X GET "https://www.usaddrgen.com/api/generate.php?key=YOUR_API_KEY&state=CA"
已复制
// 生成包含门牌号的地址（has_number=1）
curl -X GET "https://www.usaddrgen.com/api/generate.php?key=YOUR_API_KEY&has_number=1"
已复制
// 指定州并筛选包含门牌号的地址
curl -X GET "https://www.usaddrgen.com/api/generate.php?key=YOUR_API_KEY&state=CA&has_number=1"
已复制
// 随机生成（不指定参数）
curl -X GET "https://www.usaddrgen.com/api/generate.php?key=YOUR_API_KEY"
已复制
注意：请将示例中的 YOUR_API_KEY 替换为您实际的API Key。API Key具有有效期限制，过期后需要联系管理员续期。
响应示例
{
"success": true,
"data": {
"fullName": "John Doe",
"street": "123 Main St",
"city": "Los Angeles",
"state": "CA",
"zipCode": "90001",
...
}
}