h3_try_tessellateaswkb

Renvoie un tableau de structs représentant les puces couvrant la géographie à la résolution spécifiée, ou null si la géométrie est invalide. Plus précisément, les éléments du tableau renvoyé sont des structures nommées avec trois noms de champs « cellid », « core » et « chip » :

• Le champ « cellid » contient l'une des cellules H3 couvrant la zone géographique d'entrée.
• Le champ « core » détermine si le polygone de délimitation de la cellule H3 dans le champ « cellid » est contenu dans la zone géographique d'entrée. Cela ne peut se produire que pour les zones géographiques d'entrée surfaciques. Si la cellule est contenue dans la zone géographique d'entrée, la valeur est définie sur True, et false sinon.
• Le champ « chip » est l'intersection (cartésienne) du polygone de la cellule H3, correspondant à l'ID de cellule H3 dans le champ « cellid », avec la géographie d'entrée, représentée au format WKB. L'ensemble des ID de cellules H3 renvoyés en tant qu'éléments « cellid » des structures dans le tableau est un ensemble de couverture minimal pour la géographie d'entrée.

Pour la fonction Databricks SQL correspondante, consultez la fonctionh3_try_tessellateaswkb.

Syntaxe

Python

from pyspark.databricks.sql import functions as dbf

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

parameter

parameter	Type	Description
col1	pyspark.sql.Column OU str	Une chaîne représentant une géographie dans le système de référence de coordonnées WGS84 au format WKT ou GeoJSON, ou un BINAIRE représentant une géographie linéaire ou surfacique 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	Une chaîne représentant une géographie dans le système de référence de coordonnées WGS84 au format WKT ou GeoJSON, ou un BINAIRE représentant une géographie linéaire ou surfacique 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
from pyspark.sql import functions as f
df = spark.createDataFrame([('MULTIPOINT(20 0,20 10,40 30)', 0),], ['wkt', 'res'])
chips = df.select(f.inline(dbf.h3_try_tessellateaswkb('wkt', 'res')).alias('cell', 'core', 'chip'))
chips.select(dbf.h3_h3tostring('cell').alias('cell'),dbf.st_astext(dbf.st_geomfromwkb('chip')).alias('wkt')).collect()

Output

[Row(cell='802dfffffffffff', wkt='POINT(40 30)'),     Row(cell='806bfffffffffff', wkt='MULTIPOINT((20 0),(20 10))')]