POST AI agent ready /v1/address/validate

地址验证 API - 免费地址验证

发送自由格式的地址字符串并获取结构化组件（门牌号、道路、城市、州、邮政编码、国家/地区）、GPS 坐标、置信度分数和格式化地址。使用地理编码来验证地址是否存在且可解析。如果未找到匹配项，则返回 404。

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/address/validate \
  -H "Content-Type: application/json" \
  -d '{"address":"1600 Amphitheatre Parkway, Mountain View, CA"}'

When to use this API

结帐时验证送货地址

在处理订单之前验证客户输入的送货地址。在拼写错误、不完整的地址和不存在的位置到达您的履行团队之前将其发现。减少失败的投递和退回发件人的成本。

跨系统标准化地址格式

将 CRM 导入、CSV 上传和表单提交的地址标准化为一致的结构化格式。确保您的数据库具有干净的地理编码地址记录，用于分析和物流。

通过部分地址输入预填写表单字段

在用户输入街道地址后，使用验证中的结构化组件自动填充城市、州和邮政编码字段。减少表单废弃和数据输入错误。

Frequently asked questions

地址验证的准确性如何？

端点使用 OpenStreetMap 地理编码数据。对于北美和欧洲的知名地址来说它很强大。农村或新建地址的置信度分数可能较低或不返回任何结果。

置信度分数意味着什么？

置信度得分（0 到 1）反映输入与地理编码结果的匹配程度。分数高于 0.7 表明匹配度很强。低于 0.4 的分数表明该地址可能不明确或部分匹配。

这是否验证该地址是否存在为真实的邮寄地址？

否。此端点对地址进行地理编码并返回结构化数据。它确认映射数据库可以识别该位置，而不是可以将邮件投递到那里。对于 USPS 投递验证，您需要邮政服务 API。

我可以验证国际地址吗？

是的。地理编码服务涵盖全球地址。响应中的country_code字段告诉您地址解析到哪个国家/地区。

如果地址太模糊怎么办？

诸如“主街”之类的模糊输入可能会返回置信度较低的结果或匹配错误的位置。包括城市、州或国家以获得更好的结果。

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.