Funzione st_azimuth

Si applica a: Databricks Runtime 18.0 e versioni successive

Importante

Questa funzionalità è in Anteprima Pubblica.

Annotazioni

Questa funzionalità non è disponibile in Databricks SQL Classic Warehouses. Per altre informazioni sui databricks SQL Warehouse, vedere Tipi di SQL Warehouse.

Restituisce l'azimut rispetto al nord dal primo punto al secondo in radianti in [0, 2π).

Sintassi

st_azimuth ( geoExpr1, geoExpr2 )

Arguments

• geoExpr1: Il primo valore di GEOGRAPHY o di GEOMETRY.
• geoExpr2: Il secondo valore GEOGRAPHY o GEOMETRY.

Restituzioni

Restituisce un DOUBLE valore uguale all'azimuth a base nord dal primo punto al secondo. Il risultato è espresso in radianti nell'intervallo [0, 2π).

Gli input devono essere costituiti da due valori di tipo GEOGRAPHY o due valori di tipo GEOMETRY; in caso contrario, viene restituito un errore DATATYPE_MISMATCH. Entrambi i valori di input devono rappresentare punti; in caso contrario viene restituito l'errore ST_INVALID_ARGUMENT.INVALID_TYPE.

Se le proiezioni 2D dei due punti sono uguali, l'azimuth restituito è zero.

NULL viene restituito se uno dei due punti di input è vuoto.

Condizioni di errore

• Se una delle due geometrie di input non è un punto, la funzione restituisce ST_INVALID_ARGUMENT. INVALID_TYPE.
• Se le due geometrie di input hanno valori SRID diversi, la funzione restituisce ST_DIFFERENT_SRID_VALUES.

Esempi

-- 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

Funzioni correlate

• st_distance Funzione
• st_distancesphere Funzione
• st_distancespheroid Funzione