st_interiorringn

info

Aperçu

La prise en charge des valeurs GEOGRAPHY est en aperçu public. La prise en charge des valeurs GEOMETRY est généralement disponible.

Renvoie le n-ième anneau intérieur du polygone d’entrée sous forme de linestring fermé.

Pour la fonction Databricks SQL correspondante, consultez la fonctionst_interiorringn.

Syntaxe

Python

from pyspark.databricks.sql import functions as dbf

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

parameter

parameter	Type	Description
col1	pyspark.sql.Column OU str	Une valeur Geography ou Geometry représentant un polygone.
col2	pyspark.sql.Column OU int	Une valeur entière représentant la position basée sur 1 de l'anneau intérieur dans le polygone.

parameter	Type	Description
col1	pyspark.sql.Column OU str	Une valeur Geography ou Geometry représentant un polygone.
col2	pyspark.sql.Column OU int	Une valeur entière représentant la position basée sur 1 de l'anneau intérieur dans le polygone.

Notes

La valeur de sortie a le même type de données et SRID que le polygone d'entrée. La fonction renvoie une chaîne de lignes fermée.

La fonction renvoie None si l’une des entrées est None.

La valeur d'entrée est censée représenter un polygone, sinon une erreur est renvoyée.

Exemples

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