H3_INVALID_RESOLUTION_VALUE error class
H3 resolution <actual_value> must be between <minimum_value> and <maximum_value>, inclusive
Parameters
h3Cell: An input value that was expected to correspond to a valid H3 cell ID.
actual_value: The actual resolution value (an INTEGER), passed to the SQL function.
minimum_value: The minimum acceptable resolution (an INTEGER) in the context of the SQL function (usually
0
).maximum_value: The maximum acceptable resolution (an INTEGER) in the context of the SQL function (usually
15
).
Explanation
Functions that emit this error expect a valid H3 resolution value. Valid H3 resolution values are between 0
and 15
. Some SQL functions may restrict the range even further based on the function’s context.
Examples
-- Invoking h3_longlatash3 with a resolution that is out of the valid range.
> SELECT h3_longlatash3(40, -120, 16);
[H3_INVALID_RESOLUTION_VALUE] H3 resolution 16 must be between 0 and 15, inclusive
-- Invoking h3_toparent with a resolution that is larger than the input cell’s resolution.
> SELECT h3_toparent(599686042433355775, h3_resolution(599686042433355775) + 1);
[H3_INVALID_RESOLUTION_VALUE] H3 resolution 6 must be between 0 and 5, inclusive