Functions for Working with Geohash
Geohash
Geohash は、地球の表面をグリッド状のバケットに細分化し、各セルを短い文字列の組み合わせにエンコードするジオコードシステムです。これは階層的データ構造であり、geohash文字列が長くなるほど、地理的な位置の精度が高くなります。
手動で地理座標をgeohash文字列に変換する必要がある場合は、geohash.org を使用できます。
geohashEncode
緯度と経度を geohash 文字列としてエンコードします。
構文
入力値
longitude
— エンコードしたい座標の経度部分。範囲は[-180°, 180°]
の浮動小数点数です。Float。latitude
— エンコードしたい座標の緯度部分。範囲は[-90°, 90°]
の浮動小数点数です。Float。precision
(オプション) — 結果のエンコードされた文字列の長さ。初期値は12
です。範囲は[1, 12]
の整数です。Int8。
注記
- すべての座標パラメータは同じタイプでなければなりません:
Float32
またはFloat64
。 precision
パラメータには、1
未満または12
を超える値は静かに12
に変換されます。
返される値
- エンコードされた座標の英数字文字列(修正されたbase32エンコーディングアルファベットが使用されます)。String。
例
クエリ:
結果:
geohashDecode
任意の geohash エンコードされた文字列を解読し、経度と緯度を返します。
構文
入力値
hash_str
— Geohashエンコードされた文字列。
返される値
例
geohashesInBox
指定された精度で、与えられたボックスの境界内にあるおよび交差する geohash エンコードされた文字列の配列を返します。基本的には2Dグリッドを配列にフラット化したものです。
構文
引数
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
。
返される値
- 提供されたエリアをカバーする精度の長い文字列の配列で、アイテムの順序に依存しないことをお勧めします。Array(String)。
- 最小の緯度と経度の値が対応する最大値より小さくない場合、
[]
- 空の配列。
注記
結果の配列の項目数が10'000'000を超える場合、関数は例外をスローします。
例
クエリ:
結果: