st_makepoint

Aplica-se a: Databricks Runtime 18.2 e superior

Importante

Esse recurso está em Visualização Pública.

Retorna um valor geometry de ponto com as coordenadas fornecidas. A função usa valores numéricos 2, 3 ou 4, representando as coordenadas (x, y), (x, y, z) ou (x, y, z, m) do ponto.

Para a função SQL do Databricks correspondente, consulte a função st_makepoint.

Syntax

from pyspark.databricks.sql import functions as dbf

dbf.st_makepoint(*cols)

Parameters

Parâmetro	Tipo	Description
cols	pyspark.sql.Column ou float	Os valores das coordenadas. Deve ser 2 (x, y), 3 (x, y, z) ou 4 (x, y, z, m) argumentos.

Returns

pyspark.sql.Column: um valor geometry , representando um ponto com as coordenadas especificadas.

O valor SRID da geometria retornada é sempre 0.

O número de coordenadas de entrada determina a dimensão do ponto retornado: 2D se você fornecer apenas x e, 3DZ se você também fornecerz, ou 4D se você fornecer todas as quatro coordenadas (x, ye zm).y

A função retornará None se qualquer uma das entradas for None.

Exemplos

Cria um ponto 2D com coordenadas (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)')]

Cria um ponto 3DZ com coordenadas (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)')]

Cria um ponto 4D com coordenadas (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)')]

O SRID da geometria retornada é sempre 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)]

O tipo da geometria retornada é sempre geometria(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)')]

A função retornará None se qualquer uma das entradas for 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)]