$ cat calcular-la-distancia-entre-2-puntos-latitud-y-longitud.md

PHP

Calcular distancia entre coordenadas GPS

07 Feb 2024 · 6 min de lectura

Calcular distancia entre coordenadas GPS hace falta para ordenar tiendas por cercanía, filtrar registros dentro de un radio o estimar un trayecto entre dos direcciones geolocalizadas. Aquí tienes una función PHP con la fórmula de Haversine, que devuelve la distancia en línea recta entre dos puntos en kilómetros, millas o metros, y una función equivalente para SQL Server.

Qué fórmula se usa y cuánta precisión tiene

No sirve el teorema de Pitágoras con las coordenadas: un grado de longitud mide cada vez menos según te acercas a los polos, y la Tierra es casi una esfera. La fórmula de Haversine calcula la distancia más corta sobre la superficie de una esfera, el llamado círculo máximo:

a = sin²(Δlat / 2) + cos(lat1) · cos(lat2) · sin²(Δlon / 2)
distancia = 2 · R · asin(√a)

R es el radio de la Tierra. Con el radio medio, 6371,0088 km, el error frente a la forma real del planeta (un elipsoide algo achatado) es pequeño: en los cuatro trayectos de la tabla de abajo no supera el 0,3 %. Para repartir pedidos, buscar lo más cercano o mostrar «a 5 km», es más que suficiente. Para topografía o navegación, usa un cálculo sobre el elipsoide.

Es distancia en línea recta, no por carretera. Si necesitas estimar el recorrido por carretera o el tiempo de un camión, multiplica por un factor mayor que 1 (la función lo admite en su último parámetro) y calíbralo con tus propias rutas, porque cambia mucho según la zona.

Calcular distancia entre coordenadas GPS en PHP

/**
 * Distancia entre dos puntos de la Tierra (fórmula de Haversine).
 *
 * @param float  $latitude1  Latitud del punto 1 en grados decimales (-90 a 90)
 * @param float  $longitude1 Longitud del punto 1 en grados decimales (-180 a 180)
 * @param float  $latitude2  Latitud del punto 2
 * @param float  $longitude2 Longitud del punto 2
 * @param string $unit       'Km' (por defecto), 'Mi' (millas) o 'm' (metros)
 * @param int    $decimals   Decimales del resultado
 * @param float  $factor     Multiplicador opcional (1 = línea recta; mayor que 1 para estimar por carretera)
 * @return float             Distancia en línea recta sobre una esfera de radio medio 6371,0088 km
 */
function getDistance($latitude1, $longitude1, $latitude2, $longitude2, $unit = 'Km', $decimals = 2, $factor = 1) {
    foreach (array($latitude1, $latitude2) as $lat) {
        if (!is_numeric($lat) || $lat < -90 || $lat > 90) {
            throw new InvalidArgumentException('La latitud debe estar entre -90 y 90.');
        }
    }
    foreach (array($longitude1, $longitude2) as $lon) {
        if (!is_numeric($lon) || $lon < -180 || $lon > 180) {
            throw new InvalidArgumentException('La longitud debe estar entre -180 y 180.');
        }
    }

    $radioKm = 6371.0088;
    $dLat = deg2rad($latitude2 - $latitude1);
    $dLon = deg2rad($longitude2 - $longitude1);

    $a = sin($dLat / 2) * sin($dLat / 2)
       + cos(deg2rad($latitude1)) * cos(deg2rad($latitude2)) * sin($dLon / 2) * sin($dLon / 2);
    $km = 2 * $radioKm * asin(min(1, sqrt($a))) * $factor;

    switch ($unit) {
        case 'Mi':
            return round($km / 1.609344, $decimals);
        case 'm':
            return round($km * 1000, $decimals);
        default:
            return round($km, $decimals);
    }
}

Los parámetros, por orden:

  • Latitud y longitud de cada punto, en grados decimales y con punto decimal. Siempre primero la latitud y después la longitud: invertirlas es el error más frecuente y da distancias absurdas sin avisar.
  • $unit: 'Km' (por defecto), 'Mi' para millas o 'm' para metros.
  • $decimals: decimales del resultado.
  • $factor: multiplicador opcional. Con 1, la distancia en línea recta; con un valor mayor, una estimación de ruta.

Si una latitud queda fuera de -90 a 90 o una longitud fuera de -180 a 180, la función lanza una InvalidArgumentException en lugar de devolver un número que parece correcto.

Ejemplo: de Madrid a Barcelona

// Madrid (40.4168, -3.7038) y Barcelona (41.3874, 2.1686)
echo getDistance(40.4168, -3.7038, 41.3874, 2.1686);              // 505.1
echo getDistance(40.4168, -3.7038, 41.3874, 2.1686, 'Mi');        // 313.85
echo getDistance(40.4168, -3.7038, 41.3874, 2.1686, 'm', 0);      // 505096
echo getDistance(40.4168, -3.7038, 41.3874, 2.1686, 'Km', 2, 1.2); // 606.12

Estas son las salidas con PHP 8.5.12. Frente a un cálculo sobre el elipsoide WGS84, la diferencia es la siguiente:

TrayectoHaversineElipsoide WGS84Diferencia
Madrid – Barcelona505,10 km506,30 km-0,24 %
Madrid – Sevilla390,21 km389,98 km+0,06 %
Madrid – Nueva York5768,01 km5782,60 km-0,25 %
Madrid – Sídney17684,68 km17687,90 km-0,02 %

La función también acepta puntos a ambos lados del meridiano de 180º: de 179,5 a -179,5 de longitud en el ecuador son 111,2 km, no 39 900.

Calcular distancia entre coordenadas GPS en SQL Server

Si los puntos están en una tabla y quieres filtrar o ordenar desde la propia consulta, SQL Server trae el tipo geography y calcula la distancia sobre el elipsoide, así que no necesitas implementar la fórmula:

CREATE OR ALTER FUNCTION dbo.fn_DistanciaGPS
(
    @lat1 decimal(18,8),
    @lon1 decimal(18,8),
    @lat2 decimal(18,8),
    @lon2 decimal(18,8)
)
RETURNS decimal(18,3)
AS
BEGIN
    -- 4326 es WGS84, el sistema de coordenadas del GPS. geography::Point recibe primero la latitud.
    DECLARE @p1 geography;
    DECLARE @p2 geography;

    SET @p1 = geography::Point(@lat1, @lon1, 4326);
    SET @p2 = geography::Point(@lat2, @lon2, 4326);

    -- STDistance devuelve la distancia en metros
    RETURN @p1.STDistance(@p2);
END
SELECT dbo.fn_DistanciaGPS(40.4168, -3.7038, 41.3874, 2.1686) AS metros;
-- metros
-- 506300.149

Para Madrid-Barcelona devuelve 506300,149 metros: el cálculo geodésico de la tabla anterior (506 300,147 m con un cálculo independiente en PHP). No coincide con el Haversine de PHP, unos 1,2 km menos, porque este usa una esfera y SQL Server un elipsoide. CREATE OR ALTER exige SQL Server 2016 SP1 o posterior; en versiones anteriores usa CREATE FUNCTION la primera vez y ALTER FUNCTION después. Si una latitud o longitud está fuera de rango, geography::Point produce un error.

PHP o SQL Server

PHP (Haversine)SQL Server (geography)
Modelo de la TierraEsferaElipsoide WGS84
Unidad de salidaKm, millas o metrosMetros
DependenciasNingunaTipo geography
Mejor cuandoCalculas en la aplicaciónFiltras u ordenas dentro de la consulta

Si copiaste la versión anterior de esta entrada

La función antigua usaba la ley esférica de los cosenos y multiplicaba por 60 * 1.2015. Esa constante da distancias un 4,3 % mayores que la distancia en línea recta (la conversión habitual de grados a millas terrestres es 60 * 1.1515). Si ese margen te servía como estimación de ruta, usa ahora el parámetro $factor de la función nueva, con el valor que calibres, en lugar de depender de esa constante.

Fuentes: Fórmula del haversine (Wikipedia), STDistance de geography (Microsoft Learn) y Point de geography (Microsoft Learn).

Temas:

0 comentarios

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *