Compartilhar via


h3_pointash3string

Retorna a ID da célula H3 (como uma cadeia de caracteres) correspondente ao ponto fornecido na resolução especificada. A expressão emitirá um erro se a geografia não for um ponto ou se um erro for encontrado 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 cadeia de caracteres, enquanto no último caso, espera-se que a entrada seja do tipo BINARY. Dá suporte ao Spark Connect.

Para consultar a função SQL correspondente do Databricks, 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 de caracteres que representa uma geografia de ponto no sistema de referência de coordenadas WGS84 no formato WKT ou GeoJSON ou um BINARY que representa uma geografia no sistema de referência de coordenadas WGS84 no formato WKB.
col2 pyspark.sql.Column, str ou int A resolução da ID da célula H3 que queremos calcular e que corresponde à geografia pontual.

Exemplos

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