メインコンテンツまでスキップ
メインコンテンツまでスキップ

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エンコードされた文字列。

返される値

  • 経度と緯度の Float64 値のタプル (longitude, latitude)Tuple(Float64)

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を超える場合、関数は例外をスローします。

クエリ:

結果: