跳转到内容
POST AI agent ready /v1/geo/reverse

反向地理编码 API - 将纬度/经度转换为地址

发送纬度和经度对并接收相应的街道地址、城市、国家/地区和显示名称。 由 OpenStreetMap Nominatim 服务提供支持。 用于将设备中的 GPS 坐标、照片 EXIF 数据或地图点击转换为可读位置。

Parameters

numberrequired

Latitude in decimal degrees (-90 to 90).

numberrequired

Longitude in decimal degrees (-180 to 180).

Code examples

curl -X POST https://api.botoi.com/v1/geo/reverse \
  -H "Content-Type: application/json" \
  -d '{"lat":37.4224,"lng":-122.0842}'

When to use this API

当用户在地图上放置图钉时显示可读地址

当用户点击地图上的位置时,将坐标发送到该端点并在工具提示或侧栏中显示街道地址。 使用户无需手动键入地址。

使用 EXIF GPS 数据中的位置名称标记照片

从照片 EXIF 元数据中提取纬度/经度并对它们进行反向地理编码。 在照片库中显示“拍摄于加利福尼亚州山景城”而不是原始坐标。

使用街道地址丰富车队跟踪数据

将车辆跟踪器中的 GPS 坐标转换为街道地址,以用于调度日志、交货确认和路线报告。

Frequently asked questions

响应包含哪些数据?
响应包括完整的显示名称(街道地址)、较短的地址字段、城市、国家和原始纬度/经度。 详细程度取决于该位置的 OpenStreetMap 覆盖范围。
如果坐标位于海洋或未绘制地图的区域会发生什么?
如果 Nominatim 找不到给定坐标的地址,API 将返回 404 NOT_FOUND 错误。 公海、偏远荒野和南极洲可能没有地址数据。
结果有多精确?
精度取决于该区域的 OpenStreetMap 数据密度。 在城市中,您通常可以获得建筑物级别的精度。 在农村地区,结果可能会解析到最近的道路或村庄。
我可以在一个请求中对多个坐标进行反向地理编码吗?
不。每个请求处理一个坐标对。 对于批处理,发出并行请求。 遵守匿名访问每秒 1 个请求的提名速率限制。
这个端点是免费的吗?
是的。 匿名访问每分钟允许 5 个请求。 API 密钥会根据您的计划等级提高速率限制。 没有按请求收费。

Get your API key

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