Categorias:: Funções geospaciais

H3_TRY_COVERAGE¶

Uma versão especial de H3_COVERAGE que retorna NULL se ocorrer um erro quando ele tentar retornar uma matriz de IDs (como valores INTEGER) identificando o conjunto mínimo de células H3 que cobrem completamente uma forma (especificada por um objeto GEOGRAPHY).

Sintaxe¶

H3_TRY_COVERAGE( <geography_expression> , <target_resolution> )

Argumentos¶

geography_expression

Um objeto GEOGRAPHY.

target_resolution

Um INTEGER entre 0 e 15 (inclusive) especificando resolução H3 que você deseja usar para as células H3 retornadas.

Especificar qualquer outro valor INTEGER resulta em erro.

Retornos¶

Retorna uma matriz de valores INTEGER ou NULL.

Se a função puder realizar um cálculo bem-sucedido, retornará uma matriz de valores INTEGER para IDs do conjunto mínimo de células H3 que cobrem completamente a forma de entrada especificada.
Se a função não puder executar um cálculo bem-sucedido, retornará NULL sem relatar um erro.

Notas de uso¶

Consulte H3_COVERAGE para as notas de uso.

Exemplos¶

O seguinte exemplo tenta retornar uma matriz de IDs que identificam um conjunto mínimo de células H3 que cobrem completamente uma forma (especificado por um objeto GEOGRAPHY). Como a matriz com as células que cobrem o hexágono fornecido na resolução fornecida excede o limite de tamanho permitido, a função retorna NULL.

SELECT H3_TRY_COVERAGE(
  TO_GEOGRAPHY('POLYGON((-108.959 40.948,
                         -109.015 37.077,
                         -102.117 36.956,
                         -102.134 40.953,
                         -108.959 40.948))'
              ), 15) AS set_of_h3_cells_covering_polygon;

+----------------------------------+
| SET_OF_H3_CELLS_COVERING_POLYGON |
|----------------------------------|
| NULL                             |
+----------------------------------+

Para exemplos que retornam com sucesso uma matriz de IDs, consulte H3_COVERAGE.