名前

ST_LinestringFromWKB — LINESTRING を WKB 表現から生成し、SRID を与えた場合にはそれを付けます。

概要

geometry ST_LinestringFromWKB(bytea WKB);

geometry ST_LinestringFromWKB(bytea WKB, integer srid);

説明

ST_LinestringFromWKB 関数はジオメトリーの Well-Known Binary (WKB) と任意引数の空間参照系 ID (SRID) とを取って、LINESTRING ジオメトリーを生成します。ST_LineFromWKB の別名です。

SRID が指定されていない場合には、デフォルトの 0 になります。入力 byteaLINESTRING ジオメトリーを表現していない場合には、NULL が返されます。

[注記]

OGC SPEC 3.2.6.2 - 任意引数SRIDは仕様適合のためです。

[注記]

全てのジオメトリーが LINESTRING であることが分かっている場合には、ST_GeomFromWKB を直接使う方が効率的です。ST_GeomFromWKBLINESTRING かどうかの追加の評価を行うためです。

このメソッドはOGC Simple Features Implementation Specification for SQL 1.1の実装です。 s3.2.6.2

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

Code
SELECT ST_LinestringFromWKB(
    ST_AsBinary(ST_GeomFromText('LINESTRING(1 2,3 4)'))
) AS aline,
ST_LinestringFromWKB(
    ST_AsBinary(ST_GeomFromText('POINT(1 2)'))
) IS NULL AS null_return;
出力:
aline                 | null_return
------------------------------------
LINESTRING(1 2,3 4)  | t
Figure
Geometry figure for visual-st-linestringfromwkb-01