Pular para o conteúdo principal
Última atualização em

st_makepoint

Aplica-se a: Sim, marcado como certo Databricks Runtime 18.2 e acima

info

Visualização

Este recurso está em Pré-visualização Pública.

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

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

Sintaxe​

Python
from pyspark.databricks.sql import functions as dbf

dbf.st_makepoint(*cols)

Parâmetros​

Parâmetro

Tipo

Descrição

cols

pyspark.sql.Column ou flutuar

Os valores das coordenadas. Deve ter 2 (x, y), 3 (x, y, z) ou 4 (x, y, z, m) argumentos.

Devoluções​

pyspark.sql.Column: Um valor geométrico que representa 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 y, 3DZ se você também fornecer z, ou 4D se você fornecer todas as quatro coordenadas (x, y, z e m).

A função retorna None se alguma das entradas for None.

Exemplos​

Cria um ponto 2D com coordenadas (10, 34).

Python
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()
Output
[Row(result='POINT(10 34)')]

Cria um ponto 3DZ com coordenadas (1, 2, 3).

Python
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()
Output
[Row(result='POINT Z (1 2 3)')]

Cria um ponto 4D com coordenadas (1, 2, 3, 4).

Python
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()
Output
[Row(result='POINT ZM (1 2 3 4)')]

O SRID da geometria retornada é sempre 0.

Python
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()
Output
[Row(result=0)]

O tipo da geometria retornada é sempre geometry(0).

Python
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()
Output
[Row(result='geometry(0)')]

A função retorna None se alguma das entradas for None.

Python
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()
Output
[Row(result=None)]
Nesta página