Partager via


h3_kringdistances

Retourne tous les ID de cellule H3 (représentés sous forme d’entiers ou de chaînes longs) au sein de la distance de grille k de l’ID de cellule H3 d’origine, ainsi que leur distance par rapport à l’ID de cellule H3 d’origine. Plus précisément, le résultat est un tableau de structs, où chaque struct contient un ID de cellule H3 (représenté sous forme d’entier ou de chaîne long) et sa distance par rapport à l’ID de cellule H3 d’origine. Le type des ID de cellule H3 dans la sortie est identique au type de l’ID de cellule H3 d’entrée (premier argument de l’expression). Prend en charge Spark Connect.

Pour voir la fonction SQL Databricks correspondante, consultez h3_kringdistances.

Syntaxe

from pyspark.databricks.sql import functions as dbf

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

Paramètres

Paramètre Type Descriptif
col1 pyspark.sql.Column ou str ID de cellule H3, représenté sous la forme d’une colonne ou d’une chaîne.
col2 pyspark.sql.Column, str ou int Distance maximale sur la grille depuis l'ID de cellule H3 (premier argument).

Examples

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([(599686042433355775, '85283473fffffff', 1,),],['h3l', 'h3s', 'res'])
df.select(dbf.h3_kringdistances('h3l', 'res').alias('result')).collect()
[Row(result=[Row(cellid=599686042433355775, distance=0),     Row(cellid=599686030622195711, distance=1), Row(cellid=599686044580839423, distance=1),     Row(cellid=599686038138388479, distance=1), Row(cellid=599686043507097599, distance=1),     Row(cellid=599686015589810175, distance=1), Row(cellid=599686014516068351, distance=1)])]
df.select(dbf.h3_kringdistances('h3s', 'res').alias('result')).collect()
[Row(result=[Row(cellid='85283473fffffff', distance=0),     Row(cellid='85283447fffffff', distance=1), Row(cellid='8528347bfffffff', distance=1),     Row(cellid='85283463fffffff', distance=1), Row(cellid='85283477fffffff', distance=1),     Row(cellid='8528340ffffffff', distance=1), Row(cellid='8528340bfffffff', distance=1)])]