いずれかの引数が NULL の場合、戻り値は NULL です。

無効な引数がある場合は、エラーが発生します。

範囲外の経度または緯度を持つ引数がある場合、エラーが発生します:

表示される範囲は度数です。 浮動小数点演算のため、正確な範囲制限はわずかに偏差します。

いずれかの点引数に SRID 0 または 4326 がない場合は、ER_SRS_NOT_FOUND エラーが発生します。point 引数 SRID の有効性はチェックされません。

SRID 引数が未定義の空間参照システム (SRS) を参照している場合、ER_SRS_NOT_FOUND エラーが発生します。

SRID 引数が 32 ビット符号なし整数の範囲内にない場合は、ER_DATA_OUT_OF_RANGE エラーが発生します。

それ以外の場合、戻り値は NULL 以外です。

ST_GeoHash(longitude, latitude, max_length), ST_GeoHash(point, max_length)

接続文字セットおよび照合順序で geohash 文字列を戻します。

最初の構文では、longitude は[-180, 180]の範囲の数値である必要があり、latitude は[-90, 90]の範囲の数値である必要があります。 2 番目の構文では、POINT 値が必要です。X 座標と Y 座標は、それぞれ経度と緯度の有効範囲内にあります。

結果の文字列は max_length 文字以下で、上限は 100 です。 geohash 値を作成するアルゴリズムでは、場所または max_length 文字の正確な表現のいずれか (いずれか早い方) の文字列が作成されるまで続行されるため、文字列が max_length 文字より短い場合があります。

ST_GeoHash() は、このセクションの概要で説明されているように引数を処理します。

mysql> SELECT ST_GeoHash(180,0,10), ST_GeoHash(-180,-90,15);
+----------------------+-------------------------+
| ST_GeoHash(180,0,10) | ST_GeoHash(-180,-90,15) |
+----------------------+-------------------------+
| xbpbpbpbpb           | 000000000000000         |
+----------------------+-------------------------+

ST_LatFromGeoHash(geohash_str)

geohash 文字列値から緯度を範囲[−90, 90]の倍精度数値として返します。

ST_LatFromGeoHash() デコード関数は、geohash_str 引数から 433 文字以内を読み取ります。 座標値の内部表現における情報の上限を表します。 433rd を超える文字は、それ以外の場合でも無視され、エラーが発生します。

ST_LatFromGeoHash() は、このセクションの概要で説明されているように引数を処理します。

mysql> SELECT ST_LatFromGeoHash(ST_GeoHash(45,-20,10));
+------------------------------------------+
| ST_LatFromGeoHash(ST_GeoHash(45,-20,10)) |
+------------------------------------------+
|                                      -20 |
+------------------------------------------+

ST_LongFromGeoHash(geohash_str)

geohash 文字列値から経度を範囲[−180, 180]の倍精度数値として返します。

geohash_str 引数から処理される最大文字数に関する ST_LatFromGeoHash() の説明の注釈は、ST_LongFromGeoHash() にも適用されます。

ST_LongFromGeoHash() は、このセクションの概要で説明されているように引数を処理します。

mysql> SELECT ST_LongFromGeoHash(ST_GeoHash(45,-20,10));
+-------------------------------------------+
| ST_LongFromGeoHash(ST_GeoHash(45,-20,10)) |
+-------------------------------------------+
|                                        45 |
+-------------------------------------------+

ST_PointFromGeoHash(geohash_str, srid)

geohash 文字列値を指定して、デコードされた geohash 値を含む POINT 値を戻します。

点の X 座標と Y 座標は、それぞれ[−180, 180]の範囲の経度と[−90, 90]の範囲の緯度です。

srid 引数は 32 ビットの符号なし整数です。

geohash_str 引数から処理される最大文字数に関する ST_LatFromGeoHash() の説明の注釈は、ST_PointFromGeoHash() にも適用されます。

ST_PointFromGeoHash() は、このセクションの概要で説明されているように引数を処理します。

mysql> SET @gh = ST_GeoHash(45,-20,10);
mysql> SELECT ST_AsText(ST_PointFromGeoHash(@gh,0));
+---------------------------------------+
| ST_AsText(ST_PointFromGeoHash(@gh,0)) |
+---------------------------------------+
| POINT(45 -20)                         |
+---------------------------------------+