Tous les produits
Search
Centre de documentation

ApsaraDB RDS:ST_GridRing

Dernière mise à jour :Oct 10, 2026

Renvoie l'anneau creux de grilles H3 situées exactement à la distance de grille k de la grille d'origine. Contrairement à ST_GridDisk, qui renvoie toutes les grilles dans un rayon de distance k, ST_GridRing ne retourne que les grilles formant l'anneau extérieur à cette distance précise.

Syntaxe

SETOF h3grid ST_GridRing(h3grid origin, integer k)

Paramètres

Paramètre Type Description
origin h3grid La grille H3 centrale.
k integer La distance de grille par rapport à l'origine.

Exemples

L'exemple suivant renvoie toutes les grilles H3 situées à une distance de grille de 5 de la grille correspondant à la latitude 25.1 et à la longitude 123.1.

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

Résultat :

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

Étapes suivantes

  • ST_GridDisk : Renvoie toutes les grilles H3 situées à une distance de grille inférieure ou égale à k de l'origine (disque plein, et non anneau creux).

  • st_h3fromlatlng : Convertit des coordonnées de latitude et de longitude en valeur de grille H3.