geo_point_to_h3cell()
Gilt für: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
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 | Type | Erforderlich | Beschreibung |
|---|---|---|---|
| longitude | real |
✔️ | Geospatialkoordinate, Längengradwert in Grad. Der gültige Wert ist eine reelle Zahl und im Bereich [-180, +180]. |
| latitude | 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
print h3cell = geo_point_to_h3cell(-74.04450446039874, 40.689250859314974, 6)
Output
| 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².
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
Output
| h3cell | count | locations |
|---|---|---|
| 852a100bfffff | 2 | [ "A", „B“ ] |
| 852a1073fffffff | 1 | [ „C“ ] |
Im folgenden Beispiel wird aufgrund der ungültigen Koordinateneingabe ein leeres Ergebnis erzeugt.
print h3cell = geo_point_to_h3cell(300,1,8)
Output
| h3cell |
|---|
Im folgenden Beispiel wird aufgrund der ungültigen Eingabeebene ein leeres Ergebnis erzeugt.
print h3cell = geo_point_to_h3cell(1,1,16)
Output
| h3cell |
|---|
Im folgenden Beispiel wird aufgrund der ungültigen Eingabeebene ein leeres Ergebnis erzeugt.
print h3cell = geo_point_to_h3cell(1,1,int(null))
Output
| h3cell |
|---|