ST_AsText-Methode für den ST

geometry-expression.ST_AsText([ format])

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

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

Die ST_AsText-Methode gibt eine Textzeichenfolge zurück, die die Geometrie darstellt. Verschiedene Textformate werden (mit den zugeordneten Optionen) unterstützt und das gewünschte Format wird mit dem optionalen format-Parameter ausgewählt. Wenn der format-Parameter nicht angegeben ist, wird die Option st_geometry_astext_format zur Auswahl des Ausgabeformats verwendet. Siehe st_geometry_astext_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 'WKT'.

Die folgenden Formatnamen können benutzt werden:

WKT Das Well-Known-Textformat laut der Definition von SQL/MM und OGC.
EWKT Das Extended Well Known-Textformat. Dieses Format enthält die SRID der Geometrie als Präfix.
GML Das "Geography Markup Language"-Format gemäß der Definition in ISO 19136 und OGC.
KML Das Keyhole Markup Language-Format gemäß der OGC-Definition.
GeoJSON Das GeoJSON-Format verwendet JavaScript Object Notation (JSON) gemäß der Definition in http://geojson.org/geojson-spec.html.
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
WKT	version	1.2	1.1 Das WKT gemäß der OGC SFS 1.1-Definition. Dieses Format enthält keine Z- und M-Werte. Wenn die Geometrie Z- oder M-Werte enthält, werden sie in der Ausgabe entfernt. 1.2 Das WKT gemäß der OGC SFS 1.2-Definition. Dies passt zu Version 1.1 bei 2D-Daten und erweitert das Format zur Unterstützung von Z- und M-Werten. PostGIS Das WKT-Format in der von anderen Herstellern verwendeten Form. Z- und M-Werte sind in einer Weise enthalten, die nicht zum OGC 1.2 passt.	Der version-Parameter steuert die Version der benutzten WKT-Spezifikation.
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 angeben.	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.
GeoJSON	version	1	1	Die Version der GeoJSON-Spezifikation, die verwendet werden muss. Derzeit wird nur 1.0 unterstützt.
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.
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 VARCHAR oder NVARCHAR verwendet der Server die ST_AsText-Methode. Die st_geometry_astext_format-Option definiert das Format für die Konvertierung. Siehe st_geometry_astext_format-Option.

Hinweis

Standardmäßig verwendet ST_AsText 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) 5.1.35

Unter der Annahme, dass die st_geometry_astext_format-Option den Wert 'WKT' hat (siehe st_geometry_astext_format-Option), gibt der folgende Code das Ergebnis Point ZM (1 2 3 4) zurück.

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

Unter der Annahme, dass die st_geometry_astext_format-Option den Wert 'WKT' hat (siehe st_geometry_astext_format-Option), gibt der folgende Code das Ergebnis Point ZM (1 2 3 4) zurück. Die ST_AsText-Methode wird implizit aufgerufen, wenn Geometrien in VARCHAR oder NVARCHAR-Datentypen konvertiert werden.

SELECT CAST( NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ) as long varchar)

Die folgende Anweisung gibt die Ergebnismenge Point (1 2) zurück. Die Z- und M-Werte werden nicht ausgegeben, weil sie in Version 1.1.0 der OGC-Spezifikation für WKT nicht unterstützt werden.

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsText('WKT(Version=1.1)')

Die folgende Anweisung gibt die Ergebnismenge SRID=4326;Point ZM (1 2 3 4) zurück. Die SRID ist im Ergebnis als Präfix enthalten.

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsText('EWKT')

Das folgende Beispiel gibt den Wert <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_AsText('GML')

Der folgende Code gibt '{"type":"Point", "coordinates":[1,2]} ' zurück .

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsText('GeoJSON')

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_AsText( 'SVG' )

ST_AsText-Methode für den ST_Geometry-Datentyp

Syntax

Parameter

Rückgabe

Bemerkungen

Hinweis

Hinweis

Siehe auch

Standards und Kompatibilität

Beispiel