Name

ST_AsKML — Gibt die Geometrie als GML-Element - Version 2 oder 3 - zurück.

Übersicht

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

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

Beschreibung

Gibt die Geometrie als ein Keyhole Markup Language (KML) Element zurück. Diese Funktion verfügt über mehrere Varianten. Die maximale Anzahl der Dezimalstellen die bei der Ausgabe verwendet wird (standardmäßig 15), die Version ist standardmäßig 2 und der Standardnamensraum hat kein Präfix.

[Warnung]

Die Verwendung des Parameters maxdecimaldigits kann dazu führen, dass die Ausgabegeometrie ungültig wird. Um dies zu vermeiden, verwenden Sie zuerst ST_ReducePrecision mit einer geeigneten Rastergröße.

Verfügbarkeit: 1.2.2 - spätere Varianten ab 1.3.2 nehmen den Versionsparameter mit auf

Erweiterung: 2.0.0 - Präfix Namensraum hinzugefügt. Standardmäßig kein Präfix

Geändert: 3.0.0 - Die Signatur der "versionierten" Variante wurde entfernt.

[Anmerkung]

Setzt voraus, dass PostGIS mit Proj-Unterstützung kompiliert wurde. Verwenden Sie bitte PostGIS_Full_Version, um festzustellen ob mit proj kompiliert wurde.

[Anmerkung]

Die Ausgabe AsKML funktioniert nicht bei Geometrien ohne SRID

Diese Funktion unterstützt 3d und lässt den Z-Index nicht fallen.

Beispiele

Code
SELECT ST_AsKML(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))', 4326));
Ausgabe von Rastern
<Polygon
><outerBoundaryIs
><LinearRing
><coordinates
>0,0 0,1 1,1 1,0 0,0</coordinates
></LinearRing
></outerBoundaryIs
></Polygon
>

This example outputs a 3D LineString.

Code
SELECT ST_AsKML('SRID=4326;LINESTRING(1 2 3,4 5 6)');
Ausgabe von Rastern
<LineString
><coordinates
>1,2,3 4,5,6</coordinates
></LineString
>

Siehe auch

ST_AsSVG, ST_AsGML