Sdílet prostřednictvím

h3_coverash3string Funkce

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

Vrátí pole hodnot typu STRING, které představují ID buněk H3. Tyto hodnoty odpovídají minimální sadě šestiúhelníku nebo pětiúhelníku zadaného rozlišení, které plně pokrývají vstupní lineární nebo areální geografii.

Syntaxe

h3_coverash3 ( geographyExpr, resolutionExpr )

Arguments

  • geographyExpr: Binární nebo řetězcový výraz představující lineární (linestring nebo multilinestring) nebo plošný (polygon nebo multipolygon) zeměpis ve formátu 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 referenční systém souřadnic WGS84.
  • resolutionExpr: Výraz INT s hodnotou mezi 0 a 15 včetně, který určuje rozlišení ID H3 buněk.

Návraty

Pole hodnot typu String odpovídající minimální sadě ID buněk H3 s určeným rozlišením, které plně pokrývají zadanou lineární nebo areální geografii.

Funkce vrátí NULL , pokud je některý ze vstupních výrazů NULL. Pokud je prvním vstupním argumentem typ BINARY, vstupní hodnota musí být popisem WKB přímky, mnohoúhelníku, multilinestringu nebo multipolygonu. Pokud je první vstupní argument typu STRING, pak vstupní hodnota musí být buď ve formátu WKT nebo GeoJSON a musí popisovat liniový segment, mnohoúhelník, víceřetězcový liniový segment nebo multipolygon. Rozměr vstupní čáry, mnohoúhelníku, multilinestringu nebo multipolygonu může být 2D, 3DZ, 3DM nebo 4D.

Podmínky chyb

  • Pokud geographyExpr je typu BINARY a hodnota je buď neplatný WKB, nebo nepředstavuje linestring, polygon, multilinestring nebo multipolygon, funkce vrátí WKB_PARSE_ERROR.
  • Pokud geographyExpr je typu STRING a hodnota je buď neplatný WKT, nebo nepředstavuje linestring, mnohoúhelník, multilinestring nebo multipolygon, vrátí funkce WKT_PARSE_ERROR.
  • Pokud geographyExpr je typu STRING a hodnota je buď neplatná GeoJSON, nebo nepředstavuje spojnicový řetězec, mnohoúhelník, multilinestring nebo multipolygon, vrátí funkce GEOJSON_PARSE_ERROR.
  • Pokud je resolutionExpr menší než 0 nebo větší než 15, funkce vrátí H3_INVALID_RESOLUTION_VALUE.

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_coverash3string('{"type":"MultiPoint","coordinates":[]}', 2);
  [GEOJSON_PARSE_ERROR] Error parsing GeoJSON: Invalid or unsupported type '"MultiPoint"' at position 9

-- Feeding an invalid WKB (invalid endianness value)
> SELECT h3_coverash3string(unhex('020700000000'), 2);
  [WKB_PARSE_ERROR] Error parsing WKB: Invalid byte order 2 at position 1

-- Feeding an invalid polygon in WKT (polygon is not closed)
> SELECT h3_coverash3string('POLYGON((-122.4194 37.7749,-118.2437 34.0522,-74.0060 40.7128,-74.0060 40.7128))', 2);
  [WKT_PARSE_ERROR] Error parsing WKT: Found non-closed ring at position 80

-- Resolution is out of range.
> SELECT h3_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