st_azimuth Funkce

Platí pro: Databricks SQL Databricks Runtime 18.0 a vyšší

Důležité

Tato funkce je ve verzi Public Preview.

Poznámka:

Tato funkce není k dispozici ve skladech Databricks SQL Classic. Další informace o službě Databricks SQL Warehouse najdete v tématu Typy SQL Warehouse.

Vrátí azimut založený na severu od prvního bodu k druhému v radiánech v [0, 2π).

Syntaxe

st_azimuth ( geoExpr1, geoExpr2 )

Arguments

• geoExpr1: První GEOGRAPHY nebo GEOMETRY hodnota.
• geoExpr2: Druhá GEOGRAPHY nebo GEOMETRY hodnota.

Návraty

DOUBLE Vrátí hodnotu, která se rovná azimutu založenému na severu od prvního bodu k druhému. Výsledek je v radiánech v rozmezí [0, 2π).

Očekává se, že vstupy budou buď dvě GEOGRAPHY, nebo dvě GEOMETRY hodnoty; v opačném případě se vrátí chyba DATATYPE_MISMATCH. Očekává se, že obě vstupní hodnoty budou představovat body, jinak je vrácena chyba ST_INVALID_ARGUMENT.INVALID_TYPE.

Pokud jsou 2D projekce těchto dvou bodů stejné, vrácený azimut je nula.

NULL je vrácena, pokud některý ze dvou vstupních bodů je prázdný.

Stavy chyb

• Pokud geoExpr1 je typ GEOGRAPHY a geoExpr2 je typu GEOMETRY, nebo naopak, vrátí funkce DATATYPE_MISMATCH.
• Pokud některá ze dvou vstupních geometrií není bodem, vrátí funkce ST_INVALID_ARGUMENT. INVALID_TYPE.
• Pokud mají dvě vstupní geometrie různé hodnoty SRID, vrátí funkce 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

Související funkce

• st_distance funkce
• st_distancesphere funkce
• st_distancespheroid funkce