Tous les produits
Search
Centre de documentation

PolarDB:ST_AsMVTGeom3D

Dernière mise à jour :Sep 02, 2026

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_TileEnvelope pour 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