Todos os produtos
Search
Central de documentação

ApsaraDB RDS:ST_GridRing

Última atualização: Jul 05, 2026

Retorna o anel vazio de grids H3 situados exatamente à distância de grid k do grid de origem. Ao contrário da ST_GridDisk, que retorna todos os grids dentro da distância k, a ST_GridRing devolve apenas os grids do anel mais externo nessa distância exata.

Sintaxe

SETOF h3grid ST_GridRing(h3grid origin, integer k)

Parâmetros

Parâmetro

Tipo

Descrição

origin

h3grid

Grid H3 central.

k

integer

Distância de grid em relação à origem.

Exemplos

O exemplo a seguir retorna todos os grids H3 com distância de grid 5 do grid na latitude 25.1 e longitude 123.1.

SELECT ST_GridRing(st_h3fromlatlng(25.1, 123.1), 5);

Saída:

 st_griddisk
------------------------
 01010060170363C5BAF408
 01010066170363C5BAF408
 01010062170363C5BAF408
 01010063170363C5BAF408
 01010061170363C5BAF408
 ....
(31 rows)

Próximos passos

  • ST_GridDisk: Retorna todos os grids H3 dentro da distância de grid k da origem (disco preenchido, não um anel vazio).

  • st_h3fromlatlng: Converte uma coordenada de latitude/longitude em um valor de grid H3.