geo_point_to_h3cell()

適用於：✅Microsoft網狀架構✅Azure 數據✅總管 Azure 監視器✅Microsoft Sentinel

計算地理位置的 H3 儲存格標記字串值。

深入瞭解 H3 單元格。

語法

geo_point_to_h3cell(經度,緯度, [ 解析 ])

深入瞭解 語法慣例。

參數

姓名	類型​​	必要	描述
經度	real	✔️	地理空間座標，以度為單位的經度值。 有效值為實數，且範圍 [-180， +180]。
緯度	real	✔️	地理空間座標，以度為單位的緯度值。 有效值為實數，且範圍 [-90， +90]。
解析度	int		定義要求的數據格解析。 支援的值在 [0， 15] 範圍內。 如果未指定，則會使用預設值 6 。

傳回

指定地理位置的 H3 儲存格標記字串值。 如果座標或層級無效，查詢將會產生空的結果。

注意

• H3 儲存格可以是實用的地理空間叢集工具。
• H3 單元格有 16 層階層，面積覆蓋範圍從最高層級 0 到 0.9m2 的最高層級 15,250,547 公里不等。
• H3 單元格具有唯一的六邊形，這會導致一些獨特的屬性：
• 六邊形有6個鄰居
• 六邊形可讓我們輕鬆近似半徑，而且所有鄰居都是等價的
• 六邊形在視覺上令人愉快
• 在某些情況下，形狀是五角大樓。
• H3 儲存格在平面表面有矩形區域。
• 在以經度 x 和緯度 y 計算的 H3 單元格標記字串上叫用 geo_h3cell_to_central_point（） 函式，不一定會傳回 x 和 y。
• 兩個地理位置可能彼此非常接近，但有不同的 H3 單元格令牌。

H3 儲存格每個解析度值的近似區域涵蓋範圍

層級	平均六邊形邊緣長度
0	1108 公里
1	419 公里
2	158 公里
3	60 公里
4	23 公里
5	8 公里
6	3 公里
7	1 公里
8	460 米
9	174 公尺
10	66 米
11	25 米
12	9 米
13	3 米
14	1 公尺
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
862a1072fffff

下列範例會尋找座標群組。 群組中的每對座標都位於 H3 單元格中，平均六邊形區域為 253 公里的區域內。

執行查詢

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	計數	位置
852a100bfffffffff	2	[ “A”， "B" ]
852a1073fffffffff	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