st_force2d

Gilt für: Databricks Runtime 18.1 und höher

Von Bedeutung

Dieses Feature befindet sich in der Public Preview.

Gibt die 2D-Projektion des Eingabegeografie - oder Geometriewerts zurück.

Der SRID-Wert des Ausgabegeografie - oder Geometriewerts entspricht dem des Eingabewerts.

Die Funktion gibt None zurück, wenn die Eingabe Keine ist.

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

Syntax

from pyspark.databricks.sql import functions as dbf

dbf.st_force2d(col=<col>)

Parameter

Parameter	Typ	Beschreibung
col	pyspark.sql.Column oder str	Ein Geography- oder Geometry-Wert.

Hinweise

Wenn die Eingabe Z- und/oder M-Koordinaten aufweist, werden diese in der Ausgabe weggelassen.

Wenn die Eingabe bereits 2D ist, wird sie wie folgt zurückgegeben.

Beispiele

Entfernen Sie die M-Koordinate von einer Punktgeometrie.

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('POINT M (1 2 3)',)], ['wkt'])
df.select(dbf.st_asewkt(dbf.st_force2d(dbf.st_geogfromtext('wkt'))).alias('result')).collect()

[Row(result='SRID=4326;POINT(1 2)')]

Entfernen der Z- und M-Koordinaten aus einer Multipoint-Geometrie.

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('MULTIPOINT ZM (EMPTY,0 0 10 20, 1 1 11 21)',)], ['wkt'])
df.select(dbf.st_asewkt(dbf.st_force2d(dbf.st_geogfromtext('wkt'))).alias('result')).collect()

[Row(result='SRID=4326;MULTIPOINT(EMPTY,(0 0),(1 1))')]

Entfernen Sie die Z-Koordinate aus einer Polygonfläche.

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('POLYGON Z ((0 0 2,1 0 3,0 1 4,0 0 5))',)], ['wkt'])
df.select(dbf.st_asewkt(dbf.st_force2d(dbf.st_geogfromtext('wkt'))).alias('result')).collect()

[Row(result='SRID=4326;POLYGON((0 0,1 0,0 1,0 0))')]

Entfernen Sie die Z-Koordinate von einer Punktgeometrie.

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('POINT Z (1 2 3)',)], ['wkt'])
df.select(dbf.st_asewkt(dbf.st_force2d(dbf.st_geomfromtext('wkt', 4326))).alias('result')).collect()

[Row(result='SRID=4326;POINT(1 2)')]

Entfernen Sie die Z- und M-Koordinaten aus einer Linienstreckengeometrie.

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('LINESTRING ZM (0 0 10 20, 1 1 11 21)',)], ['wkt'])
df.select(dbf.st_asewkt(dbf.st_force2d(dbf.st_geomfromtext('wkt', 4326))).alias('result')).collect()

[Row(result='SRID=4326;LINESTRING(0 0,1 1)')]

Geben Sie die Eingabe-2D-Geometrie wie folgt zurück:

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('POINT(1 2)',)], ['wkt'])
df.select(dbf.st_asewkt(dbf.st_force2d(dbf.st_geomfromtext('wkt', 4326))).alias('result')).collect()

[Row(result='SRID=4326;POINT(1 2)')]

Bewahren Sie die SRID der Eingabegeografie auf:

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('POINT(1 2)',)], ['wkt'])
df.select(dbf.st_srid(dbf.st_force2d(dbf.st_geogfromtext('wkt'))).alias('result')).collect()

[Row(result=4326)]

Bewahren Sie die SRID der Eingabegeometrie auf:

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('POINT(1 2)',)], ['wkt'])
df.select(dbf.st_srid(dbf.st_force2d(dbf.st_geomfromtext('wkt', 4326))).alias('result')).collect()

[Row(result=4326)]

Geben Sie None zurück bei einer Eingabe von None:

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([(None,)], ['wkt'])
df.select(dbf.st_force2d(dbf.st_geogfromtext('wkt')).alias('result')).collect()

[Row(result=None)]