Share via


h3_boundaryasgeojson işlevi

Ş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

GeoJSON biçimindeki giriş H3 hücresinin çokgen sınırını döndürür.

Söz dizimi

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

GeoJSON biçiminde 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 0x08ff3b6db6db6db6arası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 daha 0x08ff3b6db6db6db6bü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_boundaryasgeojson(599686042433355775)
  {"type":"Polygon","coordinates":[[[-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_boundaryasgeojson('8009fffffffffff')
  {"type":"Polygon","coordinates":[[[-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_boundaryasgeojson(0)
  [H3_INVALID_CELL_ID] 0 is not a valid H3 cell ID