Aller au contenu principal

h3_try_polyfillash3string

Renvoie un tableau d'ID de cellule H3, représentés sous forme de chaînes, correspondant aux hexagones ou pentagones de la résolution spécifiée qui sont contenus par la géographie surfacique d'entrée. Le confinement est déterminé par les centroïdes de cellule : une cellule est considérée comme couvrant la géographie si le centroïde de la cellule se trouve à l'intérieur de la géographie surfacique. La valeur de l'expression est None si la zone géographique n'est pas surfacique (polygone ou multipolygone) 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 doit être de type chaîne de caractères, alors que dans le dernier cas, l'entrée doit être de type BINAIRE. Prend en charge Spark Connect.

Pour la fonction Databricks SQL correspondante, consultez la fonctionh3_try_polyfillash3string.

Syntaxe

Python
from pyspark.databricks.sql import functions as dbf

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

parameter

parameter

Type

Description

col1

pyspark.sql.Column OU str

Chaîne de caractères représentant une géographie dans le système de référence de coordonnées WGS84 au format WKT ou GeoJSON, ou BINARY représentant une géographie dans le système de référence de coordonnées WGS84 au format WKB.

col2

pyspark.sql.Column, str, ou int

La résolution des ID de cellule H3 qui couvrent la géographie.

parameter

Type

Description

col1

pyspark.sql.Column OU str

Chaîne de caractères représentant une géographie dans le système de référence de coordonnées WGS84 au format WKT ou GeoJSON, ou BINARY représentant une géographie dans le système de référence de coordonnées WGS84 au format WKB.

col2

pyspark.sql.Column, str, ou int

La résolution des ID de cellule H3 qui couvrent la géographie.

Exemples

Python
from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('POLYGON((-122.4194 37.7749,-118.2437 34.0522,-74.0060 40.7128,-122.4194 37.7749))', 2),],['wkt', 'res'])
df.select(dbf.h3_try_polyfillash3string('wkt', 'res').alias('result')).collect()
Output
[Row(result=['82268ffffffffff', '82269ffffffffff', '822987fffffffff', '8226e7fffffffff',     '822997fffffffff', '8226f7fffffffff', '822657fffffffff', '8229affffffffff'])]