Tous les produits
Search
Centre de documentation

PolarDB:ST_AsPng

Dernière mise à jour :Sep 01, 2026

Génère une tuile d'une pyramide vectorielle sous la forme d'une image PNG et renvoie le résultat en tant que valeur bytea. Indiquez soit l'identifiant de la tuile sous forme de chaîne, soit les coordonnées x/y/z explicites.

Syntaxe

bytea ST_AsPng(cstring name, cstring key, cstring style);
bytea ST_AsPng(cstring name, int x, int y, int z, cstring style);

Paramètres

Paramètre Type Description
name cstring Nom de la pyramide.
key cstring Identifiant de la tuile au format 'z_x_y'.
x int Coordonnée x de la tuile.
y int Coordonnée y de la tuile.
z int Coordonnée z de la tuile.
style cstring Chaîne JSON contrôlant le rendu du fichier PNG. Si vous ne spécifiez pas ce paramètre, le style par défaut est appliqué.

Champs de style

Champ Type Valeur par défaut Description
background string #FFFFFFFF Couleur d'arrière-plan au format RGBA. La valeur par défaut est le blanc.
line_color string #000000FF Couleur des points et des contours au format RGBA. La valeur par défaut est le noir.
fill_color string #F4A460FF Couleur de remplissage de la tuile au format RGBA. La valeur par défaut est le marron.
line_width int 1 Largeur de ligne en pixels.
point_size int 10 Diamètre des points en pixels. Chaque point est un cercle de 10 pixels de diamètre.
parallel_unit int 50000 Nombre d'éléments traités par chaque tâche de rendu parallèle.

Exemple de code JSON pour le style :

{
  "background": "#FFFFFFFF",
  "line_color": "#000000FF",
  "fill_color": "#F4A460FF",
  "line_width": 1,
  "point_size": 10
}

Remarques sur l'utilisation

  • Une tuile se compose de plusieurs fragments. L'identifiant de la tuile (key) utilise le format 'z_x_y' et doit être valide dans le système de coordonnées EPSG:4326 ou EPSG:3857.

  • Pour le système EPSG:4326, le nombre de fragments sur l'axe x est le double de celui sur l'axe y, et la coordonnée z commence à 1. Pour z=1, les seuls identifiants de tuiles valides sont 1_0_0 et 1_1_0.

  • Les dimensions de l'image PNG générée correspondent à la valeur tileSize définie lors de la création de la pyramide avec la fonction ST_BuildPyramid.

Exemples

Les deux exemples ci-dessous génèrent la même tuile (z=3, x=1, y=6) de la pyramide roads en utilisant le style par défaut.

-- Render a tile using the tile ID string
SELECT ST_AsPng('roads', '3_1_6', '');
-- Render the same tile using explicit x, y, z coordinates
SELECT ST_AsPng('roads', 1, 6, 3, '');

Dans les deux cas, l'image PNG est renvoyée sous forme de valeur bytea :

0xFFAABB8D8A6678...