st_force2d

Si applica a: Databricks Runtime 18.1 e versioni successive

Importante

Questa funzionalità è in Anteprima Pubblica.

Restituisce la proiezione 2D del valore Geography o Geometry di input.

Il valore SRID del valore Geography o Geometry di output è uguale a quello del valore di input.

La funzione restituisce None se l'input è Nessuno.

Per la funzione SQL di Databricks corrispondente, vedere st_force2d funzione.

Sintassi

from pyspark.databricks.sql import functions as dbf

dbf.st_force2d(col=<col>)

Parametri

Parametro	Tipo	Descrizione
col	pyspark.sql.Column oppure str	Valore di Geography o Geometry.

Note

Se l'input ha coordinate Z e/o M, queste vengono eliminate nell'output.

Se l'input è già 2D, viene restituito così come è.

Examples

Eliminare la coordinata M da un punto geografico:

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)')]

Eliminare le coordinate Z e M da un'area geografica a più punti:

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))')]

Eliminare la coordinata Z da un'area geografica poligono:

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))')]

Eliminare la coordinata Z da una geometria del punto:

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)')]

Eliminare le coordinate Z e M da una geometria polilinea.

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)')]

Restituisce la geometria 2D di input così come è:

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)')]

Mantenere lo SRID dell'area geografica di input:

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)]

Mantenere lo SRID della geometria di input:

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)]

Restituire None con un input di 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)]