Funkcja h3_try_polyfillash3

  • 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_polyfillash3, 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 BIGINT) 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_polyfillash3 ( 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 BIGINT odpowiadających identyfikatorom komórek H3 określonej rozdzielczości, które są zawarte w danych wejściowych są geograficzne.

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_polyfillash3('POLYGON((-122.4194 37.7749,-118.2437 34.0522,-74.0060 40.7128,-122.4194 37.7749))', 2)
  [586146350232502271,586147449744130047,586198577034821631,586152397546455039,586199676546449407,586153497058082815,586142501941805055,586201325813891071]

-- Simple example where the input is a triangle in hexadecimal WKB format.
> SELECT h3_try_polyfillash3(unhex('0103000000010000000400000050fc1873d79a5ec0d0d556ec2fe342404182e2c7988f5dc0f46c567dae064140aaf1d24d628052c05e4bc8073d5b444050fc1873d79a5ec0d0d556ec2fe34240'), 2)
  [586146350232502271,586147449744130047,586198577034821631,586152397546455039,586199676546449407,586153497058082815,586142501941805055,586201325813891071]

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

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