st_azimuth Función

Se aplica a: Databricks Runtime 18.0 y versiones posteriores

Importante

Esta característica está en versión preliminar pública.

Nota:

Esta característica no está disponible en almacenes clásicos de Databricks SQL. Para más información sobre los almacenes de SQL de Databricks, consulte Tipos de almacenamiento de SQL.

Devuelve el azimuth basado en el norte desde el primer punto hasta el segundo en radianes en [0, 2π).

Syntax

st_azimuth ( geoExpr1, geoExpr2 )

Arguments

• geoExpr1: el primer valor de GEOGRAPHY o de GEOMETRY.
• geoExpr2: el segundo valor de GEOGRAPHY o GEOMETRY.

Devoluciones

Devuelve un valor DOUBLE igual al azimut orientado al norte desde el primer punto hasta el segundo. El resultado es en radianes en el rango [0, 2π).

Se espera que las entradas sean dos GEOGRAPHY o dos GEOMETRY valores; de lo contrario, se devuelve un error de DATATYPE_MISMATCH . Se espera que ambos valores de entrada representen puntos; de lo contrario, un ST_INVALID_ARGUMENT. INVALID_TYPE error se devuelve.

Si las proyecciones 2D de los dos puntos son iguales, el acimut devuelto es cero.

NULL se devuelve si alguno de los dos puntos de entrada está vacío.

Condiciones del error

• Si alguna de las dos geometrías de entrada no es un punto, la función devuelve ST_INVALID_ARGUMENT. INVALID_TYPE.
• Si las dos geometrías de entrada tienen valores SRID diferentes, la función devuelve ST_DIFFERENT_SRID_VALUES.

Examples

-- The inputs are `GEOMETRY` values. The output (Cartesian azimuth) is displayed in degrees.
> SELECT round(st_azimuth(st_geomfromtext('POINT(0 45)'), st_geomfromtext('POINT(1 46)')) * 180.0 / pi(), 3);
  45.0

-- The inputs are `GEOGRAPHY` values. The output (geographic azimuth on the WGS84 ellipsoid) is displayed in degrees.
> SELECT round(st_azimuth(st_geogfromtext('POINT(0 45)'), st_geogfromtext('POINT(1 46)')) * 180.0 / pi(), 3);
  34.76

Funciones relacionadas

• st_distance Función
• st_distancesphere Función
• st_distancespheroid Función