回傳一個以字串表示的 H3 cell ID 陣列，對應於輸入區域地理所包含的指定解析度的六角形或五邊形。 隔離程度由細胞重心決定：若細胞的重心位於區域地理範圍內，則該細胞被視為覆蓋了該地理區域。 若地理圖形不是面狀（多邊形或多重多邊形），或在解析輸入的地理表示形式時發現錯誤，則該表達式會產生錯誤。 可接受的輸入表示方式有 WKT、GeoJSON 和 WKB。 前兩種情況下，輸入預期為字串型，而最後一種則預期為二進位型。 支援 Spark Connect。
關於對應的 Databricks SQL 函式，請參見 h3_polyfillash3string 函數。
語法
from pyspark.databricks.sql import functions as dbf
dbf.h3_polyfillash3string(col1=<col1>, col2=<col2>)
參數
| 參數 | 類型 | Description |
|---|---|---|
col1 |
pyspark.sql.Column 或 str |
一個字串代表 WGS84 座標參考系統中地理的字串（WKT 或 GeoJSON 格式），或一個二進位代表 WGS84 座標參考系統中地理的 WKB 格式。 |
col2 |
pyspark.sql.Column、str 或 int |
涵蓋地理範圍的 H3 cell ID 解析度。 |
範例
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_polyfillash3string('wkt', 'res').alias('result')).collect()
[Row(result=['82268ffffffffff', '82269ffffffffff', '822987fffffffff', '8226e7fffffffff', '822997fffffffff', '8226f7fffffffff', '822657fffffffff', '8229affffffffff'])]