st_force2d

Область применения: Databricks Runtime 18.1 и выше

Это важно

Поддержка значений GEOGRAPHY доступна в общедоступной предварительной версии. Поддержка значений типа GEOMETRY общедоступна.

Возвращает 2D-проекцию входного географического или геометрического значения.

Значение SRID выходного значения Geography или Geometry равно значению входного значения.

Функция возвращает значение None, если входные данные — None.

Для соответствующей функции Databricks SQL смотрите функцию st_force2d.

Синтаксис

from pyspark.databricks.sql import functions as dbf

dbf.st_force2d(col=<col>)

Параметры

Параметр	Тип	Описание
col	pyspark.sql.Column или str	Значение может быть Geography или Geometry.

Примечания

Если входные данные имеют координаты Z и/или M, они удаляются в выходных данных.

Если входные данные уже 2D, они возвращаются без изменений.

Примеры

Удалите координату M из географической точки:

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

Удалите координаты Z и M из многоточечной географической области

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

Удалите координату Z из географического региона многоугольника:

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

Удалите координату Z из геометрии точки:

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

Удалите координаты Z и M из геометрии линии.

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

Возвращает входную 2D геометрию следующим образом:

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

Сохраните SRID входного географического региона:

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

Сохраните SRID входной геометрии:

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

Возврат None при вводе 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)]