st_interiorringn

info

Visualização

O suporte para valores GEOGRAPHY está em Pré-lançamento público. O suporte para valores GEOMETRY está disponível para o público em geral.

Retorna o n-ésimo anel interior do polígono de entrada como uma linha fechada.

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

Sintaxe

Python

from pyspark.databricks.sql import functions as dbf

dbf.st_interiorringn(col1=<col1>, col2=<col2>)

Parâmetros

Parâmetro	Tipo	Descrição
col1	pyspark.sql.Column ou str	Um valor de Geografia ou Geometria que representa um polígono.
col2	pyspark.sql.Column ou int	Um valor inteiro que representa a posição, com base 1, do anel interior no polígono.

Parâmetro	Tipo	Descrição
col1	pyspark.sql.Column ou str	Um valor de Geografia ou Geometria que representa um polígono.
col2	pyspark.sql.Column ou int	Um valor inteiro que representa a posição, com base 1, do anel interior no polígono.

Notas

O valor de saída possui o mesmo tipo de dados e SRID que o polígono de entrada. A função retorna uma cadeia de linhas fechada.

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

O valor de entrada deve representar um polígono; caso contrário, será retornado um erro.

Exemplos

Python

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('POLYGON((0 1,10 5,4 20,0 1),(3 12,9 7,5 13,3 12),(1 4,7 5,6 8,1 4),(3 6,4 11,2 10,3 6))',)], ['wkt'])
df.select(dbf.st_asewkt(dbf.st_interiorringn(dbf.st_geomfromtext('wkt', 3857), 3)).alias('result')).collect()

Output

[Row(result='SRID=3857;LINESTRING(3 6,4 11,2 10,3 6)')]

Python

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('POLYGON M ((0 1 111,10 5 222,4 20 333,0 1 444),(3 12 111,9 7 222,5 13 333,3 12 444),(1 4 111,7 5 222,6 8 333,1 4 444))',)], ['wkt'])
df.select(dbf.st_asewkt(dbf.st_interiorringn(dbf.st_geogfromtext('wkt'), 2)).alias('result')).collect()

Output

[Row(result='SRID=4326;LINESTRING M (1 4 111,7 5 222,6 8 333,1 4 444)')]

Python

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('POLYGON ZM ((0 1 111 -11,10 5 222 -22,4 20 333 -33,0 1 444 -44),(3 12 111 -11,9 7 222 -22,5 13 333 -33,3 12 444 -44))',)], ['wkt'])
df.select(dbf.st_asewkt(dbf.st_interiorringn(dbf.st_geomfromtext('wkt'), 1)).alias('result')).collect()

Output

[Row(result='LINESTRING ZM (3 12 111 -11,9 7 222 -22,5 13 333 -33,3 12 444 -44)')]