geometry-expression.ST_AsKML([ format])

Die ST_AsKML-Methode gibt eine KML Zeichenfolge zurück, die die Geometrie darstellt. Verschiedene Formate werden unterstützt (mit den dazugehörigen Optionen) und das gewünschte Format wird mit dem optionalen format-Parameter ausgewählt. Wenn der format-Parameter nicht angegeben wird, ist der Standardwert 'KML'.

Die Formatzeichenfolge definiert ein Ausgabeformat und Parameter für das Format. Die Formatzeichenfolge hat eines der folgenden Formate:

Formatname

Formatname(Parameter1=Wert1;Parameter2=Wert2;...)

Parameter1=Wert1;Parameter2=Wert2;...

Das erste Format legt den Formatnamen und keine Parameter fest. Alle Formatparameter benutzen ihre Standardwerte. Das zweite Format legt den Formatnamen und eine Liste von benannten Parameterwerten fest. Nicht angegebene Parameter verwenden die Standardwerte. Das letzte Format gibt nur Parameterwerte an, der Formatname verwendet den Standardnamen 'KML'.

Die folgenden Formatnamen können benutzt werden:

Die folgenden format-Parameter können angegeben werden:

Das folgende Beispiel gibt den Wert <Point><coordinates>1,2,3,4</coordinates></Point> zurück.

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsKML()

Das folgende Beispiel gibt den Wert <Point><coordinates>1,2,3,4</coordinates></Point> zurück.

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsKML('KML(Version=2)')

Die folgende Anweisung gibt die Ergebnismenge <kml:Point><kml:coordinates>1,2,3,4</kml:coordinates></kml:Point> zurück. Der Namespace=global-Parameter stellt ein dediziertes Präfix ("kml") für das angegebene Element und seine untergeordneten Elemente bereit. Dies ist sinnvoll, wenn die Abfrage innerhalb eines Aggregatvorgangs verwendet wird. Bestimmte Elemente der obersten Ebene definieren den Namespace für das "kml"-Präfix.

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AskML('KML(Version=2;Namespace=global)')

Die folgende Anweisung gibt die Ergebnismenge <Point><coordinates>1,2,3,4</coordinates></Point> zurück. In der Ausgabe sind keine Namespace-Informationen enthalten.

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsKML('KML(Version=2;Namespace=none)')

Die folgende Anweisung gibt die Ergebnismenge <Point xmlns="http://www.opengis.net/kml/2.2"><coordinates>1,2,3,4</coordinates></Point> zurück. Der xml-Standard-Namespace wird verwendet.

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsKML('KML(Version=2;Namespace=default)')

Die folgende Anweisung gibt die Ergebnismenge <Point><altitudeMode>absolute</altitudeMode><coordinates>1,2,3,4</coordinates></Point> zurück. Ein untergeordnetes AltitudeMode-Element wird in die Ausgabe einbezogen.

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsKML('SubElement=<altitudeMode>absolute</altitudeMode>')