Partilhar via


h3_kringdistances

Devolve todos os IDs das células H3 (representados como inteiros longos ou cadeias) dentro da distância da grelha k a partir do ID da célula H3 de origem, juntamente com a sua distância ao ID da célula H3 de origem. Mais precisamente, o resultado é um array de structs, onde cada struct contém um ID de célula H3 (representado como um inteiro ou cadeia longa) e a sua distância ao ID da célula H3 de origem. O tipo para os IDs das células H3 na saída é o mesmo que o tipo do ID da célula H3 de entrada (primeiro argumento da expressão). Suporta o Spark Connect.

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

Sintaxe

from pyspark.databricks.sql import functions as dbf

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

Parâmetros

Parâmetro Tipo Description
col1 pyspark.sql.Column ou str Um ID de célula H3, representado como uma coluna ou cadeia.
col2 pyspark.sql.Column, str ou int A distância máxima da grelha a partir do ID da célula H3 (primeiro argumento).

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