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)')