geo_azimuth()

Calcula el ángulo en sentido de las agujas del reloj en radianes entre la línea de point1 a true norte y una línea de point1 a point2 en la Tierra.

Syntax

geo_azimuth(, p1_longitude, p1_latitude, p2_longitudep2_latitude)

Más información sobre las convenciones de sintaxis.

Parámetros

Nombre	Tipo	Requerido	Descripción
p1_longitude	real	✔️	Valor de longitud en grados de la primera coordenada geoespacial. Un valor válido está en el intervalo [-180, +180].
p1_latitude	real	✔️	Valor de latitud en grados de la primera coordenada geoespacial. Un valor válido está en el intervalo [-90, +90].
p2_longitude	real	✔️	Valor de longitud en grados de la segunda coordenada geoespacial. Un valor válido está en el intervalo [-180, +180].
p2_latitude	real	✔️	Valor de latitud en grados de la segunda coordenada geoespacial. Un valor válido está en el intervalo [-90, +90].

Devoluciones

Ángulo en radianes entre la línea desde el punto p1 hasta el norte verdadero y la línea [p1, p2]. El ángulo se mide en el sentido de las agujas del reloj.

Nota

• Las coordenadas geoespaciales se interpretan como representadas por el sistema de referencia de coordenadas WGS-84 .
• La referencia geodética utilizada para medir la distancia en la Tierra es una esfera. Los bordes de línea son geodesics en la esfera.
• Azimuth 0 puntos al norte. Azimuth Pi/2 puntos este. Azimuth Pi apunta al sur. Azimuth 3Pi/2 puntos oeste.
• Si las coordenadas no son válidas, la consulta generará un resultado nulo.
• Si point1 es igual a point2, la consulta generará un resultado nulo.
• Si point1 y point2 son antipodal, la consulta generará un resultado nulo.

Ejemplos

En el ejemplo siguiente se calcula azimuth en radianes.

Ejecución de la consulta

print azimuth_in_radians = geo_azimuth(5, 10, 10, -40)

Salida

azimuth_in_radians
3.05459939796449

En el ejemplo siguiente se calcula azimuth en grados.

Ejecución de la consulta

let azimuth_in_radians = geo_azimuth(5, 10, 10, -40);
print azimuth_in_degrees = degrees(azimuth_in_radians);

Salida

azimuth_in_degrees
175.015653606568

En el ejemplo siguiente se considera un camión que emite telemetría de su ubicación mientras viaja y busca su dirección de desplazamiento.

Ejecución de la consulta

let get_direction = (azimuth:real)
{
    let pi = pi();
    iff(azimuth < pi/2,   "North-East",
    iff(azimuth < pi,     "South-East",
    iff(azimuth < 3*pi/2, "South-West",
                          "North-West")));
};
datatable(timestamp:datetime, lng:real, lat:real)
[
    datetime(2024-01-01T00:01:53.048506Z), -115.4036607693417, 36.40551631046261,
    datetime(2024-01-01T00:02:53.048506Z), -115.3256807623232, 36.34102142760111,
    datetime(2024-01-01T00:03:53.048506Z), -115.2732290602112, 36.28458914829917,
    datetime(2024-01-01T00:04:53.048506Z), -115.2513186233914, 36.27622394664352,
    datetime(2024-01-01T00:05:53.048506Z), -115.2352055633212, 36.27545547038515,
    datetime(2024-01-01T00:06:53.048506Z), -115.1894341934856, 36.28266934431671,
    datetime(2024-01-01T00:07:53.048506Z), -115.1054318118468, 36.28957085435267,
    datetime(2024-01-01T00:08:53.048506Z), -115.0648614339413, 36.28110743285072,
    datetime(2024-01-01T00:09:53.048506Z), -114.9858032867736, 36.29780696509714,
    datetime(2024-01-01T00:10:53.048506Z), -114.9016966527561, 36.36556196813566,
]
| sort by timestamp asc 
| extend prev_lng = prev(lng), prev_lat = prev(lat)
| where isnotnull(prev_lng) and isnotnull(prev_lat)
| extend direction = get_direction(geo_azimuth(prev_lng, prev_lat, lng, lat))
| project direction, lng, lat
| render scatterchart with (kind = map)

Salida

En el ejemplo siguiente se devuelve true porque el primer punto es igual al segundo punto.

Ejecución de la consulta

print is_null = isnull(geo_azimuth(5, 10, 5, 10))

Salida

is_null
true