ST_AsXML-Methode

geometry-expression.ST_AsXML([ format])

Name	Typ	Beschreibung
format	VARCHAR(128)	Eine Zeichenfolge, die das Ausgabetextformat für die Konvertierung des geometry-expression in eine XML-Darstellung definiert. Wenn dieser Parameter nicht festgelegt ist, wird die st_geometry_asxml_format-Option verwendet, um die XML-Darstellung auszuwählen. Siehe st_geometry_asxml_format-Option.

LONG VARCHAR Gibt die XML-Darstellung des geometry-expression zurück.

Die ST_AsXML-Methode gibt eine XML-Zeichenfolge für die Geometrie zurück. GML, KML und SVG sind die unterstützten XML-Formate. Der format-Parameter legt Parameter für die Steuerung der Konvertierung in XML fest. Wenn format nicht angegeben ist, wird der Wert der st_geometry_asxml_format-Option verwendet, um das Ausgabeformat auszuwählen. Siehe st_geometry_asxml_format-Option.

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 Parameterwerten fest. Nicht angegebene Parameter verwenden die Standardwerte. Das letzte Format gibt nur Parameterwerte an, der Formatname verwendet den Standardnamen 'GML'.

Die folgenden Formatnamen können benutzt werden:

GML Das "Geography Markup Language"-Format gemäß der Definition in ISO 19136 und OGC.
KML Das Keyhole Markup Language-Format gemäß Definition von OGC.
SVG Das Scalable Vector Graphics (SVG) 1.1-Format gemäß der Definition des World Wide Web Consortium (W3C).

Die folgenden format-Parameter können angegeben werden:

Formatname	Parametername	Standardwert	Zulässige Werte	Beschreibung
GML	Version	3	2 Version 2 der GML-Spezifikation. 3 Version 3.2 der GML-Spezifikation	Der version-Parameter steuert die Version der benutzten GML-Spezifikation.
GML	Namespace	none	local Stellt ein Standard-Namespace-Attribut für das angegebene Element (in diesem Fall Point) und seine untergeordneten Elemente bereit. global Stellt ein dediziertes Präfix ("gml") 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 "gml"-Präfix. none Stellt keinen Namespace oder kein Präfix für das angegebene Element (in diesem Fall Point) und seine untergeordneten Elemente bereit.	Der namespace-Parameter legt die Ausgabeformat-Konvention für Namespace fest.
GML	SRSNameFormat	short	short Verwendet ein kurzes Format für das räumliche Bezugssystem, zum Beispiel EPSG:4326 long Benutzt ein langes Format für den Namen des räumlichen Bezugssystems, zum Beispiel urn:x-ogc:def:crs:EPSG:4326. none Das Namensattribut für das räumliche Bezugssystem wird für die Geometrie nicht angegeben.	Der SRSNameFormat-Parameter legt das Format für das srsName-Attribut fest.
GML	SRSDimension	No	Yes oder No	Der SRSDimension-Parameter legt die Anzahl der Koordinatenwerte für die angegebene Geometrie fest. Dies gilt nur für GML(version=3).
GML	SRSFillAll	No	Yes oder No	Der SRSFillAll-Parameter gibt an, ob SRS-Attribute an untergeordnete Geometrieelemente weitergereicht werden sollen oder nicht. Beispiel: MultiGeometry oder MultiPolygon würde die Attribute an die untergeordneten Geometrien weitergeben.
GML	UseDeprecated	No	Yes oder No	Der UseDeprecated-Parameter gilt nur für GML(version=3). Er wird gegebenenfalls für die Ausgabe von älteren GML-Darstellungen verwendet. Beispiel: Eine Ebene (Surface-Element) kann als Polygon ausgegeben werden, wenn die Geometrie keine CircularStrings enthält.
GML	Attribute	Automatisch generierte optionale Attribute	Ein oder mehrere Attribute können nur für das Geometrieelement der obersten Ebene angegeben werden.	Alle zulässigen XML-Attribute können angegeben werden.
GML	SubElement	Automatisch generierte untergeordnete GML-Elemente	Ein oder mehrere untergeordnete Attribute können nur für das Geometrieelement der obersten Ebene angegeben werden.	Alle zulässigen XML-Elemente können angegeben werden.
KML	Version	2	2	KML Version 2.2 wird unterstützt.
KML	Attribute	Automatisch generierte optionale Attribute	Ein oder mehrere Attribute können nur für das Geometrieelement der obersten Ebene angegeben werden.	Alle zulässigen XML-Attribute können angegeben werden.
KML	Namespace	none	local Stellt das Standard Namespace-Attribut http://www.opengis.net/kml/2.2 für das angegebene Geometrieelement (in diesem Fall Point) und seine untergeordneten Elemente bereit. global 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. none Stellt keinen Namespace oder kein Präfix für das angegebene Element (in diesem Fall Point) und seine untergeordneten Elemente bereit.	Der namespace-Parameter legt die Ausgabeformat-Konvention für Namespace fest.
KML	SubElement	Automatisch generierte untergeordnete KML-Elemente	Ein oder mehrere untergeordnete Attribute können nur für das Geometrieelement der obersten Ebene angegeben werden.	Alle zulässigen XML-Elemente können angegeben werden. Beispiel: extrude, tessellate und altitudeMode-Elemente können angegeben werden.
SVG	Approximate	Yes	Yes oder No	Der Parameter "Approximate" gibt an, ob die Größe des ausgegebenen SVG-Dokuments mit einer geringfügigen Verringerung der sichtbaren Details reduziert werden soll oder nicht. Die SVG-Daten werden als Näherungswert ("Approximate") dargestellt, indem Punkte nicht einbezogen werden, die sich innerhalb der Linienbreite des letzten Punkts befinden. Bei Geometrien mit mehreren Megabyte kann dies zu Kompressionsraten von 80 % oder mehr führen.
SVG	Attribute	Automatisch generierte optionale Attribute	Ein oder mehr SVG-Attribute, die an SVG-Formelemente angewendet werden können	Standardmäßig werden optionale SVG-Formattribute wie "fill", "stroke" und "stroke-width" generiert. Wenn der Attribute-Parameter angegeben ist, werden keine optionalen SVG-Formattribute generiert und der Attribute-Wert wird stattdessen verwendet. Wird ignoriert, wenn PathDataOnly=Yes festgelegt ist. Die maximale Länge des Attribute-Werts beträgt etwa 1000 Byte.
SVG	DecimalDigits	Basierend auf der Anzahl von Dezimalstellen der Rastergröße für die Funktion "Am Raster ausrichten" des räumlichen Bezugssystems. Der maximale Standardwert ist 5 und der Mindestwert ist 0 MB.	integer	Der DecimalDigits-Parameter begrenzt die Anzahl der Ziffern hinter dem Dezimalzeichen für Koordinaten, die in der SVG-Ausgabe generiert werden. Eine negative Stellenanzahl zeigt an, dass die Gesamtstellenzahl der Koordinaten in die SVG-Ausgabe einbezogen werden soll.
SVG	PathDataOnly	No (ein vollständiges SVG-Dokument wird generiert)	Yes oder No	Der PathDataOnly-Parameter legt fest, ob nur die Daten für das SVG-Pfadelement generiert werden sollen. Das nachstehende PathDataOnly-Beispiel zeigt, wie PathDataOnly=Yes verwendet werden kann, um ein vollständiges SVG-Dokument zu erstellen, das angezeigt werden kann. Standardmäßig wird ein vollständiges SVG-Dokument generiert. Die von PathDataOnly=Yes zurückgegebenen Pfaddaten können verwendet werden, um flexiblere SVG-Dokumente zu erstellen, die andere Elemente enthalten, beispielsweise Text.
SVG	RandomFill	Yes	Yes oder No	Der RandomFill-Parameter gibt an, ob Polygone mit einer zufallsgenerierten Farbe gefüllt werden sollen. Die verwendete Farbensequenz hält sich nicht an eine bestimmte Reihenfolge und ändert sich in der Regel jedes Mal, wenn eine SVG-Ausgabe generiert wird. None legt fest, dass nur ein Umriss jedes Polygons ausgegeben wird. Der RandomFill-Parameter wird ignoriert, wenn der Attribute-oder PathDataOnly=Yes-Parameter angegeben ist.
SVG	Relative	Yes	Yes oder No	Der Relative-Parameter legt fest, ob Koordinaten im relativen Format (Offset) oder absoluten Format ausgegeben werden sollen. Relative Koordinatendaten sind in der Regel kompakter als absolute Koordinatendaten.

Hinweis

Beim Konvertieren eines Geometriewerts in XML verwendet der Server die ST_AsXML-Methode. Die st_geometry_asxml_format-Option definiert das Format für die Konvertierung. Siehe st_geometry_asxml_format-Option.

Hinweis

Standardmäßig verwendet ST_AsXML das Originalformat für eine Geometrie, wenn es verfügbar ist. Andernfalls wird das interne Format verwendet. Weitere Hinweise zu den internen Formaten und Originalformaten finden Sie unter STORAGE FORMAT-Klausel, CREATE SPATIAL REFERENCE SYSTEM-Anweisung.

SQL/MM (ISO/IEC 13249-3: 2006) Erweiterung des Herstellers

Wenn die st_geometry_asxml_format-Option als Standardwert 'GML' hat, gibt die folgende Anweisung das Ergebnis <Point srsName="EPSG:4326"><pos>1 2 3 4</pos></Point> zurück.

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

Wenn die st_geometry_asxml_format-Option als Standardwert 'GML' hat, gibt die folgende Anweisung das Ergebnis <Point srsName="EPSG:4326"><pos>1 2 3 4</pos></Point> zurück.

SELECT CAST( NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ) AS XML)

Das folgende Beispiel gibt den Wert <Point srsName="EPSG:4326"><coordinates>1,2</coordinates></Point> zurück.

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

Der folgende Code gibt ein vollständiges SVG-Dokument mit Polygonen zurück, die mit zufallsgenerierten Farben gefüllt sind.

SELECT NEW ST_Polygon( 'Polygon(( 0 0, 0 20, 60 10, 0 0 ))' )
		    .ST_AsXML( 'SVG' )

ST_AsXML-Methode

Syntax

Parameter

Rückgabe

Bemerkungen

Hinweis

Hinweis

Siehe auch

Standards und Kompatibilität

Beispiel