Udostępnij za pośrednictwem

geo_h3cell_children()

  • Artykuł

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Oblicza elementy podrzędne komórek H3.

Przeczytaj więcej na temat komórki H3.

Składnia

geo_h3cell_children(rozdzielczość h3cell,)

Dowiedz się więcej na temat konwencji składni.

Parametry

Nazwisko Type Wymagania opis
h3cell string ✔️ Wartość tokenu komórki H3 obliczona przez geo_point_to_h3cell().
rezolucja int Definiuje żądane rozpoznawanie komórek podrzędnych. Obsługiwane wartości znajdują się w zakresie [1, 15]. Jeśli nie zostanie określony, zostanie obliczony natychmiastowy token podrzędny.

Zwraca

Tablica tokenów elementów podrzędnych komórki H3. Jeśli komórka H3 jest nieprawidłowa lub podrzędna rozdzielczość jest niższa niż dana komórka, zapytanie spowoduje wygenerowanie wyniku null.

Uwaga

Różnica między rozpoznawaniem komórek a jej dziećmi nie może być większa niż 5. Różnica 5 poziomów spowoduje do 16807 tokenów podrzędnych.

Przykłady

print children = geo_h3cell_children('862a1072fffffff')

Wyjście

children
[ "872a10728ff", "872a10729ff", "872a1072affffff", "872a1072bff", "872a1072cff", "872a1072dff", "872a1072eff" ]

Poniższy przykład zlicza 3 poziomy podrzędne poniżej danej komórki.

let h3_cell = '862a1072fffffff'; 
print children_count = array_length(geo_h3cell_children(h3_cell, geo_h3cell_level(h3_cell) + 3))

Wyjście

children_count
343

Poniższy przykład tworzy kolekcję geometrii GeoJSON wielokątów elementów podrzędnych H3.

print children = geo_h3cell_children('862a1072fffffff')
| mv-expand children to typeof(string)
| project child = geo_h3cell_to_polygon(children)
| summarize h3_hash_polygon_lst = make_list(child)
| project geojson = bag_pack(
    "type", "Feature",
    "geometry", bag_pack("type", "GeometryCollection", "geometries", h3_hash_polygon_lst),
    "properties", bag_pack("name", "H3 polygons collection"))

Wyjście

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

Poniższy przykład zwraca wartość true z powodu nieprawidłowej komórki.

print is_null = isnull(geo_h3cell_children('abc'))

Wyjście

is_null
1

Poniższy przykład zwraca wartość true, ponieważ różnica między komórką a jej elementami podrzędnym jest większa niż 5.

print is_null = isnull(geo_h3cell_children(geo_point_to_h3cell(1, 1, 9), 15))

Wyjście

is_null
1