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 |
|
|
h3grid |
Grid H3 central. |
|
|
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 gridkda origem (disco preenchido, não um anel vazio).st_h3fromlatlng: Converte uma coordenada de latitude/longitude em um valor de grid H3.