Partager via


h3_pointash3string

Retourne l’ID de cellule H3 (sous forme de chaîne) correspondant au point fourni à la résolution spécifiée. L’expression émet une erreur si la zone géographique n’est pas un point ou si une erreur est trouvée lors de l’analyse de la représentation d’entrée de la zone géographique. Les représentations d’entrée acceptables sont WKT, GeoJSON et WKB. Dans les deux premiers cas, l’entrée est censée être de type chaîne, tandis que dans le dernier cas, l’entrée est censée être de type BINARY. Prend en charge Spark Connect.

Pour consulter la fonction SQL de Databricks correspondante, voir h3_pointash3string la fonction.

Syntaxe

from pyspark.databricks.sql import functions as dbf

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

Paramètres

Paramètre Type Descriptif
col1 pyspark.sql.Column ou str Chaîne représentant une zone géographique de point dans le système de référence de coordonnées WGS84 au format WKT ou GeoJSON, ou binaire représentant une zone géographique dans le système de référence de coordonnées WGS84 au format WKB.
col2 pyspark.sql.Column, str ou int Résolution de l’ID de cellule H3 que nous voulons calculer qui correspond à la zone géographique du point.

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