geo_point_to_h3cell()
Platí pro: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Vypočítá hodnotu řetězce tokenu buňky H3 zeměpisného umístění.
Přečtěte si další informace o buňce H3.
Syntaxe
geo_point_to_h3cell(
zeměpisná délka,
,
[ rozlišení ])
Přečtěte si další informace o konvencích syntaxe.
Parametry
Název | Type | Požadováno | Popis |
---|---|---|---|
zeměpisná délka | real |
✔️ | Geoprostorová souřadnice, zeměpisná délka ve stupních. Platná hodnota je reálné číslo a v rozsahu [-180, +180]. |
zeměpisná šířka | real |
✔️ | Geoprostorová souřadnice, zeměpisná šířka ve stupních. Platná hodnota je reálné číslo a v rozsahu [-90, +90]. |
usnesení | int |
Definuje požadované rozlišení buněk. Podporované hodnoty jsou v rozsahu [0, 15]. Pokud není zadáno, použije se výchozí hodnota 6 . |
Návraty
Hodnota řetězce tokenu buňky H3 daného zeměpisného umístění. Pokud jsou souřadnice nebo úrovně neplatné, dotaz vytvoří prázdný výsledek.
Poznámka:
- Buňka H3 může být užitečným geoprostorovým clusteringovým nástrojem.
- Buňka H3 má 16 úrovní hierarchie s pokrytím oblastí v rozsahu od 4 250 547 km² na nejvyšší úrovni 0 až 0,9m² na nejnižší úrovni 15.
- Buňka H3 má jedinečný šestiúhelník a to vede k několika jedinečným vlastnostem:
- Šestiúhelníky mají 6 sousedů
- Hexagony nám umožňují snadno odhadnout poloměry a všichni sousedé jsou ekvividantní.
- Šestiúhelníky jsou vizuálně příjemné
- V některých výjimečných případech je tvar pětiúhelník.
- Buňka H3 má obdélníkovou oblast na povrchu roviny.
- Vyvolání funkce geo_h3cell_to_central_point() v řetězci tokenu buňky H3, který byl vypočítán podle délky x a zeměpisné šířky y, nemusí nutně vrátit x a y.
- Je možné, že dvě geografická umístění jsou velmi blízko sebe, ale mají různé tokeny buňky H3.
H3 Buňka přibližné pokrytí oblasti na hodnotu rozlišení
Level | Průměrná délka šestiúhelníku |
---|---|
0 | 1108 km |
0 | 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 |
Zdroj tabulky najdete v tomto statistickém zdroji buňky H3.
Viz také geo_point_to_s2cell() geo_point_to_geohash().
Porovnání s jinými dostupnými systémy mřížky. viz geoprostorové shlukování s dotazovací jazyk Kusto.
Příklady
print h3cell = geo_point_to_h3cell(-74.04450446039874, 40.689250859314974, 6)
Výstup
h3cell |
---|
862a1072fff |
Následující příklad najde skupiny souřadnic. Každá dvojice souřadnic ve skupině se nachází v buňce H3 s průměrnou šestiúhelníkovou oblastí 253 km².
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
Výstup
h3cell | count | umístění |
---|---|---|
852a100bfffffff | 2 | [ "A", "B" ] |
852a1073fff | 0 | [ "C" ] |
Následující příklad vytvoří prázdný výsledek z důvodu neplatného vstupu souřadnic.
print h3cell = geo_point_to_h3cell(300,1,8)
Výstup
h3cell |
---|
Následující příklad vytvoří prázdný výsledek z důvodu neplatného vstupu na úrovni.
print h3cell = geo_point_to_h3cell(1,1,16)
Výstup
h3cell |
---|
Následující příklad vytvoří prázdný výsledek z důvodu neplatného vstupu na úrovni.
print h3cell = geo_point_to_h3cell(1,1,int(null))
Výstup
h3cell |
---|