geo_point_to_h3cell()
適用対象: ✅Microsoft Fabric✅Azure データ エクスプローラー✅Azure Monitor✅Microsoft Sentinel
地理的な場所の H3 Cell トークン文字列値を計算します。
詳細については、H3 セルに関するページを参照してください。
構文
geo_point_to_h3cell(longitude, latitude, [ resolution ])
構文規則について詳しく知る。
パラメーター
| 件名 | タイプ | Required | 説明 |
|---|---|---|---|
| longitude | real |
✔️ | 地理空間座標、経度値 (度)。 有効な値は実数で、[-180, +180] の範囲です。 |
| latitude | real |
✔️ | 地理空間座標、緯度の値 (度)。 有効な値は実数で、[-90, +90] の範囲です。 |
| 解決 | int |
要求されたセル解決を定義します。 サポートされる値の範囲は [0, 15] です。 指定されない場合は、既定値の 6 が使用されます。 |
返品
特定の地理的な場所の H3 セル トークン文字列値。 座標またはレベルが無効な場合、クエリは空の結果を生成します。
Note
- H3 セルは、便利な地理空間クラスタリング ツールです。
- H3 セルには 16 のレベルから成る階層があります。対象範囲は、最高レベルであるレベル 0 の 4,250,547 km² から、最低レベルであるレベル 15 の 0.9 m² までです。
- H3 セルは、ユニークな六角形の形状です。これにより、いくつかのユニークな性質が生じます。
- 六角形には、6 つの近隣があります
- 六角形では、簡単に範囲を近似でき、すべての近隣が等距離になります
- 六角形は視覚的に快適です
- まれに、形状が五角形でなる場合があります。
- H3 セルは、平面上では四角形の領域です。
- 経度 x と緯度 y で計算された H3 Cell トークン文字列に対して geo_h3cell_to_central_point() 関数を呼び出しても、必ずしも x と y が返されるとは限りません。
- 2 つの地理的場所が互いに近接していても、H3 セル トークンは異なることがあります。
H3 Cell の解像度値ごとのおおよその対象範囲
| Level | 六角形の接線の平均の長さ |
|---|---|
| 0 | 1108 km |
| 1 | 419 km |
| 2 | 158 km |
| 3 | 60 km |
| 4 | 23 km |
| 5 | 8 km |
| 6 | 3 km |
| 7 | 1 km |
| 8 | 460 m |
| 9 | 174 m |
| 10 | 66 m |
| 11 | 25 m |
| 12 | 9 m |
| 13 | 3 m |
| 14 | 1 m |
| 15 | 0.5 m |
テーブル ソースは、この H3 セル統計リソースにあります。
geo_point_to_s2cell()、geo_point_to_geohash() も参照してください。
使用可能な他のグリッド システムとの比較については、 Kusto クエリ言語を使用した地理空間クラスタリングに関するページを参照してください。
例
print h3cell = geo_point_to_h3cell(-74.04450446039874, 40.689250859314974, 6)
出力
| h3cell |
|---|
| 862a1072fffffff |
次の例では、座標のグループを検索します。 グループ内の座標の各ペアは、平均六角形領域が 253 km² の H3 セル内に存在します。
datatable(location_id:string, longitude:real, latitude:real)
[
"A", -73.956683, 40.807907,
"B", -73.916869, 40.818314,
"C", -73.989148, 40.743273,
]
| summarize count = count(), // Items per group count
locations = make_list(location_id) // Items in the group
by h3cell = geo_point_to_h3cell(longitude, latitude, 5) // H3 Cell of the group
出力
| h3cell | count | 場所 |
|---|---|---|
| 852a100bfffffff | 2 | [ "A", "B" ] |
| 852a1073fffffff | 1 | [ "C" ] |
次の例では、座標入力が無効であるため、空の結果が生成されます。
print h3cell = geo_point_to_h3cell(300,1,8)
出力
| h3cell |
|---|
次の例では、レベルの入力が無効であるため、空の結果が生成されます。
print h3cell = geo_point_to_h3cell(1,1,16)
出力
| h3cell |
|---|
次の例では、レベルの入力が無効であるため、空の結果が生成されます。
print h3cell = geo_point_to_h3cell(1,1,int(null))
出力
| h3cell |
|---|