Funkce h3_try_polyfillash3string

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

Chová se stejně jako h3_polyfillash3string s tím rozdílem, že NULL se místo chyby vrátí, pokud je první argument neplatný. Přesněji řečeno vrátí ARRAY ID buněk H3 (reprezentované jako STRING) odpovídající šestiúhelníku nebo pětiúhelníku zadaného rozlišení, centroidy, které jsou obsaženy ve vstupní zeměpisná oblast.

Syntaxe

h3_try_polyfillash3string ( geographyExpr, resolutionExpr )

Argumenty

  • geographyExpr: A BINARY nebo STRING výraz představující areální zeměpisná oblast (mnohoúhelník nebo multipolygon) ve WKB, WKT nebo GeoJSON. Očekává se, že zeměpisné souřadnice délky a šířky budou ve stupních a budou odkazovat na referenční systém souřadnic WGS84.
  • resolutionExpr: Výraz INT , jehož hodnota by měla být mezi 0 buňkami H3 a 15 včetně, určuje rozlišení buněk H3.

Návraty

ARRAY Hodnota STRING odpovídající ID buňky H3 zadaného rozlišení, jejichž centroidy jsou obsaženy ve vstupní areální zeměpisné oblasti.

Funkce vrátí NULL , pokud je některý ze vstupních výrazů NULL. Pokud je první vstupní argument typu BINARY, očekává se, že vstupní hodnota bude popisem mnohoúhelníku nebo multipolygonu WKB . Pokud je první vstupní argument typu STRING, očekává se, že vstupní hodnota bude buď WKT , nebo GeoJSON popis mnohoúhelníku nebo multipolygonu. Rozměr vstupního mnohoúhelníku 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 mnohoúhelník nebo multipolygon.

Chybové podmínky

Příklady

-- Simple example where the input is a triangle in WKT format.
> SELECT h3_try_polyfillash3string('POLYGON((-122.4194 37.7749,-118.2437 34.0522,-74.0060 40.7128,-122.4194 37.7749))', 2);
  [82268ffffffffff,82269ffffffffff,822987fffffffff,8226e7fffffffff,822997fffffffff,8226f7fffffffff,822657fffffffff,8229affffffffff]

-- Simple example where the input is a triangle in hexadecimal WKB format.
> SELECT h3_try_polyfillash3string(unhex('0103000000010000000400000050fc1873d79a5ec0d0d556ec2fe342404182e2c7988f5dc0f46c567dae064140aaf1d24d628052c05e4bc8073d5b444050fc1873d79a5ec0d0d556ec2fe34240'), 2);
  [82268ffffffffff,82269ffffffffff,822987fffffffff,8226e7fffffffff,822997fffffffff,8226f7fffffffff,822657fffffffff,8229affffffffff]

-- The input is invalid.
> SELECT h3_try_polyfillash3string('Not-a-valid-rep', 2);
  null

-- Resolution is out of range.
> SELECT h3_try_polyfillash3string('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