地址自动完成 API - 免费地址建议
发送部分地址查询并获取最多 10 个结构化地址建议，其中包括街道、城市、州、国家/地区和 GPS 坐标。 专为在输入地址字段时进行搜索而设计。 支持本地化结果的语言首选项。
Code examples
curl -X POST https://api.botoi.com/v1/address/autocomplete \
-H "Content-Type: application/json" \
-d '{"query":"1600 Amphithea","limit":3,"lang":"en"}'When to use this API
构建“输入即搜索”地址字段
将此端点连接到具有去抖请求的输入字段。 当用户键入时显示匹配地址的下拉列表。 当他们选择其中一项时，系统会自动填充街道、城市、州和邮政编码字段。
减少移动结账时的表单错误
移动用户比桌面用户犯的拼写错误更多。 自动完成建议让他们点击正确的地址，而不是完整地输入地址，从而缩短了表单完成时间并降低了错误率。
地图应用中的电源位置搜索
使用自动完成功能让用户可以按名称或地址搜索地点。 每个建议都包含坐标，因此您可以将地图置于所选结果的中心，而无需单独的地理编码调用。
Frequently asked questions
我可以请求多少条建议？
设置 limit 参数，范围为 1 到 10。默认为 5。API 最多返回找到的匹配结果的数量，该数量可能小于限制。
支持哪些语言？
通过任何 ISO 639-1 语言代码（例如，“de”代表德语，“ja”代表日语）。 当翻译可用时，结果将以请求的语言返回。 否则会返回到当地语言。
有最小查询长度吗？
查询必须至少包含一个非空白字符。 较短的查询返回更广泛的结果。 为了获得最佳建议，请发送至少 3-4 个字符。
这适用于公司名称或街道地址吗？
它对两者都有效。 地理编码器匹配街道地址、社区、城市和命名地点。 公司名称可能匹配也可能不匹配，具体取决于映射数据库覆盖范围。
响应时间是多少？
典型响应时间为 100-300 毫秒，具体取决于地理编码服务负载。 为了获得流畅的提前输入体验，请在用户停止输入后 150-200 毫秒触发去抖动请求。
Get your API key
Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.