Categorias:

Funções geospaciais

H3_TRY_POLYGON_TO_CELLS

Uma versão especial de H3_POLYGON_TO_CELLS que retorna NULL se ocorrer um erro quando ele tenta retornar uma matriz de valores INTEGER de IDs de células H3 que têm centroides contidos em um polígono (especificado por um objeto GEOGRAPHY).

Sintaxe

H3_TRY_POLYGON_TO_CELLS( <geography_polygon> , <target_resolution> )
Copy

Argumentos

geography_polygon

Um objeto GEOGRAPHY que representa um polígono.

target_resolution

Um INTEGER entre 0 e 15 (inclusive) que especifica a 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 os IDs das células H3 que têm centroides contidos no polígono de entrada especificado.

  • Se a função não puder executar um cálculo bem-sucedido, retornará NULL sem relatar um erro.

Notas de uso

Consulte H3_POLYGON_TO_CELLS para as notas de uso.

Exemplos

O exemplo a seguir tenta retornar uma matriz de valores INTEGER dos IDs de células H3 que têm centroides contidos em um polígono (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_POLYGON_TO_CELLS(
  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 h3_cells_in_polygon;
Copy
+---------------------+
| H3_CELLS_IN_POLYGON |
|---------------------|
| NULL                |
+---------------------+

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

Linguagem: Português