`h3_polyfillash3string` işlevi

Makale
04/18/2024

Şunlar için geçerlidir: onay işareti evet olarak işaretlenmiş Databricks SQL Databricks Runtime 11.3 LTS ve üzeri

Giriş yan coğrafyası tarafından kapsanan belirtilen çözünürlüğün altıgenlerine veya beşgenlerine karşılık gelen H3 hücre kimliklerinden oluşan bir DIZI (STRING olarak temsil edilir) döndürür.

Söz dizimi

h3_polyfillash3string ( geographyExpr, resolutionExpr )

Bağımsız değişkenler

geographyExpr: WKB, WKT veya GeoJSON'da bir areal coğrafyayı (çokgen veya çok kutuplu) temsil eden binary veya STRING ifadesi. Coğrafyanın WGS84 koordinat başvuru sistemine başvuran derecelerde boylam ve enlem koordinatlarına sahip olması beklenir.
resolutionExpr: Değerinin arasında 0 ve 15 kapsayıcı olması beklenen, H3 hücre kimliklerinin çözünürlüğünü belirten bir INT ifadesi.

Döndürülenler

Giriş areal coğrafyası tarafından kapsanan, belirtilen çözümlemenin H3 hücre kimliklerine karşılık gelen STRING değerleri dizisi.

Giriş ifadelerinden herhangi biri NULL ise işlev NULL döndürür. İlk giriş bağımsız değişkeni binary türündeyse, giriş değerinin çokgen veya çok kutuplu bir WKB açıklaması olması beklenir. İlk giriş bağımsız değişkeni STRING türündeyse, giriş değerinin bir çokgen veya çok köşeligenin WKT veya GeoJSON açıklaması olması beklenir. Giriş çokgeninin veya çok kutuplunun boyutu 2B, 3DZ, 3DM veya 4D olabilir.

Hata koşulları

binary türündeyse ve değer geçersiz bir WKB ise veya çokgen veya çok köşeligen temsil etmiyorsageographyExpr, işlev WKB_PARSE_ERROR döndürür.
STRING türündeyse ve değer geçersiz bir WKT ise veya çokgen veya çok kutuplu bir değeri temsil etmiyorsageographyExpr, işlev WKT_PARSE_ERROR döndürür.
STRING türündeyse ve değer geçersiz bir GeoJSON ise veya çokgen veya çok kutuplu bir değeri temsil etmiyorsageographyExpr, işlev GEOJSON_PARSE_ERROR döndürür.
değerinden küçük 0 veya daha 15büyükse resolutionExpr işlev H3_INVALID_RESOLUTION_VALUE döndürür.

Örnekler

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

h3_polyfillash3string işlevi