このトピックでは、ST_PointFromText関数について説明します。 この関数は、Well-Known Text (WKT) 文字列と空間参照識別子 (SRID) を使用してポイントオブジェクトを作成します。
構文
geometry ST_PointFromText(text wKT);
geometry ST_PointFromText(text wKT , integer srid);パラメーター
パラメーター | 説明 |
wKT | 指定するWKT文字列。 |
srid | ポイントオブジェクトのSRID。 |
説明
SRIDを指定しない場合、デフォルトのSRID 0が使用されます。
指定したWKT文字列がポイントを表していない場合、この関数はNULLを返します。
指定したWKT文字列が無効な場合、この関数はエラーを返します。
指定した情報を使用してポイントオブジェクトを構築できることを確認できる場合は、ST_GeomFromText関数を使用することをお勧めします。これにより、不要なチェックが不要になるため、ジオメトリオブジェクトをより高速に構築できます。
緯度と経度の座標を使用して点オブジェクトを構築する場合、Open Geospatial Consortium (OGC) 仕様との互換性よりもパフォーマンスと精度に関心がある場合は、ST_MakePoint関数またはST_Point関数を使用することをお勧めします。
例
SELECT ST_AsEWKT(ST_PointFromText('POINT(119 40)', 4326));
SELECT ST_AsEWKT(ST_PointFromText('POINT(119 40)', 4326));
st_asewkt
-------------------------
SRID=4326;POINT(119 40)
(1 row)