Categorias:: Funções geoespaciais

H3_COVERAGE¶

Retorna um ARRAY de IDs (como valores INTEGER) identificando o conjunto mínimo de células H3 que cobrem completamente uma forma (especificada por um objeto GEOGRAPHY).

Consulte também:: H3_COVERAGE_STRINGS , H3_POLYGON_TO_CELLS

Sintaxe¶

H3_COVERAGE( <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 um ARRAY de valores INTEGER para IDs do conjunto mínimo de células H3 que cobrem completamente o formato de entrada especificado.

Notas de uso¶

A função utiliza aproximação esférica, que trata pontos na superfície da Terra como se estivessem conectados por arcos, em vez de linhas retas. Se você precisar de uma aproximação plana, use H3_POLYGON_TO_CELLS.
Uma célula será incluída no conjunto de resultados se seu limite fizer interseção com a forma de entrada.
Ao aplicar FLATTEN ao ARRAY retornado pela função, converta cada valor explicitamente em um número inteiro.

Exemplos¶

O exemplo a seguir retorna um ARRAY de IDs que identifica o conjunto mínimo de células H3 que cobrem completamente o polígono especificado.

SELECT H3_COVERAGE(
  TO_GEOGRAPHY(
    'POLYGON((-122.481889 37.826683,-122.479487 37.808548,-122.474150 37.808904,-122.476510 37.826935,-122.481889 37.826683))'),
  8) AS set_of_h3_cells_covering_polygon;

Copy

+----------------------------------+
| SET_OF_H3_CELLS_COVERING_POLYGON |
|----------------------------------|
| [                                |
|   613196571542028287,            |
|   613196571548319743,            |
|   613196571598651391,            |
|   613196571539931135,            |
|   613196571560902655,            |
|   613196571550416895             |
| ]                                |
+----------------------------------+