h3_boundaryaswkt
fungsi
Berlaku untuk: Databricks SQL Databricks Runtime 11.3 LTS ke atas
Menampilkan batas poligonal sel H3 input dalam format WKT.
Sintaks
h3_boundaryaswkt ( h3CellIdExpr )
Argumen
h3CellIdExpr
: Ekspresi BIGINT, atau ekspresi STRING heksadesimal yang mewakili ID sel H3.
Mengembalikan
Nilai jenis STRING yang mewakili batas poligonal sel H3 input dalam format WKT .
Fungsi mengembalikan NULL jika ekspresi input adalah NULL.
Fungsi melakukan validasi parsial mengenai apakah argumen input adalah ID sel H3 yang valid. Kondisi yang diperlukan, tetapi tidak memadai untuk ID H3 yang valid adalah bahwa nilainya antara 0x08001fffffffffff
dan 0x08ff3b6db6db6db6
.
Perilaku fungsi tidak ditentukan jika ID sel input bukan ID sel yang valid.
Kondisi kesalahan
- Jika
h3CellIdExpr
adalah STRING yang tidak dapat dikonversi ke BIGINT atau sesuai dengan nilai BIGINT yang lebih kecil dari0x08001fffffffffff
atau lebih besar dari0x08ff3b6db6db6db6
, fungsi mengembalikan H3_INVALID_CELL_ID.
Contoh
-- 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