Categorias:

Funções geospaciais

H3_TRY_COVERAGE_STRINGS

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

Sintaxe

H3_TRY_COVERAGE_STRINGS( <geography_expression> , <target_resolution> )
Copy

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 VARCHAR ou NULL.

  • Se a função puder realizar um cálculo bem-sucedido, retornará uma matriz de valores VARCHAR para IDs hexadecimais 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_STRINGS 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_STRINGS(
  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;
Copy
+----------------------------------+
| SET_OF_H3_CELLS_COVERING_POLYGON |
|----------------------------------|
| NULL                             |
+----------------------------------+

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

Linguagem: Português