Categorias:: Funções geoespaciais

H3_COVERAGE_STRINGS¶

Retorna um ARRAY 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).

Consulte também:: H3_COVERAGE , H3_POLYGON_TO_CELLS_STRINGS

Sintaxe¶

H3_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 um ARRAY de valores VARCHAR para IDs hexadecimais 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_STRINGS.
Uma célula será incluída no conjunto de resultados se seu limite fizer interseção com a forma de entrada.

Exemplos¶

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

SELECT H3_COVERAGE_STRINGS(
  TO_GEGGRAPHY(
    '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 |
|----------------------------------|
| [                                |
|   "882830870bfffff",             |
|   "8828308703fffff",             |
|   "8828308739fffff",             |
|   "8828308709fffff",             |
|   "8828308701fffff",             |
|   "8828308715fffff"              |
| ]                                |
|----------------------------------|