名前

ST_PointFromText — WKTと与えられたSRIDからポイントジオメトリを生成します.SRIDが与えられていない場合は-1(不明)とします.

概要

geometry ST_PointFromText(text WKT);

geometry ST_PointFromText(text WKT, integer srid);

説明

OGC Well-Known Text表現からPostGISのST_Geometryポイントオブジェクトを生成します.SRIDが与えられていない場合は不明(現在は-1)とします.ジオメトリがWKTポイント表現でない場合はNULLを返します.完全に不正なWKTならエラーが投げられます.

[注意]

ST_PointFromTextには二つの形式があります. 一つ目はSRIDを取らずに空間参照系を定義していないジオメトリを返すものです. 二つ目は空間参照系IDを第二引数に取り,SRIDをメタデータの一部として含むST_Geometryを返すものです.SRIDはspatial_ref_sysテーブルで定義されていなければなりません.

[注意]

全てのWKTジオメトリがジオメトリコレクションであると絶対的な確信を持てる場合は,この関数は使わないでください.付加的な評価ステップが追加されるのでST_GeomFromTextより遅いです. 経度緯度座標からポイントを生成していて,OGC対応よりもパフォーマンスと精度を重視する場合は,ST_MakePointか,OGC対応の別名ST_Pointを使用して下さい.

このメソッドは OpenGIS Simple Features Implementation Specification for SQL 1.1.を実装するものです. s3.2.6.2 - option SRID is from the conformance suite.

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

SELECT ST_PointFromText('POINT(-71.064544 42.28787)');
SELECT ST_PointFromText('POINT(-71.064544 42.28787)', 4326);
	

関連情報

ST_GeomFromText, ST_MakePoint, ST_Point, ST_SRID