批量地理编码 API - 免费批量地址坐标
发送最多 10 个自由格式地址的数组并接收每个地址的坐标。 地址并行进行地理编码。 个别失败会返回该地址的错误消息，而不会导致整个批次失败。 响应包括总数、已解决和失败的计数。
Code examples
curl -X POST https://api.botoi.com/v1/geo/batch \
-H "Content-Type: application/json" \
-d '{"addresses":["London, UK","Paris, France","xyzzy nowhere"]}'When to use this API
在地图上绘制客户位置
对 CRM 导出中的客户地址列表进行地理编码。 使用坐标在地图上放置图钉以进行区域规划、送货路线或销售覆盖范围分析。
使用坐标丰富 CSV 导入
处理上传的包含地址的 CSV 文件。 对地址列进行批量地理编码，并将纬度和经度附加到每行，然后再存储到数据库中。
验证表单提交中的多个地址
当用户提交多地址表单（例如，账单+运输+备用）时，在一次 API 调用中对所有地址进行地理编码。 在接受提交之前标记任何未能解决的问题。
Frequently asked questions
每个请求的最大地址数是多少？
每个请求最多可以发送 10 个地址。 对于较大批次，请将列表分成 10 个块并发送多个请求。
如果一个地址失败会发生什么？
失败的地址返回 lat: null、lng: null 和错误消息。 其余批处理正常。 检查响应中的失败计数以识别有问题的地址。
地理编码调用是否并行进行？
是的。 该批次中的所有地址都会同时进行地理编码，以加快响应时间。 一批 10 个地址所花费的时间与单个地理编码请求的时间大致相同。
我可以对 10 个以上的地址进行地理编码吗？
不是在单个请求中。 将您的列表分成 10 个批次并发送多个请求。 通过付费计划，您可以每秒发送多个批量请求。
这是与 /v1/geo/geocode 相同的地理编码器吗？
是的。 批量端点使用与单地址端点相同的 OpenStreetMap Nominatim 地理编码器。 对于相同的输入，结果是相同的。
Get your API key
Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.