Categorias:: Funções geoespaciais

H3_POLYGON_TO_CELLS_STRINGS¶

Retorna um ARRAY de valores VARCHAR dos IDs hexadecimais de células H3 que têm centroides contidos em um polígono (especificado por um objeto GEOGRAPHY).

Consulte também:: H3_POLYGON_TO_CELLS_STRINGS , H3_COVERAGE_STRINGS

Sintaxe¶

H3_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) 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 das células H3 que possuem centroides contidos no polígono de entrada especificado.

Notas de uso¶

A função utiliza aproximação planar, que trata pontos na superfície da Terra como se estivessem conectados por linhas retas, em vez de arcos curvos. Se você precisar de uma aproximação esférica, use H3_COVERAGE_STRINGS.
Uma célula é considerada dentro do polígono se seu centroide estiver contido no polígono.

Exemplos¶

O exemplo a seguir retorna um ARRAY de valores VARCHAR representando os IDs hexadecimais de células H3 que possuem centroides contidos no polígono especificado.

SELECT H3_POLYGON_TO_CELLS_STRINGS(
  TO_GEOGRAPHY(
    'POLYGON((-122.481889 37.826683,-122.479487 37.808548,-122.474150 37.808904,-122.476510 37.826935,-122.481889 37.826683))'),
  9) AS h3_cells_in_polygon;

Copy

+----------------------+
| H3_CELLS_IN_POLYGON  |
|----------------------|
| [                    |
|   "8928308715bffff", |
|   "89283087397ffff", |
|   "89283087023ffff", |
|   "892830870abffff", |
|   "89283087027ffff", |
|   "89283087033ffff", |
|   "8928308702fffff", |
|   "892830870bbffff", |
|   "89283087037ffff"  |
| ]                    |
+----------------------+