anéis de st

Aplica-se a: Databricks Runtime 18.1 e acima

info

Visualização

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

Retorna o número total de anéis do polígono ou multipolígono de entrada, incluindo anéis externos e internos. Para um multipolígono, retorna a soma de todos os anéis em todos os polígonos.

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

Sintaxe

Python

from pyspark.databricks.sql import functions as dbf

dbf.st_nrings(col=<col>)

Parâmetros

Parâmetro	Tipo	Descrição
col	pyspark.sql.Column ou str	Um valor de Geografia ou Geometria .

Exemplos

Geometria de polígono 2D vazio:

Python

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('POLYGON EMPTY',)], ['wkt'])
df.select(dbf.st_nrings(dbf.st_geomfromtext('wkt')).alias('result')).collect()

Output

[Row(result=0)]

Geografia poligonal 4D com dois anéis (um exterior e um interior):

Python

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('POLYGON ZM ((0 0 111 -11,10 0 222 -22,0 10 333 -33,0 0 444 -44),(1 1 555 -55,4 1 666 -66,1 4 777 -77,1 1 888 -88))',)], ['wkt'])
df.select(dbf.st_nrings(dbf.st_geogfromtext('wkt')).alias('result')).collect()

Output

[Row(result=2)]

Geometria de multipolígono 3DZ vazio:

Python

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('MULTIPOLYGON Z EMPTY',)], ['wkt'])
df.select(dbf.st_nrings(dbf.st_geomfromtext('wkt', 4326)).alias('result')).collect()

Output

[Row(result=0)]

GEOGRAFIA multipolígona com quatro anéis em dois polígonos:

Python

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('MULTIPOLYGON (((0 0,10 0,10 10,0 10,0 0),(1 1,4 1,4 4,1 4,1 1),(5 5,6 5,6 6,5 6,5 5)),((20 20,30 20,30 30,20 30,20 20)))',)], ['wkt'])
df.select(dbf.st_nrings(dbf.st_geogfromtext('wkt')).alias('result')).collect()

Output

[Row(result=4)]