h3_coverash3

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 cobrem minimamente a geografia linear ou areal de entrada. A expressão gera um erro se a geografia não for linear (linha ou multilinha), 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_coverash3.

Sintaxe

Python

from pyspark.databricks.sql import functions as dbf

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

Parâmetros

Parâmetro	Tipo	Descrição
col1	pyspark.sql.Column ou str	Uma sequência de caracteres representando uma geografia linear ou espacial no sistema de referência de coordenadas WGS84 em formato WKT ou GeoJSON, ou um valor BINÁRIO representando uma geografia linear ou espacial 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))', 1),],['wkt', 'res'])
df.select(dbf.h3_coverash3('wkt', 'res').alias('result')).collect()

Output

[Row(result=[581650447186526207, 581672437419081727, 581698825698148351, 581707621791170559,     581716417884192767, 582248581512036351, 581637253046992895, 581641651093503999,     581646049140015103])]