h3_try_coverash3string

Returnerar en matris med H3-cell-ID:er som representeras som strängar, motsvarande sexhörningar eller femhörningar i den angivna upplösningen som minimalt täcker indataradiska eller areala geografiska områden. Uttrycket returnerar None om geografin inte är linjär (linjesträng eller multilinestring), areal (polygon eller multipolygon) eller om ett fel upptäcks vid parsning av indata. Uttrycket returnerar ett fel om inmatningsupplösningen är ogiltig. De acceptabla indatarepresentationerna är WKT, GeoJSON och WKB. I de första två fallen förväntas indata vara av typen sträng, medan indata i det sista fallet förväntas vara av typen BINÄR.

För motsvarande Databricks SQL-funktion, se h3_try_coverash3string funktion.

Syntax

from pyspark.databricks.sql import functions as dbf

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

Parameterar

Parameter	Typ	Description
col1	pyspark.sql.Column eller str	En sträng som representerar ett linjärt eller arealt geografiskt område i WGS84-koordinatreferenssystemet i WKT- eller GeoJSON-format, eller en BIN-fil som representerar ett linjärt eller arealt geografiskt område i WGS84-koordinatreferenssystemet i WKB-format.
col2	pyspark.sql.Column, str eller int	Upplösningen för de H3-cell-ID:er som täcker geografin.

Examples

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)]