Partilhar via


h3_pointash3string

Devolve o ID da célula H3 (como uma cadeia) correspondente ao ponto fornecido na resolução especificada. A expressão emite um erro se a geografia não for um ponto ou se for encontrado um erro ao analisar a representação de entrada da geografia. As representações 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 a entrada é do tipo BINARY. Suporta o Spark Connect.

Para a função SQL do Databricks correspondente, veja h3_pointash3string função.

Sintaxe

from pyspark.databricks.sql import functions as dbf

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

Parâmetros

Parâmetro Tipo Description
col1 pyspark.sql.Column ou str Uma cadeia que representa uma geografia pontual no sistema de referência de coordenadas WGS84 em formato WKT ou GeoJSON, ou um BINÁRIO que representa uma geografia no sistema de referência de coordenadas WGS84 em formato WKB.
col2 pyspark.sql.Column, string, ou inteiro A resolução do ID da célula H3 que queremos calcular e que corresponde ao ponto geográfico.

Examples

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('POINT(-122.4783 37.8199)', 13),], ['wkt', 'res'])
df.select(dbf.h3_pointash3string('wkt', 'res').alias('result')).collect()
[Row(result='8d283087022a93f')]
df.select(dbf.h3_pointash3string('wkt', 13).alias('result')).collect()
[Row(result='8d283087022a93f')]