h3_polifillash3

Retorna uma matriz de IDs de células H3 representados como números inteiros longos, 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. A expressão gera um erro 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_polyfillash3.

Sintaxe

Python

from pyspark.databricks.sql import functions as dbf

dbf.h3_polyfillash3(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_polyfillash3('wkt', 'res').alias('result')).collect()

Output

[Row(result=[586146350232502271, 586147449744130047, 586198577034821631, 586152397546455039,     586199676546449407, 586153497058082815, 586142501941805055, 586201325813891071])]