geo_point_to_h3cell()

Berechnet den Wert der H3 Cell-Tokenzeichenfolge eines geografischen Standorts.

Weitere Informationen finden Sie unter H3 Cell.

Syntax

geo_point_to_h3cell(Länge,Breitengrad, [ Lösung ])

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name	Typ	Erforderlich	BESCHREIBUNG
longitude	real	✔️	Geokoordinate, Längengradwert in Grad. Gültiger Wert ist eine reelle Zahl und im Bereich [-180, +180].
latitude	real	✔️	Geokoordinate, Breitengradwert in Grad. Gültiger Wert ist eine reelle Zahl und im Bereich [-90, +90].
Auflösung	int		Definiert die angeforderte Zellauflösung. Unterstützte Werte liegen im Bereich [0, 15]. Wenn nichts angegeben wird, wird der Standardwert 6 verwendet.

Gibt zurück

Der H3 Cell-Tokenzeichenfolgenwert eines bestimmten geografischen Standorts. Wenn die Koordinaten oder Ebenen ungültig sind, erzeugt die Abfrage ein leeres Ergebnis.

Hinweis

• H3 Cell kann ein nützliches Geoclustering-Tool sein.
• H3 Cell verfügt über 16 Hierarchieebenen mit flächendeckenden Flächen von 4.250.547 km² auf der höchsten Ebene 0 bis 0,9m² auf der niedrigsten Ebene 15.
• H3 Cell hat eine einzigartige Sechseckform und dies führt zu einigen einzigartigen Eigenschaften:
• Sechsecke haben 6 Nachbarn
• Hexagone ermöglichen es uns, Radius leicht anzunähern, und alle Nachbarn sind gleichförmige
• Hexagone sind optisch angenehm
• In einigen seltenen Fällen ist die Form fünfeckig.
• H3 Cell hat einen rechteckigen Bereich auf einer ebenen Oberfläche.
• Das Aufrufen der geo_h3cell_to_central_point() -Funktion für eine H3 Cell-Tokenzeichenfolge, die für längengrad x und breitengrad y berechnet wurde, gibt nicht unbedingt x und y zurück.
• Es ist möglich, dass zwei geografische Standorte sehr nahe beieinander liegen, aber über unterschiedliche H3 Cell-Token verfügen.

Ungefähre Flächenabdeckung der H3-Zelle pro Auflösungswert

Ebene	Durchschnittliche Länge von Sechseckkanten
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

Die Tabellenquelle finden Sie in dieser H3 Cell-Statistikressource.

Siehe auch geo_point_to_s2cell(), geo_point_to_geohash().

Zum Vergleich mit anderen verfügbaren Netzsystemen. Siehe Räumliches Clustering mit Kusto-Abfragesprache.

Beispiele

Abfrage ausführen

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

Ausgabe

h3cell
862a1072fffff

Im folgenden Beispiel werden Koordinatengruppen ermittelt. Jedes Koordinatenpaar in der Gruppe befindet sich in der H3-Zelle mit einer durchschnittlichen Sechseckfläche von 253 km².

Abfrage ausführen

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

Ausgabe

h3cell	count	locations
852a100bfffff	2	[ "A", „B“ ]
852a1073fffff	1	[ „C“ ]

Im folgenden Beispiel wird aufgrund der ungültigen Koordinateneingabe ein leeres Ergebnis erzeugt.

Abfrage ausführen

print h3cell = geo_point_to_h3cell(300,1,8)

Ausgabe

h3cell

Im folgenden Beispiel wird aufgrund der Eingabe der ungültigen Ebene ein leeres Ergebnis erzeugt.

Abfrage ausführen

print h3cell = geo_point_to_h3cell(1,1,16)

Ausgabe

h3cell

Im folgenden Beispiel wird aufgrund der Eingabe der ungültigen Ebene ein leeres Ergebnis erzeugt.

Abfrage ausführen

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

Ausgabe

h3cell