ST_PointFromText で WKT 文字列からポイントオブジェクトを構築 - RDS - Alibaba Cloud - ApsaraDB RDS

Well-Known Text (WKT) 文字列とオプションの空間参照識別子 (SRID) からポイントを構築します。

構文

geometry ST_PointFromText(text wKT);
geometry ST_PointFromText(text wKT, integer srid);

パラメーター	型	説明
`wKT`	text	ポイントジオメトリを表す WKT 文字列。例：`POINT(119 40)`。
`srid`	integer	返されるジオメトリに割り当てる SRID。省略された場合は、`0` がデフォルト値となります。

WKT 文字列がポイントを表していない場合、関数は NULL を返します。
WKT 文字列が無効な場合、関数はエラーを返します。
座標の順序： WKT では、X が経度、Y が緯度を表します。たとえば、POINT(119 40) は経度 119、緯度 40 を意味します。順序を逆にすることは一般的な誤りであり、不正確なジオメトリを生成します。
2 つのオーバーロードは、返されるオブジェクトのメタデータが異なります。最初の形式は空間参照系が未定義のジオメトリ（SRID = 0）を返し、2 番目の形式は指定された SRID をジオメトリのメタデータに埋め込みます。

ST_PointFromText は、ポイントを構築する前に入力がポイントを表していることを検証します。入力がすでにポイント WKT であることが保証されている場合は、この検証ステップをスキップしてより高速に処理できる ST_GeomFromText を代わりに使用してください。

経度および緯度座標からポイントを構築し、Open Geospatial Consortium (OGC) コンプライアンスよりもパフォーマンスと精度を重視する場合は、ST_MakePoint または ST_Point を使用してください。

SRID 4326 (WGS 84) を持つポイントを構築する：

SELECT ST_AsEWKT(ST_PointFromText('POINT(119 40)', 4326));

出力：

        st_asewkt
-------------------------
 SRID=4326;POINT(119 40)
(1 row)

この例では、119 は経度 (X)、40 は緯度 (Y) です。