geo_point_to_h3cell()

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	Tipo	Obbligatoria	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 della 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.

Restituisce

Valore della stringa del token di 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,9 m² 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 consentono di approssimare facilmente i raggi e tutti i vicini sono equidisti
• Gli esagoni sono visivamente piacevoli
• In alcuni rari casi la forma è il pentagono.
• H3 Cell 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 sulla longitudine x e la 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 Cell approssimazione della copertura dell'area per valore di risoluzione

Level	Lunghezza media del bordo 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 di griglia disponibili. vedere clustering geospaziale con Linguaggio di query Kusto.

Esempio

Eseguire la query

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 del gruppo risiede nella cella H3 con area esagonale media di 253 km².

Eseguire la query

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
852a100bfffffff	2	[ "A", "B" ]
852a1073fffffff	1	[ "C" ]

Nell'esempio seguente viene generato un risultato vuoto a causa dell'input di coordinate non valido.

Eseguire la query

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.

Eseguire la query

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.

Eseguire la query

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

Output

h3cell