h3_pointash3string

Zwraca identyfikator komórki H3 (jako ciąg) odpowiadający podanemu punktowi w określonej rozdzielczości. Wyrażenie emituje błąd, jeśli lokalizacja geograficzna nie jest punktem lub jeśli podczas analizowania reprezentacji wejściowej lokalizacji geograficznej zostanie znaleziony błąd. Dopuszczalne reprezentacje wejściowe to WKT, GeoJSON i WKB. W pierwszych dwóch przypadkach dane wejściowe powinny być ciągiem znaków, natomiast w ostatnim przypadku dane wejściowe powinny być typu binarnego. Obsługuje program Spark Connect.

Aby uzyskać odpowiednią funkcję SQL usługi Databricks, zobacz h3_pointash3string funkcja.

Składnia

from pyspark.databricks.sql import functions as dbf

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

Parametry

Parameter	Typ	Description
col1	pyspark.sql.Column lub str	Ciąg reprezentujący lokalizację geograficzną punktu w systemie odniesienia współrzędnych WGS84 w formacie WKT lub GeoJSON albo plik BINARNY reprezentujący lokalizację geograficzną w systemie odniesienia współrzędnych WGS84 w formacie WKB.
col2	pyspark.sql.Column, str lub int	Poziom rozdzielczości identyfikatora komórki H3, który chcemy obliczyć i który odpowiada lokalizacji geograficznej punktu.

Przykłady

from pyspark.databricks.sql import functions as dbf
df = spark.createDataFrame([('POINT(-122.4783 37.8199)', 13),], ['wkt', 'res'])
df.select(dbf.h3_pointash3string('wkt', 'res').alias('result')).collect()

[Row(result='8d283087022a93f')]

df.select(dbf.h3_pointash3string('wkt', 13).alias('result')).collect()

[Row(result='8d283087022a93f')]