POST AI agent ready /v1/geo/distance

距离计算器 API - 坐标之间的半正矢

提供两个纬度/经度对并接收使用半正弦公式计算出的它们之间的距离。支持公里、英里和海里。对于地球上的任意两点都是准确的。无需外部服务呼叫；计算完全在服务器上运行。

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/geo/distance \
  -H "Content-Type: application/json" \
  -d '{"from":{"lat":40.7128,"lng":-74.006},"to":{"lat":51.5074,"lng":-0.1278},"unit":"km"}'

When to use this API

按距用户的距离对附近的商店或餐馆进行排序

计算从用户坐标到数据库中每个位置的距离。按结果排序以首先显示最接近的选项。在服务器端运行，因此您不需要 Google 地图 API 密钥。

验证电子商务结帐的送货半径

在确认订单之前，请计算您的仓库和送货地址之间的距离。如果距离超出您的送货区域，请拒绝或收取附加费。

为健身或物流应用程序构建旅行距离追踪器

发送连续的 GPS 航点并对距离进行求和以计算总行程长度。适用于跑步路线、车队跟踪或骑行应用程序。

Frequently asked questions

半正矢公式的准确度如何？

半正矢公式假定是一个完美的球体，对于地球上的大多数距离，其精确度约为 0.3%。对于亚米级精度，请使用文森蒂公式，该公式解释了地球的椭球形状。

该端点期望什么坐标系？

WGS84 十进制。纬度范围从 -90 到 90（从南到北）。经度范围从 -180 到 180（从西到东）。 GPS 设备和 Google 地图使用相同的系统。

我可以计算两个以上点的距离吗？

该端点针对每个请求处理一对点。对于多点路线，调用每个连续对的端点并对距离求和。

km、mi 和 nm 有什么区别？

km = 公里（1 公里 = 1000 米）。 mi = 法定英里（1 英里 = 1.609 公里）。 nm = 海里（1 海里 = 1.852 公里）。海里是航空和海上导航的标准。

该端点是否调用外部地图服务？

不会。Haversine 计算完全在服务器上运行，无需外部 API 调用。这意味着零额外延迟并且没有第三方速率限制。

Get your API key

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