ST_X

説明

ポイントが有効なPOINT型の場合、対応するX座標値を返します。

構文

ST_X( <point>)

パラメータ

パラメータ	説明
<point>	X座標を抽出する幾何オブジェクト。有効な POINT 型（2D点）である必要があり、X（経度）の範囲は [-180, 180]、Y（緯度）の範囲は [-90, 90] です。

戻り値

幾何座標のX値で、倍精度浮動小数点数（Double）型です。

• 入力が有効な POINT オブジェクトの場合、点のX座標（倍精度浮動小数点数、Double）を返します。
• 入力が NULL、非 POINT 型オブジェクト、空の点（POINT EMPTY）、または無効な点（例：3D点）の場合、NULL を返します。

例

有効な点のX座標を抽出

SELECT ST_X(ST_Point(24.7, 56.7));

+----------------------------+
| st_x(st_point(24.7, 56.7)) |
+----------------------------+
|                       24.7 |
+----------------------------+

入力は空のポイント（POINT EMPTY）です

mysql> SELECT ST_X(ST_GeometryFromText("POINT EMPTY"));
+------------------------------------------+
| ST_X(ST_GeometryFromText("POINT EMPTY")) |
+------------------------------------------+
|                                     NULL |
+------------------------------------------+

入力は3Dポイントです（サポートされていません）

mysql> SELECT ST_X(ST_GeometryFromText("POINT (10 20 30)"));
+-----------------------------------------------+
| ST_X(ST_GeometryFromText("POINT (10 20 30)")) |
+-----------------------------------------------+
|                                          NULL |
+-----------------------------------------------+

入力がNULLです

mysql> SELECT ST_X(NULL);
+------------+
| ST_X(NULL) |
+------------+
|       NULL |
+------------+

経度が範囲外です

mysql> SELECT ST_X(ST_Point(244.7, 56.7));
+-----------------------------+
| ST_X(ST_Point(244.7, 56.7)) |
+-----------------------------+
|                        NULL |
+-----------------------------+

緯度が範囲外です

mysql> SELECT ST_X(ST_Point(44.7, 156.7));
+-----------------------------+
| ST_X(ST_Point(44.7, 156.7)) |
+-----------------------------+
|                        NULL |
+-----------------------------+