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éesEPSG:4326ouEPSG: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 sont1_0_0et1_1_0.Les dimensions de l'image PNG générée correspondent à la valeur
tileSizedé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...