ST_Y

デスクリプション

有効なPOINTジオメトリのY座標を返します。地理空間コンテキストでは、Y座標は通常緯度に対応し、[-90.0, 90.0]の範囲（度単位）になります。

Sytax

ST_Y( <point>)

パラメータ

パラメータ	デスクリプション
<point>	Y座標を抽出する有効な2D POINT geometryです。Y値（緯度）は[-90.0, 90.0]の範囲内である必要があり、X値（経度）は[-180.0, 180.0]の範囲内である必要があります。

戻り値

入力されたPOINTのY座標をDOUBLE PRECISION FLOATとして返します。

有効なPOINT入力に対してY座標（緯度）を返します。 NULL入力、空のポイント（POINT EMPTY）、3Dポイント、または無効なポイント（例：[-90.0, 90.0]の範囲外の緯度）に対してはNULLを返します。

Examples

Valid Point

SELECT ST_Y(ST_Point(24.7, 56.7));

+----------------------------+
| ST_Y(ST_Point(24.7, 56.7)) |
+----------------------------+
| 56.7                       |
+----------------------------+

空ポイント (POINT EMPTY)

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

3D Point（サポート対象外）

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

NULL入力

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

無効な緯度（範囲外）

mysql> SELECT ST_Y(ST_Point(116.4, 91));
+---------------------------+
| ST_Y(ST_Point(116.4, 91)) |
+---------------------------+
|                      NULL |
+---------------------------+

無効な経度（範囲外）

mysql> SELECT ST_Y(ST_Point(190, 39.9));
+---------------------------+
| ST_Y(ST_Point(190, 39.9)) |
+---------------------------+
|                      NULL |
+---------------------------+