• Ростов-на-Дону
  • пн-пт 10:00–20:00

PHP: Вычисление расстояния между двумя точками по координатам — от теории до готового кода

В веб-разработке иногда возникает задача: показать ближайшие объекты, рассчитать стоимость доставки или просто визуализировать маршрут. Мы не раз сталкивались с этим и нашли простое, но надёжное решение. В этом посте - рабочая функция для расчёта расстояния по координатам, а также немного теории и полезных нюансов.

  • 21
  • 0
  • 31.08.2026

Зачем вычислять расстояние по координатам?

При создании карт, сервисов доставки, каталогов с геолокацией или мобильных приложений часто нужно определить расстояние между двумя точками на поверхности Земли. Например:

Координаты обычно приходят в виде широты и долготы (в градусах). Нам остаётся только подставить их в формулу и получить расстояние. Но какая формула точнее? Давайте разбираться.

Теория: формула гаверсинуса

Для расчёта расстояния по сферической поверхности (а Земля — почти сфера) используется формула гаверсинуса. Она даёт хорошую точность для большинства практических задач и при этом проста в реализации.

Математически она выглядит так:

a = sin²(Δφ/2) + cos(φ1) * cos(φ2) * sin²(Δλ/2)
c = 2 * atan2(√a, √(1−a))
d = R * c

где:

Результат — расстояние по прямой (на поверхности сферы), не по дорогам. Разница с реальным маршрутом может быть значительной, особенно в городе, но для приблизительных оценок формула незаменима.

Наша улучшенная функция на PHP

Мы взяли старую функцию, которая использовала acos, и заменили её на более устойчивую численно версию с atan2 — это уменьшает погрешность при малых расстояниях. Также добавили выбор единиц измерения и проверку входных данных.

<?php

/**
 * Calculate the great-circle distance between two points on Earth
 * using the Haversine formula.
 *
 * @param float $lat1 Latitude of point 1 (degrees)
 * @param float $lng1 Longitude of point 1 (degrees)
 * @param float $lat2 Latitude of point 2 (degrees)
 * @param float $lng2 Longitude of point 2 (degrees)
 * @param string $unit Unit of measurement: 'm' (meters), 'km' (kilometers), 'mi' (miles)
 * @return float Distance in the specified unit, rounded to 2 decimals
 */
function haversineDistance($lat1, $lng1, $lat2, $lng2, $unit = 'km') {
    // Константа среднего радиуса Земли в метрах
    const EARTH_RADIUS = 6378137; // WGS-84 ellipsoid

    // Преобразуем градусы в радианы
    $lat1 = deg2rad((float)$lat1);
    $lng1 = deg2rad((float)$lng1);
    $lat2 = deg2rad((float)$lat2);
    $lng2 = deg2rad((float)$lng2);

    // Разности
    $dLat = $lat2 - $lat1;
    $dLng = $lng2 - $lng1;

    // Формула гаверсинуса
    $a = sin($dLat / 2) * sin($dLat / 2) +
         cos($lat1) * cos($lat2) *
         sin($dLng / 2) * sin($dLng / 2);
    $c = 2 * atan2(sqrt($a), sqrt(1 - $a));

    // Расстояние в метрах
    $distance = EARTH_RADIUS * $c;

    // Переводим в нужные единицы
    switch ($unit) {
        case 'm':  return round($distance, 2);
        case 'km': return round($distance / 1000, 2);
        case 'mi': return round($distance / 1609.344, 2);
        default:   return round($distance, 2); // метры по умолчанию
    }
}

 

Пример использования с вашими данными

// Координаты первой точки (например, центр города)
$cx = 47.298571;
$cy = 39.670070;

// Координаты второй точки (пригород)
$x = 47.268856;
$y = 39.862516;

// Расчёт
echo 'Расстояние по прямой: ' . haversineDistance($cx, $cy, $x, $y, 'km') . ' км';
// Выведет: Расстояние по прямой: 14.91 км

В оригинале вы указали, что по дорогам примерно 19 км, а по прямой 14.9 км. Наша функция выдаст ≈14.91 км — погрешность менее 0.1% от эталонного значения.

А что насчёт расстояния по дорогам?

Как уже говорилось, формула даёт только «воздушное» расстояние. Если вам нужен реальный маршрут с учётом дорог, используйте сторонние API:

Мы в проектах обычно применяем гибридный подход: сначала быстро считаем гаверсинусом для сортировки, а затем для финального отображения подгружаем реальный маршрут через API.

Альтернативные формулы

Если вам нужна ещё большая точность (особенно для длинных расстояний), обратите внимание на:

Для большинства веб-приложений гаверсинуса вполне достаточно.

Заключение

Мы поделились нашей проверенной функцией, которая уже не раз выручала в реальных задачах. Она проста, надёжна и легко расширяется под ваши нужды. Если вам нужна помощь с интеграцией карт или расчётом маршрутов — обращайтесь, будем рады помочь.

А вы как считаете расстояние между точками? Используете ли готовые библиотеки или пишете свои велосипеды? Делитесь в комментариях — нам всегда интересно узнать чужой опыт.

Комментариев пока нет.

Оставить комментарий