st_makepoint

Van toepassing op:controleren gemarkeerd als Ja Databricks Runtime 18.2 en hoger

Important

Deze functie bevindt zich in openbare preview-versie.

Retourneert een puntgeometriewaarde met de opgegeven coördinaten. De functie heeft 2, 3 of 4 numerieke waarden, die de coördinaten (x, y), (x, y, z) of (x, y, z, m) van het punt vertegenwoordigen.

Voor de overeenkomstige Databricks SQL-functie, zie de st_makepoint functie.

Syntax

from pyspark.databricks.sql import functions as dbf

dbf.st_makepoint(*cols)

Parameters

Parameter Typ Description
cols pyspark.sql.Column of float De coördinaatwaarden. Moet 2 (x, y), 3 (x, y, z) of 4 (x, y, z, m) argumenten zijn.

Returns

pyspark.sql.Column: Een geometriewaarde , die een punt vertegenwoordigt met de opgegeven coördinaten.

De SRID-waarde van de geretourneerde geometrie is altijd 0.

Het aantal invoercoördinaten bepaalt de dimensie van het geretourneerde punt: 2D als u alleen x opgeeft en y, 3DZ als u ook opgeeft z, of 4D als u alle vier coördinaten opgeeft (x, y, zen m).

De functie retourneert None als een van de invoerwaarden is None.

Examples

Hiermee maakt u een 2D-punt met coördinaten (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)')]

Hiermee maakt u een 3DZ-punt met coördinaten (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)')]

Hiermee maakt u een 4D-punt met coördinaten (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)')]

De SRID van de geretourneerde geometrie is altijd 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)]

Het type van de geretourneerde geometrie is altijd 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)')]

De functie retourneert None als een van de invoerwaarden is 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)]