H3_INVALID_GRID_DISTANCE_VALUE error class

SQLSTATE: 22023

H3 grid distance <k> must be non-negative

Parameters

  • k: The grid distance value (an INTEGER).

Explanation

Functions that return this error expect an H3 grid distance value. This distance value reflects the grid distance between two cells of the same resolution on the H3 grid. To be exact, the grid distance value refers to minimum distance on the dual graph of the H3 cell decomposition of the sphere.

Examples 

-- Invoking h3_kring with a negative distance value.
> SELECT h3_kring(599686042433355775, -2);
  [H3_INVALID_GRID_DISTANCE_VALUE] H3 grid distance -2 must be non-negative