Geohash はジオコードシステムの一種で、地球表面をグリッド状の区画に分割し、各セルを文字と数字からなる短い文字列としてエンコードします。階層的なデータ構造になっているため、geohash 文字列が長いほど、地理的位置をより高い精度で表せます。
地理座標を geohash 文字列に手動で変換する必要がある場合は、geohash.org を利用できます。
緯度と経度を geohash 文字列にエンコードします。
構文
geohashEncode(longitude, latitude, [precision])
longitude — エンコードする座標の経度。[-180°, 180°] の範囲の浮動小数点数です。Float。latitude — エンコードする座標の緯度。[-90°, 90°] の範囲の浮動小数点数です。Float。precision (任意) — 生成されるエンコード文字列の長さ。デフォルト値は 12 です。[1, 12] の範囲の整数です。Int8。
- すべての座標パラメーターは同じ型である必要があります。
Float32 または Float64 のいずれかを使用してください。
precision パラメーターでは、1 未満または 12 を超える値は暗黙的に 12 に変換されます。
- エンコードされた座標を表す英数字の文字列 (base32 エンコーディングのアルファベットを修正したものを使用) 。String。
例
SELECT geohashEncode(-5.60302734375, 42.593994140625, 0) AS res;
┌─res──────────┐
│ ezs42d000000 │
└──────────────┘
hash_str — Geohash エンコードされた文字列。
戻り値
- 経度と緯度を表す
Float64 型の値からなる Tuple (longitude, latitude)。Tuple(Float64)
例
SELECT geohashDecode('ezs42') AS res;
┌─res─────────────────────────────┐
│ (-5.60302734375,42.60498046875) │
└─────────────────────────────────┘
geohashesInBox(longitude_min, latitude_min, longitude_max, latitude_max, precision)
longitude_min — 最小経度。範囲: [-180°, 180°]。Float。latitude_min — 最小緯度。範囲: [-90°, 90°]。Float。longitude_max — 最大経度。範囲: [-180°, 180°]。Float。latitude_max — 最大緯度。範囲: [-90°, 90°]。Float。precision — Geohash の精度。範囲: [1, 12]。UInt8。
すべての座標パラメータは、Float32 または Float64 のいずれか同じ型である必要があります。
- 指定した領域をカバーする Geohash ボックスを表す、長さが精度に等しい文字列の Array。要素の順序に依存しないでください。Array(String)。
[] - 最小の緯度または経度の値が、対応する最大値より小さくない場合は空の配列です。
結果の配列の長さが 10’000’000 項目を超える場合、この関数は例外をスローします。SELECT geohashesInBox(24.48, 40.56, 24.785, 40.81, 4) AS thasos;
┌─thasos──────────────────────────────────────┐
│ ['sx1q','sx1r','sx32','sx1w','sx1x','sx38'] │
└─────────────────────────────────────────────┘
