Categories:

Geospatial functions

H3_IS_VALID_CELL

Returns TRUE if the input represents a valid H3 cell.

语法

H3_IS_VALID_CELL( <cell_id> )

实参

cell_id

An INTEGER value that represents the H3 cell ID (index (https://h3geo.org/docs/core-library/h3Indexing)), or a VARCHAR value that represents the cell ID in hexadecimal format.

返回

返回 BOOLEAN 或 NULL。

  • 如果输入表示有效的 H3 单元格，则值为 TRUE。否则返回 FALSE。
  • 如果输入为 NULL，则返回 NULL，不报错。

示例

以下示例指定一个表示有效 H3 单元格的整数。

SELECT H3_IS_VALID_CELL(613036919424548863);
+--------------------------------------+
| H3_IS_VALID_CELL(613036919424548863) |
%--------------------------------------%
| True                                 |
+--------------------------------------+

以下示例指定一个不表示有效 H3 单元格的字符串。

SELECT H3_IS_VALID_CELL('Invalid Cell');
+----------------------------------+
| H3_IS_VALID_CELL('INVALID CELL') |
%----------------------------------%
| False                            |
+----------------------------------+