ST_AsBinary
Prev  7.9.2. Well-known-Binary (WKB) Repräsentation  Next

Name

ST_AsBinary — Rückgabe der OGC/ISO Well-Known Binary (WKB)-Darstellung der Geometrie/Geografie ohne SRID-Metadaten.

Synopsis

bytea ST_AsBinary(geometry g1);

bytea ST_AsBinary(geometry g1, text NDR_or_XDR);

bytea ST_AsBinary(geography g1);

bytea ST_AsBinary(geography g1, text NDR_or_XDR);

Beschreibung

Gibt die OGC/ISO Well-Known Binary (WKB) Darstellung der Geometrie zurück. Bei der ersten Funktionsvariante wird standardmäßig die Endian-Kodierung der Servermaschine verwendet. Die zweite Funktionsvariante nimmt ein Textargument entgegen, das die Endian-Kodierung angibt, entweder Little-Endian ('NDR') oder Big-Endian ('XDR').

Das WKB-Format ist nützlich, um Geometriedaten aus der Datenbank zu lesen und dabei die volle numerische Präzision beizubehalten. Dadurch wird die Präzisionsrundung vermieden, die bei Textformaten wie WKT auftreten kann.

Um die inverse Konvertierung von WKB in PostGIS-Geometrie durchzuführen, verwenden Sie ST_GeomFromWKB.

[Note]

Das OGC/ISO WKB-Format enthält keinen SRID. Um das EWKB-Format zu erhalten, das den SRID enthält, verwenden Sie ST_AsEWKB
[Note]

Das Standardverhalten in PostgreSQL 9.0 wurde geändert, um bytea in Hex-Kodierung auszugeben. Wenn Ihre GUI-Tools das alte Verhalten erfordern, dann setzen Sie SET bytea_output='escape' in Ihrer Datenbank.

Erweiterung: Mit 2.0.0 wurde die Unterstützung für polyedrische Oberflächen, Dreiecke und TIN eingeführt.

Erweiterung: 2.0.0 - Unterstützung für höherdimensionale Koordinatensysteme eingeführt.

Erweiterung: 2.0.0 Unterstützung zum Festlegen des Endian beim geographischen Datentyp eingeführt.

Verfügbarkeit: 1.5.0 Unterstützung von geograpischen Koordinaten.

Änderung: 2.0.0 - Eingabewerte für diese Funktion dürfen nicht "unknown" sein -- es muss sich um eine Geometrie handeln. Konstrukte, wie ST_AsBinary('POINT(1 2)'), sind nicht länger gültig und geben folgende Fehlermeldung aus: n st_asbinary(unknown) is not unique error. Dieser Code muss in ST_AsBinary('POINT(1 2)'::geometry); geändert werden. Falls dies nicht möglich ist, so installieren Sie bitte legacy.sql.

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.37

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

Diese Funktion unterstützt polyedrische Flächen.

Diese Funktion unterstützt Dreiecke und dreieckige unregelmäßige Netzoberflächen (TIN).

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

Beispiele

SELECT ST_AsBinary(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326));

                   st_asbinary
--------------------------------
\x01030000000100000005000000000000000000000000000000000000000000000000000000000000
000000f03f000000000000f03f000000000000f03f000000000000f03f0000000000000000000000
00000000000000000000000000

SELECT ST_AsBinary(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326), 'XDR');
                   st_asbinary
--------------------------------
\x000000000300000001000000050000000000000000000000000000000000000000000000003ff000
00000000003ff00000000000003ff00000000000003ff00000000000000000000000000000000000
00000000000000000000000000