h3_try_coverash3string
Renvoie un tableau d'ID de cellule H3 représentés sous forme de chaînes, correspondant à des hexagones ou des pentagones de la résolution spécifiée qui couvrent au minimum la géographie linéaire ou surfacique d'entrée. L'expression renvoie None si la géographie n'est pas linéaire (linestring ou multilinestring), surfacique (polygon ou multipolygon) ou si une erreur est détectée lors de l'analyse de l'entrée. L'expression renvoie une erreur si la résolution d'entrée est non valide. 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, tandis que dans le dernier cas, l'entrée doit être de type BINARY.
Pour la fonction Databricks SQL correspondante, consultez la fonctionh3_try_coverash3string.
Syntaxe
from pyspark.databricks.sql import functions as dbf
dbf.h3_try_coverash3string(col1=<col1>, col2=<col2>)
parameter
parameter | Type | Description |
|---|---|---|
|
| Une chaîne représentant une géographie linéaire ou surfacique dans le système de référence de coordonnées WGS84 au format WKT ou GeoJSON, ou un BINARY représentant une géographie linéaire ou surfacique dans le système de référence de coordonnées WGS84 au format WKB. |
|
| La résolution des ID de cellule H3 qui couvrent la géographie. |
Exemples
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))', 1),],['wkt', 'res'])
df.select(dbf.h3_try_coverash3string('wkt', 'res').alias('result')).collect()
[Row(result=['8126fffffffffff', '81283ffffffffff', '8129bffffffffff', '812a3ffffffffff', '812abffffffffff', '8148fffffffffff', '81263ffffffffff', '81267ffffffffff', '8126bffffffffff'])]
df_invalid = spark.createDataFrame([('invalid input', 1),], ['wkt', 'res'])
df_invalid.select(dbf.h3_try_coverash3string('wkt', 'res').alias('result')).collect()
[Row(result=None)]