ジオメトリまたはジオグラフィオブジェクトの拡張 Well-Known Binary(EWKB)表現を返します。標準の Well-Known Binary(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 には SRID が含まれません。
ST_AsEWKBは、ターゲットシステムがバイナリ出力に埋め込まれた SRID メタデータを要求する場合に使用してください。サポートされるジオメトリタイプ:円弧文字列(circular strings)、曲線(curves)、多面体サーフェス(polyhedral surfaces)、三角形(triangles)、不規則三角網(TIN)サーフェス、および 3D オブジェクトです。
例
デフォルトのリトルエンディアンバイト順で 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 行)ビッグエンディアンバイト順で 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 行)