h3_boundaryaswkt
işlevi
Şunlar için geçerlidir: Databricks SQL Databricks Runtime 11.3 LTS ve üzeri
WKT biçimindeki giriş H3 hücresinin çokgen sınırını döndürür.
Söz dizimi
h3_boundaryaswkt ( h3CellIdExpr )
Bağımsız değişkenler
h3CellIdExpr
: H3 hücre kimliğini temsil eden bir BIGINT ifadesi veya onaltılık STRING ifadesi.
Döndürülenler
WKT biçimindeki giriş H3 hücresinin çokgen sınırını temsil eden STRING türünde bir değer.
Giriş ifadesi NULL ise işlev NULL döndürür.
İşlev, giriş bağımsız değişkeninin geçerli bir H3 hücre kimliği olup olmadığıyla ilgili kısmi doğrulama yapar. Geçerli bir H3 kimliği için gerekli ancak yeterli olmayan bir koşul, değerinin ile 0x08ff3b6db6db6db6
arasında 0x08001fffffffffff
olmasıdır.
Giriş hücresi kimliği geçerli bir hücre kimliği değilse işlevin davranışı tanımsız olur.
Hata koşulları
- BIGINT'e dönüştürülemeyen veya değerinden küçük
0x08001fffffffffff
veya daha0x08ff3b6db6db6db6
büyük bir BIGINT değerine karşılık gelen bir STRING iseh3CellIdExpr
, işlev H3_INVALID_CELL_ID döndürür.
Örnekler
-- Input a BIGINT representing a hexagonal cell.
> SELECT h3_boundaryaswkt(599686042433355775)
POLYGON((-121.91508032706 37.271355866732,-121.86222328902 37.353926450852,-121.9235499963 37.428341186094,-122.03773496427 37.420128677678,-122.09042892904 37.337556084353,-122.02910130919 37.263197974618,-121.91508032706 37.271355866732))
-- Input a STRING representing a pentagonal cell.
> SELECT h3_boundaryaswkt('8009fffffffffff')
POLYGON((-10.444977544778 63.095054077525,5.5236465492903 55.706768465152,25.082722326708 58.401544870353,31.831280499087 68.92995788194,0.32561035194326 73.310223685444,-10.444977544778 63.095054077525))
-- Input is an invalid H3 cell ID.
> SELECT h3_boundaryaswkt(0)
[H3_INVALID_CELL_ID] 0 is not a valid H3 cell ID