ST_AsText
Prev  7.9.1. Well-known-Text (WKT) Repräsentation  Next

Name

ST_AsText — Gibt die Well-known-Text(WKT) Darstellung der Geometrie/Geographie ohne die SRID Metadaten zurück.

Synopsis

text ST_AsText(geometry g1);

text ST_AsText(geometry g1, integer maxdecimaldigits = 15);

text ST_AsText(geography g1);

text ST_AsText(geography g1, integer maxdecimaldigits = 15);

Beschreibung

Liefert die OGC Well-Known Text (WKT) Darstellung der Geometrie/Geographie. Das optionale Argument maxdecimaldigits kann verwendet werden, um die Anzahl der Nachkommastellen in der Ausgabe von Ordinaten zu begrenzen (Standardwert: 15).

Um die umgekehrte Konvertierung der WKT-Darstellung in PostGIS-Geometrie durchzuführen, verwenden Sie ST_GeomFromText.

[Note]

Die standardmäßige OGC-WKT-Darstellung enthält den SRID nicht. Um den SRID als Teil der Ausgabedarstellung aufzunehmen, verwenden Sie die nicht standardisierte PostGIS-Funktion ST_AsEWKT
[Warning]

Bei der textuellen Darstellung von Zahlen in WKT wird möglicherweise nicht die volle Gleitkommagenauigkeit eingehalten. Um die volle Genauigkeit bei der Datenspeicherung oder beim Datentransport zu gewährleisten, ist es am besten, das Format Well-Known Binary (WKB) zu verwenden (siehe ST_AsBinary und maxdecimaldigits).
[Warning]

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.5 - Unterstützung von geograpischen Koordinaten.

Erweiterung: 2.5 - der optionale Parameter "precision" wurde eingeführt.

Diese Methode implementiert die OGC Simple Features Implementation Specification for SQL 1.1. s2.1.1.1

Diese Methode setzt die SQL/MM-Spezifikation um. SQL-MM 3: 5.1.25

Diese Methode unterstützt kreisförmige Strings und Kurven.

Beispiele

SELECT ST_AsText('01030000000100000005000000000000000000
000000000000000000000000000000000000000000000000
F03F000000000000F03F000000000000F03F000000000000F03
F000000000000000000000000000000000000000000000000');

    st_astext
--------------------------------
 POLYGON((0 0,0 1,1 1,1 0,0 0))

Die Standardeinstellung ist die Ausgabe mit voller Präzision.

SELECT ST_AsText('POINT(111.1111111 1.1111111)'));
    st_astext
------------------------------
 POINT(111.1111111 1.1111111)

Das Argument maxdecimaldigits kann verwendet werden, um die Ausgabegenauigkeit zu begrenzen.

SELECT ST_AsText('POINT(111.1111111 1.1111111)'), 2);
    st_astext
--------------------
 POINT(111.11 1.11)