Sdílet prostřednictvím

h3_try_coverash3string Funkce

Platí pro:zaškrtnuto ano Databricks SQL zaškrtnuto ano Databricks Runtime 16.3 a vyšší

Tato funkce se chová stejně jako h3_coverash3string, ale vrátí NULL místo chyby, pokud je první argument neplatný. Vrátí kolekci ARRAYBIGINT hodnot představujících ID buněk H3. Tyto hodnoty odpovídají minimální sadě šestiúhelníku nebo pětiúhelníku v zadaném rozlišení, které plně pokrývají vstupní lineární nebo areální geografii.

Syntaxe

h3_try_coverash3string ( geographyExpr, resolutionExpr )

Argumenty

  • geographyExpr: A BINARY nebo STRING výraz představující lineární geometrii (linestring nebo multilinestring) nebo plošnou geometrii (polygon nebo multipolygon) v WKB, WKT nebo GeoJSON. Očekává se, že zeměpisná oblast bude mít souřadnice zeměpisné délky a šířky ve stupních, které odkazují na souřadnicový referenční systém WGS84.
  • resolutionExpr: Výraz INT s hodnotou mezi 0 a 15 včetně, který určuje rozlišení identifikátorů buněk H3.

Návraty

ARRAY Hodnoty BIGINT odpovídající minimální sadě šestiúhelníků nebo pětiúhelníků v zadaném rozlišení, které plně pokrývají vstupní lineární nebo areální geografii.

Funkce vrátí NULL , pokud je některý ze vstupních výrazů NULL. Pokud je první vstupní argument typu BINARY, vstupní hodnota musí být WKB popis lomené čáry, mnohoúhelníku, multilomené čáry, nebo multipolygonu. Pokud je první vstupní argument typu STRING, musí být vstupní hodnota buď popis WKT, nebo GeoJSON pro linestring, polygon, multilinestring nebo multipolygon. Rozměr vstupní čáry, mnohoúhelníku, multilinestringu nebo multipolygonu může být 2D, 3DZ, 3DM nebo 4D. Funkce vrátí NULL , pokud první argument odpovídá neplatnému WKB, WKT nebo GeoJSON nebo nepředstavuje přímku, mnohoúhelník, multilinestring nebo multipolygon.

Stavy chyb

Příklady

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