Categorias:

Funções geospaciais

H3_TRY_POLYGON_TO_CELLS_STRINGS

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

Sintaxe

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

  • Se a função puder realizar um cálculo bem-sucedido, retornará uma matriz de valores VARCHAR para os IDs hexadecimais 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_STRINGS para as notas de uso.

Exemplos

O exemplo a seguir tenta retornar uma matriz de valores VARCHAR de IDs hexadecimais de células H3 que têm centroides contidos por 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_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 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_STRINGS.

Linguagem: Português