Funkcja h3_polyfillash3string

  • Artykuł

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

Zwraca tablicę identyfikatorów komórek H3 (reprezentowanych jako CIĄG) odpowiadających sześciokątom lub pentagonom określonej rozdzielczości, które są zawarte w danych wejściowych są geograficzne.

Składnia

h3_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ść ma być między 0 i 15 inkluzywna, określając rozdzielczość identyfikatorów 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.

Warunki błędu

  • Jeśli geographyExpr jest typu BINARY, a wartość jest nieprawidłowa WKB lub nie reprezentuje wielokąta lub wielopolygonu, funkcja zwraca WKB_PARSE_ERROR.
  • Jeśli geographyExpr jest typu STRING, a wartość jest nieprawidłową wartością WKT lub nie reprezentuje wielokąta lub wielopolygonu, funkcja zwraca WKT_PARSE_ERROR.
  • Jeśli geographyExpr jest typu STRING, a wartość jest nieprawidłową wartością GeoJSON lub nie reprezentuje wielokąta lub wielobiegu, funkcja zwraca GEOJSON_PARSE_ERROR.
  • Jeśli resolutionExpr funkcja jest mniejsza lub większa niż 150 , funkcja zwraca H3_INVALID_RESOLUTION_VALUE.

Przykłady

-- Simple example where the input is a triangle in WKT format.
> SELECT h3_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_polyfillash3string(unhex('0103000000010000000400000050fc1873d79a5ec0d0d556ec2fe342404182e2c7988f5dc0f46c567dae064140aaf1d24d628052c05e4bc8073d5b444050fc1873d79a5ec0d0d556ec2fe34240'), 2)
  [82268ffffffffff,82269ffffffffff,822987fffffffff,8226e7fffffffff,822997fffffffff,8226f7fffffffff,822657fffffffff,8229affffffffff]

-- Feeding an empty linestring in GeoJSON format (as opposed to a polygon or multipolygon).
> SELECT h3_polyfillash3string('{"type":"LineString","coordinates":[]}', 2)
  [GEOJSON_PARSE_ERROR] Error parsing GeoJSON: Invalid or unsupported type '"LineString"' at position 9

-- Feeding an invalid WKB (invalid endianness value)
> SELECT h3_polyfillash3string(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_polyfillash3string('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_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