名前

ST_AsBinary — ジオメトリ/ジオグラフィのSRIDメタデータのないWell-Known Binary(WKB)表現を返します.

概要

bytea ST_AsBinary(geometry g1);

bytea ST_AsBinary(geography g1);

bytea ST_AsBinary(geometry g1, text NDR_or_XDR);

説明

ジオメトリのWell-Knwon Binary表現を返します.二つの形式があります.一つ目の形式では,エンディアンエンコーディングのパラメータを取らずにリトルエンディアンとします.二つ目の形式では,第二引数にリトルエンディアン('NDR')かビッグエンディアン('XDR')を使ってエンコーディングを明示します.

これは文字列表現に変換することなくデータベース外にデータを引っ張るバイナリカーソルに便利です.

[注意]

WKB仕様ではSRIDは入りません.SRIDを持つOGC WKBの書式を得るにはST_AsEWKBを使用します.

[注意]

ST_AsBinaryはジオメトリに対するST_GeomFromWKBの逆です.PostGISジオメトリをST_AsBinary表現から変換するにはST_GeomFromWKBを使います.

初出バージョン: 1.5.0 ジオグラフィサポートが導入されました.

このメソッドは OpenGIS Simple Features Implementation Specification for SQL 1.1.を実装するものです. s2.1.1.1

このメソッドはSQL/MM仕様の実装です. SQL-MM 3: 5.1.37

このメソッドは曲線ストリングと曲線をサポートします.

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

		   st_asbinary
--------------------------------
\001\003\000\000\000\001\000\000\000\005
\000\000\000\000\000\000\000\000\000\000
\000\000\000\000\000\000\000\000\000\000
\000\000\000\000\000\000\000\000\000\000
\000\000\000\360?\000\000\000\000\000\000
\360?\000\000\000\000\000\000\360?\000\000
\000\000\000\000\360?\000\000\000\000\000
\000\000\000\000\000\000\000\000\000\000\000
\000\000\000\000\000\000\000\000
(1 row)
SELECT ST_AsBinary(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326), 'XDR');
		   st_asbinary
--------------------------------
\000\000\000\000\003\000\000\000\001\000\000\000\005\000\000\000\000\000
\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000
\000?\360\000\000\000\000\000\000?\360\000\000\000\000\000\000?\360\000\000
\000\000\000\000?\360\000\000\000\000\000\000\000\000\000\000\000\000\000\000
\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000
(1 row)

関連情報

ST_AsEWKB, ST_AsEWKT, ST_AsText, ST_GeomFromEWKB