geo_h3cell_rings()

Calcola gli anelli di cella H3.

Altre informazioni sulla cella H3.

Sintassi

geo_h3cell_rings(h3cell,Distanza)

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome	Tipo	Obbligatoria	Descrizione
h3cell	string	✔️	Valore del token di cella H3 calcolato da geo_point_to_h3cell().
distance	int	✔️	Definisce la distanza massima dell'anello dalla cella specificata. La distanza valida è compresa nell'intervallo [0, 142].

Restituisce

Matrice ordinata di matrici circolari in cui il primo anello contiene la cella originale, il secondo anello contiene celle adiacenti e così via. Se la cella H3 o la distanza non è valida, la query genera un risultato Null.

Nota

• Solo per i vicini immediati della cella H3, vedere geo_h3cell_neighbors().
• Una cella potrebbe non essere presente nell'anello se è stata rilevata una distorsione pentagonale.

Esempio

Nell'esempio seguente vengono generati anelli fino alla distanza 2.

Eseguire la query

print rings = geo_h3cell_rings('861f8894fffffff', 2)

Output

Anelli

[ ["861f8894fffffff"], ["861f88947ffffff","861f8895fffffff","861f8867ffffff","861f8d497ffffff","861f8d4b7ffffff","861f8896fffffff"], ["861f88967ffffff","861f88977ffffff","861f8957ffffff","861f8882fffff","861f8887ffffff","861f88847ffff","861f8847ffff","","861f8847ffff","861f88847ffff","861f88847ffff","861f8847ffffff","861f8847ffffff","861f88847ffff"," 861f886fffffff","861f8d49fff","861f8d487ffffff","861f8d4a7ffffff","861f8d59fffffff","861f8d597ffffff"] ]

L'esempio seguente produce tutte le celle al livello 1 (tutti i vicini).

Eseguire la query

print neighbors = geo_h3cell_rings('861f8894fffffff', 1)[1]

Output

Vicini
["861f88947ffffff", "861f8895fff", "861f88867ffffff", "861f8d497ffffff", "861f8d4b7ffffff","861f896fffff"]

Nell'esempio seguente viene generato un elenco di celle da tutti gli anelli.

Eseguire la query

print rings = geo_h3cell_rings('861f8894fffffff', 1)
| mv-apply rings on 
(
  summarize cells = make_list(rings)
)

Output

celle
["861f8894fffffff","861f88947ffffff","861f8895fffff","861f88867ffffff","861f8d497ffffff","861f8d4b7ffff","861f8896fffff"]

Nell'esempio seguente viene assemblata la raccolta geometry GeoJSON di tutte le celle.

Eseguire la query

print rings = geo_h3cell_rings('861f8894fffffff', 1)
| mv-apply rings on 
(
  summarize make_list(rings)
)
| mv-expand list_rings to typeof(string)
| project polygon = geo_h3cell_to_polygon(list_rings)
| summarize polygon_lst = make_list(polygon)
| project geojson = bag_pack(
    "type", "Feature",
    "geometry", bag_pack("type", "GeometryCollection", "geometries", polygon_lst),
    "properties", bag_pack("name", "H3 polygons collection"))

Output

geojson
{ "type": "Feature", "geometry": { "type": "GeometryCollection", "geometries": [ ... ... ]}, "properties": { "name": "H3 polygons collection" }}

Nell'esempio seguente viene restituito true a causa della cella non valida.

Eseguire la query

print is_null = isnull(geo_h3cell_rings('abc', 3))

Output

is_null
1

Nell'esempio seguente viene restituito true a causa della distanza non valida.

Eseguire la query

print is_null = isnull(geo_h3cell_rings('861f8894fffffff', 150))

Output

is_null
1