Transforme une géométrie 3D dans le système de coordonnées des tuiles requis par ST_AsMVT3D pour générer une sortie Mapbox Vector Tile (MVT). Cette fonction étend ST_AsMVTGeom en ajoutant la prise en charge de l'axe Z, ce qui permet de conserver les valeurs des coordonnées Z lors de la transformation.
Syntaxe
geometry ST_AsMVTGeom3D(
geometry geom,
box2d bounds,
integer extent = 4096,
integer buffer = 256,
boolean clip_geom = true
);
Paramètres
| Paramètre | Type | Description | Valeur par défaut | Valeurs valides |
|---|---|---|---|---|
geom |
geometry | Objet de géométrie 3D à transformer. | — | — |
bounds |
box2d | Limites rectangulaires de la tuile dans le système de référence de coordonnées (CRS) cible, hors zone tampon. Utilisez ST_TileEnvelope pour générer cette valeur. | — | — |
extent |
integer | Taille de la tuile dans l'espace de coordonnées des tuiles, telle que définie par la spécification MVT. | 4096 | 256–8192 |
buffer |
integer | Taille de la zone tampon dans l'espace de coordonnées des tuiles pour le découpage des géométries. | 256 | 1–4096 |
clip_geom |
boolean | Indique s'il faut découper la géométrie 3D selon les limites de la tuile. | true | — |
Description
ST_AsMVTGeom3D prépare la géométrie 3D pour une utilisation avec ST_AsMVT3D. Elle transforme les coordonnées de la géométrie dans l'espace de la tuile et découpe les géométries selon les limites de la tuile lorsque clip_geom est défini sur true.
Comportements clés :
Transforme les données de l'axe Z ainsi que les coordonnées X et Y, en préservant la géométrie 3D complète tout au long du processus de conversion.
Nécessite des limites de tuile dans le même CRS que la géométrie d'entrée afin que celle-ci puisse être correctement transformée et découpée. Utilisez
ST_TileEnvelopepour générer les limites.Ne prend pas en charge les objets polygones 3D contenant des anneaux intérieurs.
Exemples
Transformer une ligne brisée 3D dans l'espace de coordonnées des tuiles
L'exemple suivant transforme une ligne brisée 3D du SRID 4326 vers Web Mercator (SRID 3857) et la convertit dans l'espace de coordonnées des tuiles pour la tuile (1, 0, 0).
SELECT ST_AsText(
ST_AsMVTGeom3D(
ST_Transform('SRID=4326; LINESTRING(-10 -10 30, -10 -20 30)'::geometry, 3857),
ST_TileEnvelope(1, 0, 0)
)
) AS geom;
Sortie attendue :
geom
------------------------------------------------------------------------------------
MULTILINESTRING Z ((3868.44444444444 4324.7197219642 30,3868.44444444444 4352 30))
(1 row)
Générer une tuile MVT 3D à l'aide de ST_AsMVT3D
L'exemple ci-dessous présente une requête complète de génération de tuiles utilisant une expression de table commune (CTE). Il transforme les géométries d'une table dans l'espace de coordonnées des tuiles et les agrège au format binaire MVT pour la tuile (12, 513, 412).
WITH mvtgeom AS (
SELECT ST_AsMVTGeom3D(
ST_Transform(geom, 3857),
ST_TileEnvelope(12, 513, 412),
extent => 4096,
buffer => 256
) AS geom
FROM your_3d_table
WHERE geom && ST_Transform(ST_TileEnvelope(12, 513, 412), 4326)
)
SELECT ST_AsMVT3D(mvtgeom.*)
FROM mvtgeom;
Remplacez your_3d_table par le nom de votre table contenant les données de géométrie 3D.
Voir aussi
ST_AsMVT3D — agrège les géométries des tuiles au format binaire MVT
ST_AsMVTGeom — fonction PostGIS 2D étendue par cette fonction
ST_TileEnvelope — génère les boîtes englobantes des limites des tuiles