st_azimuth

info

Aperçu

La prise en charge des valeurs GEOGRAPHY est en aperçu public. La prise en charge des valeurs GEOMETRY est généralement disponible.

Renvoie l'azimut basé sur le nord du premier point au second en radians dans [0, 2π).

Pour la fonction Databricks SQL correspondante, consultez la fonctionst_azimuth.

Syntaxe

Python

from pyspark.databricks.sql import functions as dbf

dbf.st_azimuth(col1=<col1>, col2=<col2>)

parameter

parameter	Type	Description
col1	pyspark.sql.Column OU str	La première valeur Géographie ou Géométrie représentant un point.
col2	pyspark.sql.Column OU str	La seconde valeur Géographie ou Géométrie représentant un point.

parameter	Type	Description
col1	pyspark.sql.Column OU str	La première valeur Géographie ou Géométrie représentant un point.
col2	pyspark.sql.Column OU str	La seconde valeur Géographie ou Géométrie représentant un point.

Notes

Les entrées sont censées être soit deux valeurs GEOGRAPHY, soit deux valeurs GEOMETRY, sinon, une erreur est renvoyée. Les deux valeurs d'entrée sont censées représenter des points, sinon une erreur est renvoyée. Les deux points sont censés avoir la même valeur SRID, sinon, une erreur est renvoyée.

Si les projections 2D des deux points sont égales, l'azimut renvoyé est zéro.

None est renvoyé si l'une des deux valeurs d'entrée est vide.

Exemples

Python

from pyspark.databricks.sql import functions as dbf
from pyspark.sql.functions import round, lit
import math

df = spark.createDataFrame([('POINT(0 45)', 'POINT(1 46)')], ['wkt1', 'wkt2'])
df.select(round(dbf.st_azimuth(dbf.st_geomfromtext('wkt1'), dbf.st_geomfromtext('wkt2')) * 180.0 / math.pi, 3).alias('result')).collect()

Output

[Row(result=45.0)]