geo_point_to_h3cell()

Vypočítá hodnotu řetězce tokenu buňky H3 geografického umístění.

Přečtěte si další informace o buňce H3.

Syntax

geo_point_to_h3cell(Délky,Šířky, [ rozlišení ])

Přečtěte si další informace o konvencích syntaxe.

Parametry

Název	Typ	Vyžadováno	Popis
Délky	real	✔️	Geoprostorová souřadnice, hodnota zeměpisné délky ve stupních. Platná hodnota je reálné číslo v rozsahu [-180, +180].
zeměpisná šířka	real	✔️	Geoprostorová souřadnice, hodnota zeměpisné šířky ve stupních. Platná hodnota je reálné číslo v rozsahu [-90, +90].
Rozlišení	int		Definuje požadované rozlišení buňky. Podporované hodnoty jsou v rozsahu [0, 15]. Pokud není zadán, 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

• H3 Cell může být užitečný geoprostorový clusteringový nástroj.
• H3 Cell má 16 úrovní hierarchie s pokrytím od 4,250,547 km² na nejvyšší úrovni 0 až 0,9m² na nejnižší úrovni 15.
• Buňka H3 má jedinečný tvar šestiúhelníku a to vede k několika jedinečným vlastnostem:
• Šestiúhelníky mají 6 sousedů
• Šestiúhelníky nám umožňují snadno aproximovat poloměry a všichni sousedé jsou ekvidatní.
• Šestiúhelníky jsou vizuálně příjemné
• V některých vzácný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() u řetězce tokenu buňky H3, který byl vypočítán na základě zeměpisné délky x a zeměpisné šířky y, nemusí nutně vrátit hodnoty x a y.
• Je možné, že dvě geografické lokality jsou velmi blízko sebe, ale mají různé tokeny buňky H3.

Přibližné pokrytí buňky H3 na hodnotu rozlišení

Level	Průměrná délka hrany v šestiúhelníku
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

Zdroj tabulky najdete v tomto statistickém zdroji buňky H3.

Viz také geo_point_to_s2cell(),geo_point_to_geohash().

Pro porovnání s jinými dostupnými systémy rozvodných sítí. viz geoprostorový clustering s dotazovací jazyk Kusto.

Příklady

Spuštění dotazu

print h3cell = geo_point_to_h3cell(-74.04450446039874, 40.689250859314974, 6)

Výstup

h3cell
862a1072fffffff

Následující příklad vyhledá skupiny souřadnic. Každý pár souřadnic ve skupině se nachází v buňce H3 s průměrnou oblastí šestiúhelníku 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" ]
852a1073fffffff	1	[ "C" ]

Následující příklad vytvoří prázdný výsledek kvůli neplatné souřadnici vstupu.

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 kvůli neplatnému vstupu úrovně.

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 kvůli neplatnému vstupu úrovně.

Spuštění dotazu

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

Výstup

h3cell