Aracılığıyla paylaş

h3_try_polyfillash3string işlev

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

İlk argüman geçersizse hata yerine NULL döner, bunun dışında h3_polyfillash3string ile aynı şekilde davranır. Daha kesin olarak, belirtilen çözünürlükteki altıgen veya beşgenlere karşılık gelen ve giriş alan coğrafyasında bulunan H3 hücre kimliklerinden oluşan bir DIZI (STRING olarak temsil edilir) döndürür.

Söz dizimi

h3_try_polyfillash3string ( geographyExpr, resolutionExpr )

Argümanlar

  • geographyExpr: WKB, WKT veya GeoJSON biçiminde bir areal coğrafyayı (çokgen veya çoklu çokgen) 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.

İadeler

STRING değerlerinden oluşan, belirtilen çözünürlükteki H3 hücre kimliklerine karşılık gelen ve giriş coğrafyası tarafından kapsanan bir dizi.

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 bir çokgen veya çoklu çokgenin WKB açıklaması olması beklenir. İlk giriş bağımsız değişkeni STRING türündeyse, giriş değerinin bir çokgen veya çoklu çokgenin WKT veya GeoJSON tanımı olması beklenir. Giriş çokgeninin veya çok kutuplunun boyutu 2B, 3DZ, 3DM veya 4D olabilir. İlk bağımsız değişken geçersiz WKB, WKT veya GeoJSON'a karşılık geliyorsa ya da bir çokgen veya çoklu çokgen temsil etmiyorsa işlev NULL döndürür.

Hata koşulları

Ö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