geo_point_to_h3cell()
Si applica a: ✅Microsoft Fabric✅Azure Esplora dati✅ Azure Monitor✅Microsoft Sentinel
Calcola il valore della stringa del token di cella H3 di una posizione geografica.
Altre informazioni sulla cella H3.
Sintassi
geo_point_to_h3cell(longitudine, latitudine, [ risoluzione ])
Altre informazioni sulle convenzioni di sintassi.
Parametri
| Nome | Digita | Obbligatorio | Descrizione |
|---|---|---|---|
| longitude | real |
✔️ | Coordinata geospaziale, valore di longitudine in gradi. Il valore valido è un numero reale e nell'intervallo [-180, +180]. |
| latitude | real |
✔️ | Coordinata geospaziale, valore di latitudine in gradi. Il valore valido è un numero reale e nell'intervallo [-90, +90]. |
| risoluzione | int |
Definisce la risoluzione della cella richiesta. I valori supportati sono compresi nell'intervallo [0, 15]. Se non specificato, viene usato il valore predefinito 6. |
Valori restituiti
Valore della stringa del token della cella H3 di una determinata posizione geografica. Se le coordinate o i livelli non sono validi, la query genererà un risultato vuoto.
Nota
- La cella H3 può essere uno strumento di clustering geospaziale utile.
- H3 Cell ha 16 livelli di gerarchia con copertura dell'area che va da 4.250.547km² al livello più alto da 0 a 0,9m² al livello più basso 15.
- H3 Cell ha una forma esagonale unica e questo porta alcune proprietà uniche:
- Gli esagoni hanno 6 vicini
- Gli esagoni ci permettono di approssimare facilmente i raggi e tutti i vicini sono equidisti
- Gli esagoni sono visivamente piacevoli
- In alcuni rari casi la forma è il pentagono.
- La cella H3 ha un'area rettangolare su una superficie del piano.
- Richiamare la funzione geo_h3cell_to_central_point() in una stringa di token di cella H3 calcolata in base alla longitudine x e alla latitudine y non restituirà necessariamente x e y.
- È possibile che due posizioni geografiche siano molto vicine l'una all'altra, ma abbiano token di cella H3 diversi.
H3 Cella copertura approssimativa dell'area per valore di risoluzione
| Livello | Lunghezza media esagonale |
|---|---|
| 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 |
L'origine della tabella è disponibile in questa risorsa statistica della cella H3.
Vedere anche geo_point_to_s2cell(), geo_point_to_geohash().
Per il confronto con altri sistemi a griglia disponibili. vedere clustering geospaziale con Linguaggio di query Kusto.
Esempi
print h3cell = geo_point_to_h3cell(-74.04450446039874, 40.689250859314974, 6)
Output
| h3cell |
|---|
| 862a1072fffffff |
Nell'esempio seguente vengono trovati gruppi di coordinate. Ogni coppia di coordinate nel gruppo risiede nella cella H3 con area esagonale media di 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 | numero | locations |
|---|---|---|
| 852a100bfffffff | 2 | [ "A", "B" ] |
| 852a1073fffffff | 1 | [ "C" ] |
Nell'esempio seguente viene generato un risultato vuoto a causa dell'input di coordinate non valido.
print h3cell = geo_point_to_h3cell(300,1,8)
Output
| h3cell |
|---|
Nell'esempio seguente viene generato un risultato vuoto a causa dell'input di livello non valido.
print h3cell = geo_point_to_h3cell(1,1,16)
Output
| h3cell |
|---|
Nell'esempio seguente viene generato un risultato vuoto a causa dell'input di livello non valido.
print h3cell = geo_point_to_h3cell(1,1,int(null))
Output
| h3cell |
|---|