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

Сортировка ближайших магазинов и ресторанов по расстоянию от пользователя.

Рассчитайте расстояние от координат пользователя до каждого места в вашей базе данных. Сортируйте по результату, чтобы первыми были показаны наиболее близкие варианты. Работает на стороне сервера, поэтому вам не нужен ключ API Google Maps.

Проверка радиуса доставки для оформления заказа электронной коммерции

Прежде чем подтвердить заказ, рассчитайте расстояние между вашим складом и адресом доставки. Отклоните или взимайте дополнительную плату, если расстояние превышает вашу зону доставки.

Создайте трекер пройденного расстояния для приложений для фитнеса или логистики.

Отправляйте последовательные путевые точки GPS и суммируйте расстояния, чтобы рассчитать общую длину поездки. Подходит для прокладки маршрутов, отслеживания автопарка или приложений для езды на велосипеде.

Frequently asked questions

Насколько точна формула Хаверсина?

Формула Хаверсина предполагает идеальную сферу и имеет точность около 0,3% для большинства расстояний на Земле. Для получения субметровой точности используйте формулу Винсенти, которая учитывает эллипсоидную форму Земли.

Какую систему координат ожидает эта конечная точка?

WGS84 десятичные градусы. Широта колеблется от -90 до 90 (с юга на север). Долгота колеблется от -180 до 180 (с запада на восток). Это та же система, которая используется устройствами GPS и Google Maps.

Могу ли я рассчитать расстояния для более чем двух точек?

Эта конечная точка обрабатывает одну пару точек за запрос. Для маршрутов с несколькими точками вызывайте конечную точку для каждой последовательной пары и суммируйте расстояния.

В чем разница между км, милями и нм?

км = километры (1 км = 1000 метров). мили = статутные мили (1 миля = 1,609 км). морские мили = морские мили (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.