h3_try_polyfillash3string
işlevi
Şunlar için geçerlidir: Databricks SQL Databricks Runtime 11.3 LTS ve üzeri
İlk bağımsız değişken geçersizse hata yerine NULL döndürülmesi dışında h3_polyfillash3string ile aynı şekilde davranır. Daha kesin olarak, giriş yan coğrafyasının içerdiği 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_try_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ğeri 0 ile 15 arasında olması beklenen ve H3 hücrelerinin çö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. İlk bağımsız değişken geçersiz bir WKB, WKT veya GeoJSON'a karşılık geliyorsa ya da bir çokgen veya çok köşeligen temsil etmiyorsa işlev NULL döndürür.
Hata koşulları
- değerinden küçük
0
veya daha15
büyükseresolutionExpr
işlev H3_INVALID_RESOLUTION_VALUE döndürür.
Örnekler
-- 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