ST_AsEWKB
戻る  7.9.2. Well-Known Binary (WKB)  次へ

名前

ST_AsEWKB — ジオメトリーの、SRID メタデータを持つ Extended Well-Known バイナリ (EWKB) 表現を返します。

概要

bytea ST_AsEWKB(geometry g1);

bytea ST_AsEWKB(geometry g1, text NDR_or_XDR);

説明

SRID メタデータを持つジオメトリーの Extended Well-Known Binary (EWKB) 表現を返します。一つ目の形式はサーバ機のエンディアンをデフォルトとしてバイナリを生成するものです。二つ目の形式は、エンディアンを指定する文字列引数を取ります。リトルエンディアンは 'NDR'、ビッグエンディアンは'XDR'です。それ以外の値を与えると、リトルエンディアンで出力します。

WKB 書式は、ジオメトリーデータをデータベースから、完全な数値精度を維持して読み取るために使われます。これにより、WKT 等のテキスト書式で発生する丸め誤差を回避できます。

EＷKB 表現を PostGIS ジオメトリーに逆変換するにはST_GeomFromEWKBを使います。

[注記]

OGC/ISO WKB 書式を得るにはST_AsBinaryを使います。OGC/ISO WKB 書式は SRID を持たないことに注意して下さい。

Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN 対応が導入されました。

この関数は3次元に対応し、Z値を削除しません。

このメソッドは曲線ストリングと曲線に対応しています。

この関数は多面体サーフェスに対応しています。

この関数は三角形と不規則三角網 (TIN) に対応しています。

例

コード
SELECT ST_AsEWKB(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))', 4326));
出力
\x0103000020e610000001000000050000000000000000000000000000000000000000000000000000
00000000000000f03f000000000000f03f000000000000f03f000000000000f03f00000000000000
0000000000000000000000000000000000
コード
SELECT ST_AsEWKB(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))', 4326), 'XDR');
出力
\x0020000003000010e600000001000000050000000000000000000000000000000000000000000000
003ff00000000000003ff00000000000003ff00000000000003ff000000000000000000000000000
0000000000000000000000000000000000