POST AI agent ready /v1/geo/geocode

地理编码 API - 将地址转换为纬度/经度坐标

发送地址字符串（街道地址、城市名称、地标或邮政编码）并接收相应的纬度、经度、显示名称和位置类型。由 OpenStreetMap Nominatim 服务提供支持。支持任何语言的全球地址。

Endpoint

Code examples

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

When to use this API

将用户输入的地址转换为应用程序中的地图图钉

当用户在表单中键入地址时，对其进行地理编码并在地图上放置标记。在许多用例中，这取代了对付费 Google 地图地理编码 API 的需求。

通过坐标丰富您的 CRM 或数据库记录

批量地理编码客户地址以添加纬度/经度字段。使用坐标进行邻近搜索、交付区域计算或地理报告。

Frequently asked questions

哪个地理编码提供商为该端点提供支持？

OpenStreetMap 提名。结果反映了 OpenStreetMap 数据的质量，该质量在大多数国家/地区都很强，但在农村或发展中地区可能不太详细。

该端点是否支持非英文地址？

是的。 Nominatim 支持大多数语言和文字的地址。您可以使用日语、阿拉伯语、西里尔语或 OpenStreetMap 支持的任何语言发送地址。

如果地址不明确或找不到怎么办？

如果没有结果匹配，API 将返回 404 NOT_FOUND 错误。对于不明确的地址，API 将返回最匹配的内容。尽可能具体（包括城市、州、国家）以提高准确性。

地理编码请求是否有速率限制？

匿名访问每分钟允许 5 个请求。对于 API 密钥，速率限制由您的计划决定。 Nominatim 本身有一个每秒 1 个请求的策略，该端点遵循该策略。

我可以使用此端点对 IP 地址进行地理编码吗？

否。该端点将街道地址转换为坐标。对于 IP 地理定位，请使用 /v1/ip/lookup 端点。

Get your API key

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