ジオメトリまたはジオグラフィ オブジェクトを表す Well-Known Binary (WKB) 文字列を返します。標準 WKB とは異なり、出力には空間参照識別子 (SRID) が含まれます。
構文
bytea ST_AsEWKB(geometry g1);
bytea ST_AsEWKB(geometry g1, text NDRorXDR);
bytea ST_AsEWKB(geography g1);
bytea ST_AsEWKB(geography g1, text NDRorXDR);パラメーター
| パラメーター | 説明 |
|---|---|
g1 | 変換するジオメトリまたはジオグラフィ オブジェクト。 |
NDRorXDR | 出力のバイトオーダー。有効な値: XDR (ビッグエンディアン)、NDR (リトルエンディアン)。デフォルト値: NDR。 |
注意事項
WKB仕様では、標準 WKB 出力に SRID は含まれません。SRID を埋め込むバイナリ表現が必要な場合は、
ST_AsEWKBを使用します。円弧文字列、曲線、多面体サーフェス、三角形、不規則三角形網 (TIN) サーフェス、および 3D オブジェクトをサポートします。
例
デフォルトのリトルエンディアン (NDR) バイトオーダーで EWKB を返します。
SELECT ST_AsEWKB(ST_GeomFromText('POLYGON((1 1,1 2,2 2,2 1,1 1))',4326));出力:
st_asewkb
---------------------------------------------------------------
\x0103000020e61000000100000005000000000000000000f03f000000000.
.000f03f000000000000f03f00000000000000400000000000000040000000.
.00000000400000000000000040000000000000f03f000000000000f03f000.
.000000000f03f
(1 row)ビッグエンディアン (XDR) バイトオーダーで EWKB を返します。
SELECT ST_AsEWKB(ST_GeomFromText('POLYGON((1 1,1 2,2 2,2 1,1 1))',4326),'XDR');出力:
st_asewkb
---------------------------------------------------------------
\x0020000003000010e600000001000000053ff00000000000003ff000000.
.00000003ff000000000000040000000000000004000000000000000400000.
.000000000040000000000000003ff00000000000003ff00000000000003ff.
.0000000000000
(1 row)