Funkcja h3_try_polyfillash3string

  • Artykuł

Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 11.3 LTS i nowsze

Zachowuje się tak samo jak h3_polyfillash3string, z tą różnicą, że wartość NULL jest zwracana zamiast błędu, jeśli pierwszy argument jest nieprawidłowy. Dokładniej, zwraca tablicę identyfikatorów komórek H3 (reprezentowanych jako CIĄG) odpowiadający sześciokąta lub pentagony określonej rozdzielczości, które są zawarte w danych wejściowych są geograficzne.

Składnia

h3_try_polyfillash3string ( geographyExpr, resolutionExpr )

Argumenty

  • geographyExpr: wyrażenie BINARY lub STRING reprezentujące geografię arealną (wielokąt lub wielopolygon) w plikach WKB, WKT lub GeoJSON. Oczekuje się, że lokalizacja geograficzna ma współrzędne długości i szerokości geograficznej w stopniach odwołujących się do systemu odniesienia współrzędnych WGS84 .
  • resolutionExpr: Wyrażenie INT, którego wartość powinna należeć do przedziału od 0 do 15 włącznie, określając rozdzielczość komórek H3.

Zwraca

Tablica wartości STRING odpowiadających identyfikatorom komórek H3 określonej rozdzielczości, które znajdują się w lokalizacji geograficznej danych wejściowych.

Funkcja zwraca wartość NULL, jeśli dowolne z wyrażeń wejściowych ma wartość NULL. Jeśli pierwszym argumentem wejściowym jest typ BINARY, wartość wejściowa powinna być opisem wielokąta lub wielopolygonu. Jeśli pierwszym argumentem wejściowym jest typ STRING, wartość wejściowa powinna być wkt lub w formacie GeoJSON opisu wielokąta lub wielopolygonu. Wymiar wielokąta wejściowego lub wielopolygonu może być 2D, 3DZ, 3DM lub 4D. Funkcja zwraca wartość NULL, jeśli pierwszy argument odpowiada nieprawidłowemu kodowi WKB, WKT lub GeoJSON albo nie reprezentuje wielokąta ani wielobiegu.

Warunki błędu

Przykłady

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