st_makepoint

Berlaku untuk: Databricks Runtime 18.2 ke atas

Mengembalikan nilai Geometri titik dengan koordinat yang diberikan. Fungsi ini mengambil 2, 3, atau 4 nilai numerik, mewakili koordinat titik (x, y), (x, y, z), atau (x, y, z, m).

Untuk fungsi Databricks SQL yang sesuai, lihat st_makepoint fungsi.

Syntax

from pyspark.databricks.sql import functions as dbf

dbf.st_makepoint(*cols)

Parameters

Parameter	Type	Description
cols	pyspark.sql.Column atau float	Nilai koordinat. Harus 2 (x, y), 3 (x, y, z), atau 4 (x, y, z, m) argumen.

Returns

pyspark.sql.Column: Nilai Geometri , mewakili titik dengan koordinat yang ditentukan.

Nilai SRID dari geometri yang dikembalikan selalu 0.

Jumlah koordinat input menentukan dimensi titik yang dikembalikan: 2D jika Anda hanya menyediakan dan x, 3DZ jika Anda juga menyediakan y, atau 4D jika Anda menyediakan keempat koordinat (z, , xy, dan z).m

Fungsi mengembalikan None jika salah satu input adalah None.

Examples

Membuat titik 2D dengan koordinat (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)')]

Membuat titik 3DZ dengan koordinat (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)')]

Membuat titik 4D dengan koordinat (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)')]

SRID geometri yang dikembalikan selalu 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)]

Jenis geometri yang dikembalikan selalu geometri (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)')]

Fungsi mengembalikan None jika salah satu input adalah 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)]