Name

ST_AsKML — Renvoyer la géométrie sous forme d'élément KML.

Synopsis

text ST_AsKML(geometry geom, integer maxdecimaldigits=15, text nprefix=NULL);

text ST_AsKML(geography geog, integer maxdecimaldigits=15, text nprefix=NULL);

Description

Renvoie la géométrie sous la forme d'un élément KML (Keyhole Markup Language). Le nombre maximal de décimales par défaut est de 15, la valeur par défaut du namespace est sans préfixe.

[Warning]

L'utilisation du paramètre maxdecimaldigits peut rendre la géométrie de sortie invalide. Pour éviter cela, utilisez d'abord ST_ReducePrecision avec une taille de grille appropriée.

[Note]

Exige que PostGIS soit compilé avec le support Proj. Utilisez PostGIS_Full_Version pour confirmer que vous avez compilé le support Proj.

[Note]

Disponibilité : 1.2.2 - les variantes ultérieures qui incluent le paramétrage de la version sont disponibles dans la version 1.3.2

[Note]

Amélioré : 2.0.0 - Ajout d'un préfixe namespace, utilisation d'arguments par défaut et d'arguments nommés

[Note]

Modifié : 3.0.0 - Suppression de la signature de la variante "versioned"

[Note]

La sortie AsKML ne fonctionnera pas avec les géométries qui n'ont pas de SRID

Cette fonction prend en charge la 3D et ne supprime pas l'indice z.

Exemples

SELECT ST_AsKML(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326));

                st_askml
                --------
                <Polygon
><outerBoundaryIs
><LinearRing
><coordinates
>0,0 0,1 1,1 1,0 0,0</coordinates
></LinearRing
></outerBoundaryIs
></Polygon>

                --3d linestring
                SELECT ST_AsKML('SRID=4326;LINESTRING(1 2 3, 4 5 6)');
                <LineString
><coordinates
>1,2,3 4,5,6</coordinates
></LineString>


Voir aussi

ST_AsSVG, ST_AsGML