Sdílet prostřednictvím

geo_point_to_h3cell()

  • Článek

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