geo_point_to_h3cell()

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

Spuštění dotazu

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².

Spuštění dotazu

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.

Spuštění dotazu

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.

Spuštění dotazu

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.

Spuštění dotazu

print h3cell = geo_point_to_h3cell(1,1,int(null))

Výstup

h3cell