Freigeben über

h3_try_coverash3string-Funktion

Gilt für:Grünes Häkchen für „Ja“ Databricks SQL Grünes Häkchen für „Ja“ Databricks Runtime 16.3 und höher

Diese Funktion verhält sich genauso wie h3_coverash3string, gibt NULL aber anstelle eines Fehlers zurück, wenn das erste Argument ungültig ist. Es gibt ein ARRAY von BIGINT-Werten zurück, die H3-Zell-IDs darstellen. Diese Werte entsprechen der minimalen Menge von Sechsecken oder Fünfecken mit der angegebenen Auflösung, die die eingegebene lineare oder flächige Geografie vollständig abdecken.

Syntax

h3_try_coverash3string ( geographyExpr, resolutionExpr )

Argumente

  • geographyExpr: Ein BINARY oder STRING Ausdruck, der eine lineare (Linienzeichenfolge oder mehrzeilige Zeichenfolge) oder eine areale Geografie (Polygon oder Multipolygon) in WKB, WKT oder GeoJSON darstellt. Für die Geographie werden Längen- und Breitengrade in Grad erwartet, die sich auf das WGS84-Koordinatenreferenzsystem beziehen.
  • resolutionExpr: Ein INT Ausdruck mit einem Wert zwischen 0 und 15 einschließlich, der die Auflösung für die H3-Zell-IDs angibt.

Rückgabe

Ein ARRAY von BIGINT-Werten entsprechend der minimalen Menge von Sechsecken oder Fünfecken mit der angegebenen Auflösung, die die eingegebene lineare oder flächige Geografie vollständig abdecken

Die Funktion gibt NULL zurück, wenn einer der Eingabeausdrücke NULL ist. Wenn das erste Eingabeargument vom Typ BINARYist, muss der Eingabewert die WKB-Beschreibung einer Linienzeichenfolge, eines Polygons, einer mehrzeiligen Zeichenfolge oder eines Multipolygons sein. Wenn das erste Eingabeargument vom Typ STRINGist, muss der Eingabewert entweder das WKT oder die GeoJSON-Beschreibung einer Linienzeichenfolge, eines Polygons, einer mehrzeiligen Zeichenfolge oder eines Multipolygons sein. Die Dimension der Eingabelinienzeichenfolge -multilinienzeichenfolge, des Eingabepolygons oder -multipolygons kann 2D, 3DZ, 3DM oder 4D sein. Die Funktion gibt zurück NULL , wenn das erste Argument einer ungültigen WKB, WKT oder GeoJSON entspricht oder keine Linienzeichenfolge, ein Polygon, eine mehrzeilige Zeichenfolge oder ein Multipolygon darstellt.

Fehlerbedingungen

Beispiele

-- Simple example where the input is a triangle in WKT format.
> SELECT h3_coverash3string('POLYGON((-122.4194 37.7749,-118.2437 34.0522,-74.0060 40.7128,-122.4194 37.7749))', 0);
  [8027fffffffffff,8029fffffffffff,802bfffffffffff,8049fffffffffff]

-- Simple example where the input is a triangle in hexadecimal WKB format.
> SELECT h3_coverash3string(unhex('0103000000010000000400000050fc1873d79a5ec0d0d556ec2fe342404182e2c7988f5dc0f46c567dae064140aaf1d24d628052c05e4bc8073d5b444050fc1873d79a5ec0d0d556ec2fe34240'), 0);
  [8027fffffffffff,8029fffffffffff,802bfffffffffff,8049fffffffffff]

-- Simple example where the input is a linestring in GeoJSON format.
SELECT h3_coverash3string('{"type":"LineString","coordinates":[[-122.4194,37.7749],[-118.2437,34.0522],[-74.0060,40.7128]]}', 1);
  [8148fffffffffff, 8129bffffffffff, 812a3ffffffffff, 812abffffffffff, 81267ffffffffff, 8126fffffffffff, 81283ffffffffff]

-- Feeding an empty multipoint in GeoJSON format (as opposed to a linestring, polygon, multilinestring, or multipolygon).
> SELECT h3_try_coverash3string('{"type":"MultiPoint","coordinates":[]}', 2);
  null

-- Feeding an invalid WKB (invalid endianness value)
> SELECT h3_try_coverash3string(unhex('020700000000'), 2);
  null

-- Feeding an invalid polygon in WKT (polygon is not closed)
> SELECT h3_try_coverash3string('POLYGON((-122.4194 37.7749,-118.2437 34.0522,-74.0060 40.7128,-74.0060 40.7128))', 2);
  null

-- Resolution is out of range.
> SELECT h3_try_coverash3string('POLYGON((-122.4194 37.7749,-118.2437 34.0522,-74.0060 40.7128,-122.4194 37.7749))', 16);
  [H3_INVALID_RESOLUTION_VALUE] H3 resolution 16 must be between 0 and 15, inclusive
  • Last updated on