geometry-expression.ST_AsWKB([ format])

ST_AsWKB メソッドは、ジオメトリを WKB フォーマットで表すバイナリ文字列を返します。さまざまなフォーマットが (関連付けられているオプションとともに) サポートされており、オプションの format パラメータを使用して目的のフォーマットを選択します。format パラメータを指定しない場合、デフォルトは 'WKB' です。

フォーマット文字列では、出力フォーマットとそのフォーマットに対するパラメータを定義します。フォーマット文字列のフォーマットは次のいずれかです。

format-name

format-name(parameter1=value1;parameter2=value2;...)

parameter1=value1;parameter2=value2;...

最初のフォーマットでは、フォーマット名を指定し、パラメータは指定しません。すべてのフォーマットパラメータでデフォルト値が使用されます。2 番目のフォーマットでは、フォーマット名と名前付きパラメータ値のリストを指定します。指定しないパラメータでは、デフォルト値が使用されます。最後のフォーマットでは、パラメータ値のみを指定し、フォーマット名にはデフォルトの 'WKB' を使用します。

次のフォーマット名を使用できます。

次のフォーマットパラメータを指定できます。

次の例では、結果として 0x01b90b0000000000000000f03f000000000000004000000000000008400000000000001040 を返します。

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsWKB('endian=little')

次の例では、結果として 0x0101000000000000000000f03f0000000000000040 を返します。WKB の OGC 仕様のバージョン 1.1 では Z 値と M 値はサポートされていないため、これらの値は省略されます。

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsWKB('WKB(Version=1.1;endian=little)')

次の例では、結果として 0x01010000e0e6100000000000000000f03f000000000000004000000000000008400000000000001040 を返します。

SELECT NEW ST_Point( 1.0, 2.0, 3.0, 4.0, 4326 ).ST_AsWKB('EWKB(endian=little)')