Partilhar via

geo_h3cell_neighbors()

  • Artigo

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Calcula os vizinhos da célula H3.

Leia mais sobre o H3 Cell.

Sintaxe

geo_h3cell_neighbors(h3cell)

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Digitar Obrigatória Descrição
h3cell string ✔️ Um valor de token de célula H3 conforme calculado por geo_point_to_h3cell().

Devoluções

Uma matriz de vizinhos de células H3. Se a célula H3 for inválida, a consulta produzirá um resultado nulo.

Observação

Se forem necessários mais do que vizinhos imediatos, consulte geo_h3cell_rings().

Exemplos

O exemplo a seguir calcula os vizinhos de célula H3.

print neighbors = geo_h3cell_neighbors('862a1072fffffff')

Saída

Vizinhos
["862a10727ffffff","862a10707ffffff","862a1070fffffff","862a10777ffffff","862a100dfffffff","862a100d7ffffff"]

O exemplo a seguir calcula uma matriz de célula H3 de entrada com seus vizinhos.

let h3cell = '862a1072fffffff';
print cells = array_concat(pack_array(h3cell), geo_h3cell_neighbors(h3cell))

Saída

Células
["862a1072ff","862a10727ffffff","862a10707ffffff","862a1070ffffff","862a10777ffffff","862a100dfffffff","862a100d7ffffff"]

O exemplo a seguir calcula a coleção de geometria GeoJSON de polígonos de células H3.

let h3cell = '862a1072fffffff';
print cells = array_concat(pack_array(h3cell), geo_h3cell_neighbors(h3cell))
| mv-expand cells to typeof(string)
| project polygons = geo_h3cell_to_polygon(cells)
| summarize arr = make_list(polygons)
| project geojson = bag_pack("type", "Feature","geometry", bag_pack("type", "GeometryCollection", "geometries", arr), "properties", bag_pack("name", "polygons"))

Saída

geojson
{"type": "Recurso","geometry": {"type": "GeometryCollection","geometries": [
{"type":"Polígono","coordinates":[[[-74.0022744646159,40.735376026215022],[-74.] 046908029686236,40.727986222489115],[-74.060610712223664,40.696775140349033],[-74.029724408156682,40.672970047595463],[-73.985140983708192,40.680349049267583],[-73.971393761028622,40.71154393543933],[-74.0022744646159,40.735376026215022]]]},
{"type":"Polígono","coordinates":[[[-74.019448383546617,40.790439140236963],[-74.] 064132193843633,40.783038509825],[-74.077839665342211,40.751803958414136],[-74.046908029686236,40.727986222489115],[-74.0022744646159,40.735376026215022],[-73.988522328408948,40.766594382212254],[-74.019448383546617,40.790439140236963]]]},
{"type":"Polígono","coordinates":[[[-74.077839665342211,40.40.] 751803958414136],[-74.1224794808745,40.744383587828388],[-74.1361375042681,40.713156370029125],[-74.1052004095288,40.689365648097258],[-74.060610712223664,40.696775140349033],[-74.046908029686236,40.727986222489115],[-74.077839665342211,40.751803958414136]]]},
{"type":"Polígono","coordinates":[[[-74.060610712223664,40.696775140349033],[-74.] 1052004095288,40.689365648097258],[-74.118853750491638,40.658161927046628],[-74.0879619670209,40.634383824229609],[-74.043422283844933,40.641782462872115],[-74.029724408156682,40.672970047595463],[-74.060610712223664,40.696775140349033]]]},
{"type":"Polígono","coordinates":[[[-73.985140983708192,40.680349049267583],[-74.] 029724408156682,40.672970047595463],[-74.043422283844933,40.641782462872115],[-74.012581189358343,40.617990065981623],[-73.968047801220749,40.625358290164748],[-73.954305509472675,40.656529678451555],[-73.985140983708192,40.680349049267583]]]},
{"type":"Polígono","coordinates":[[[-73.926766604813565,40.718903205013063],[-73.] 971393761028622,40.7115439393543933],[-73.985140983708192,40.680349049267583],[-73.954305509472675,40.656529678451555],[-73.909728515658443,40.663878222244435],[-73.895936872069854,40.69505685239637],[-73.926766604813565,40.718903205013063]]]},
{"type":"Polígono","coordinates":[[[-73.943844904976629,40.773964402038523],[-73.] 988522328408948,40.766594382212254],[-74.0022744646159,40.735376026215022],[-73.971393761028622,40.71154393543933],[-73.926766604813565,40.718903205013063],[-73.912969923470314,40.750105305345329],[-73.943844904976629,40.773964402038523]]]}]},
"propriedades": {"nome": "polígonos"}}

O exemplo a seguir calcula uniões de polígonos que representam a célula H3 e seus vizinhos.

let h3cell = '862a1072fffffff';
print cells = array_concat(pack_array(h3cell), geo_h3cell_neighbors(h3cell))
| mv-expand cells to typeof(string)
| project polygons = geo_h3cell_to_polygon(cells)
| summarize arr = make_list(polygons)
| project polygon = geo_union_polygons_array(arr)

Saída

polígono
{
"type": "Polígono",
"coordenadas": [[[ -73.926766604813565, 40.718903205013063],[ -73.912969923470314, 40.750105305345329],[ -73.943844904976629, 40.773964402038523],[ -73.988522328408948, 40.766594382212254],[ -74.019448383546617, 40.0194483546617, 40.019448383546617, 40.019448383546617, 40.019448383546617, 40.019448383546617, 40.019448383546617, 40.0194483838383846617, 40.019448383546617, 79043914023697],[ -74.064132193843633, 40.783038509825005],[ -74.077839665342211, 40.751803958414136],[ -74.1224794808745, 40.744383587828388],[ -74.1361375042681, 40.713156370029125],[ -74.1052004095288, 40.689365648097251],[ -74.118853750491638, 40.658161927046628],[ -74.0879619670209, 40.6343838242296],[ -74.043422283844933, 40.641782462872115],[ -74.012581189358343, 40.617990065981623],[ -73.968047801220749, 40.625358290164755],[ -73.954305509472675, 40.656529678451555],[ -73.909728515658443, 40.663878222244442],[ -73.895936872069854, 40.695056852396377],[ -73.926766604813565, 40.718903205013063]]]}

O exemplo a seguir retorna true devido à entrada de token de célula H3 inválida.

print invalid = isnull(geo_h3cell_neighbors('abc'))

Saída

inválido
1