geo_punkt_zu_h3_zelle()

Gilt für: ✅Microsoft Fabric

Berechnet den H3 Cell-Tokenzeichenfolgenwert eines geografischen Standorts.

Weitere Informationen zu H3 Cell.

Syntax

geo_point_to_h3cell( Längengrad,, [ Auflösung ])

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name	Typ	Erforderlich	Beschreibung
Länge	real	✔️	Geospatialkoordinate, Längengradwert in Grad. Der gültige Wert ist eine reelle Zahl und im Bereich [-180, +180].
Breite	real	✔️	Geospatialkoordinate, Breitenwert in Grad. Der gültige Wert ist eine reelle Zahl und im Bereich [-90, +90].
Auflösung	int		Definiert die angeforderte Zellenauflösung. Unterstützte Werte befinden sich 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 Geospatialclustering-Tool sein.
• H3 Cell verfügt über 16 Hierarchieebenen mit Flächenabdeckung von 4.250.547km² 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:
• Sechsecks haben 6 Nachbarn
• Sechsecks ermöglichen es uns, einen ungefähren Radius leicht anzunähern, und alle Nachbarn sind gleichförmiger
• Sechsecks sind optisch angenehm
• In einigen seltenen Fällen ist die Form fünfeckig.
• H3 Cell hat einen rechteckigen Bereich auf einer Ebenenoberfläche.
• Wenn Sie die funktion geo_h3cell_to_central_point() für eine H3 Cell-Tokenzeichenfolge aufrufen, die für längengrad x und breiten y berechnet wurde, wird nicht unbedingt x und y zurückgegeben.
• Es ist möglich, dass sich zwei geografische Standorte sehr nahe beieinander befinden, aber unterschiedliche H3 Cell-Token haben.

H3 Cell ungefähre Flächenabdeckung pro Auflösungswert

Ebene	Durchschnittliche Sechseck-Kantenlänge
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 statistischen Ressource H3 Cell.

Siehe auch geo_point_to_s2cell(), geo_point_to_geohash().

Vergleich mit anderen verfügbaren Rastersystemen. siehe Geospatialclustering mit Kusto-Abfragesprache.

Beispiele

Im folgenden Beispiel wird der H3 Cell-Tokenzeichenfolgenwert eines geografischen Standorts berechnet.

Abfrage ausführen

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

Ausgabe

h3cell
862a1072fffffff

Im folgenden Beispiel werden Gruppen von Koordinaten gefunden. Jedes Koordinatenpaar in der Gruppe befindet sich in der H3 Cell mit durchschnittlicher 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	zählen	Orte
852a100bfffff	2	[ "A", „B“ ]
852a1073fffffff	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 ungültigen Eingabeebene ein leeres Ergebnis erzeugt.

Abfrage ausführen

print h3cell = geo_point_to_h3cell(1,1,16)

Ausgabe

h3cell

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

Abfrage ausführen

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

Ausgabe

h3cell