geo_point_to_h3cell()

地理的な場所の H3 セル トークン文字列値を計算します。

詳細については、「H3 セル」を参照してください。

構文

geo_point_to_h3cell(経度,緯度, [ resolution ])

構文規則について詳しく知る。

パラメーター

名前	型	必須	説明
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	locations
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