h3_try_polyfillash3string

Retorna uma matriz de IDs de células H3 representados como strings, correspondentes a hexágonos ou pentágonos da resolução especificada que estão contidos na área geográfica de entrada. A abrangência geográfica é determinada pelos centroides das células: considera-se que uma célula cobre a área geográfica se o seu centroide estiver localizado dentro dessa área. O valor da expressão é None se a geografia não for areal (polígono ou multipolígono) ou se for encontrado um erro ao analisar a representação de entrada da geografia.

Os formatos de entrada aceitáveis são WKT, GeoJSON e WKB. Nos dois primeiros casos, espera-se que a entrada seja do tipo string, enquanto no último caso espera-se que a entrada seja do tipo BINÁRIO. Compatível com Spark Connect.

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

Sintaxe

Python

from pyspark.databricks.sql import functions as dbf

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

Parâmetros

Parâmetro	Tipo	Descrição
col1	pyspark.sql.Column ou str	Uma string representando uma geografia no sistema de referência de coordenadas WGS84 em formato WKT ou GeoJSON, ou um valor BINÁRIO representando uma geografia no sistema de referência de coordenadas WGS84 em formato WKB.
col2	pyspark.sql.Column, str, ou int	A resolução dos IDs de células H3 que cobrem a área geográfica.

Exemplos

Python

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('POLYGON((-122.4194 37.7749,-118.2437 34.0522,-74.0060 40.7128,-122.4194 37.7749))', 2),],['wkt', 'res'])
df.select(dbf.h3_try_polyfillash3string('wkt', 'res').alias('result')).collect()

Output

[Row(result=['82268ffffffffff', '82269ffffffffff', '822987fffffffff', '8226e7fffffffff',     '822997fffffffff', '8226f7fffffffff', '822657fffffffff', '8229affffffffff'])]