h3_centeraswkt fungsi

  • Artikel

Berlaku untuk:centang ditandai ya Databricks SQL centang ditandai ya Databricks Runtime 11.3 LTS ke atas

Menampilkan pusat sel H3 input sebagai titik dalam format WKT.

Sintaks

h3_centeraswkt ( h3CellIdExpr )

Argumen

  • h3CellIdExpr: Ekspresi BIGINT, atau ekspresi STRING heksadesimal yang mewakili ID sel H3.

Mengembalikan

Nilai jenis STRING yang mewakili pusat sel H3 input sebagai titik 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 atau tidak. 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 dari 0x08001fffffffffff atau lebih besar dari 0x08ff3b6db6db6db6, fungsi mengembalikan H3_INVALID_CELL_ID.

Contoh

-- Input a BIGINT representing a hexagonal cell.
> SELECT h3_centeraswkt(599686042433355775)
  POINT(-121.97637597255 37.345793375368)

-- Input a STRING representing a pentagonal cell.
> SELECT h3_centeraswkt('8009fffffffffff')
  POINT(10.536199075468 64.700000127935)

-- Input is an invalid H3 cell ID.
> SELECT h3_centeraswkt(0)
  [H3_INVALID_CELL_ID] 0 is not a valid H3 cell ID