st_makepoint

Gilt für:check marked yes Databricks Runtime 18.2 und höher

Important

Dieses Feature befindet sich in der Public Preview.

Gibt einen Punktgeometriewert mit den angegebenen Koordinaten zurück. Die Funktion akzeptiert 2, 3 oder 4 numerische Werte, die die Koordinaten (x, y), (x, y, z) oder (x, y, z, m) des Punkts darstellen.

Die entsprechende Databricks SQL-Funktion finden Sie unter st_makepoint Funktion.

Syntax

from pyspark.databricks.sql import functions as dbf

dbf.st_makepoint(*cols)

Parameters

Parameter Typ Description
cols pyspark.sql.Column oder float Die Koordinatenwerte. Muss die Argumente 2 (x, y), 3 (x, y, z) oder 4 (x, y, z, m) sein.

Rückkehr

pyspark.sql.Column: Ein Geometriewert , der einen Punkt mit den angegebenen Koordinaten darstellt.

Der SRID-Wert der zurückgegebenen Geometrie ist immer 0.

Die Anzahl der Eingabekoordinaten bestimmt die Dimension des zurückgegebenen Punkts: 2D, wenn Sie nur x angeben und y, 3DZ, wenn Sie auch zangeben , oder 4D, wenn Sie alle vier Koordinaten (x, y, zund m).

Die Funktion gibt zurück None , wenn eine der Eingaben lautet None.

Beispiele

Erstellt einen 2D-Punkt mit Koordinaten (10, 34).

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([(10.0, 34.0)], ['x', 'y'])
df.select(dbf.st_astext(dbf.st_makepoint('x', 'y')).alias('result')).collect()
[Row(result='POINT(10 34)')]

Erstellt einen 3DZ-Punkt mit Koordinaten (1, 2, 3).

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([(1.0, 2.0, 3.0)], ['x', 'y', 'z'])
df.select(dbf.st_astext(dbf.st_makepoint('x', 'y', 'z')).alias('result')).collect()
[Row(result='POINT Z (1 2 3)')]

Erstellt einen 4D-Punkt mit Koordinaten (1, 2, 3, 4).

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([(1.0, 2.0, 3.0, 4.0)], ['x', 'y', 'z', 'm'])
df.select(dbf.st_astext(dbf.st_makepoint('x', 'y', 'z', 'm')).alias('result')).collect()
[Row(result='POINT ZM (1 2 3 4)')]

Die SRID der zurückgegebenen Geometrie ist immer 0.

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([(10.0, 34.0)], ['x', 'y'])
df.select(dbf.st_srid(dbf.st_makepoint('x', 'y')).alias('result')).collect()
[Row(result=0)]

Der Typ der zurückgegebenen Geometrie ist immer Geometrie(0).

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([(10.0, 34.0)], ['x', 'y'])
df.select(dbf.typeof(dbf.st_makepoint('x', 'y')).alias('result')).collect()
[Row(result='geometry(0)')]

Die Funktion gibt zurück None , wenn eine der Eingaben lautet None.

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([(10.0, None)], ['x', 'y'])
df.select(dbf.st_astext(dbf.st_makepoint('x', 'y')).alias('result')).collect()
[Row(result=None)]