geo_h3cell_children()

Berekent de onderliggende H3-cellen.

Lees meer over H3-cel.

Syntax

geo_h3cell_children( h3cell,Resolutie)

Meer informatie over syntaxisconventies.

Parameters

Naam	Type	Vereist	Beschrijving
h3cell	string	✔️	Een H3-celtokenwaarde zoals deze is berekend door geo_point_to_h3cell().
Resolutie	int		Definieert de aangevraagde onderliggende celomzetting. Ondersteunde waarden bevinden zich in het bereik [1, 15]. Als dit niet wordt opgegeven, wordt een direct onderliggende token berekend.

Retouren

Matrix van onderliggende H3-celtokens. Als de H3-cel ongeldig is of als de onderliggende resolutie lager is dan de opgegeven cel, produceert de query een null-resultaat.

Notitie

Het verschil tussen de celresolutie en de onderliggende cellen mag niet groter zijn dan 5. Een verschil van 5 niveaus resulteert in maximaal 16807 onderliggende tokens.

Voorbeelden

De query uitvoeren

print children = geo_h3cell_children('862a1072fffffff')

Uitvoer

kinderen
[ "872a10728ffffff", "872a10729ffffff", "872a1072affffff", "872a1072bffffff", "872a1072cffffff", "872a1072dffffff", "872a1072effffff" ]

In het volgende voorbeeld worden kinderen geteld met drie niveaus onder een bepaalde cel.

De query uitvoeren

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

Uitvoer

children_count
343

In het volgende voorbeeld wordt de GeoJSON-geometrieverzameling van H3-cel-onderliggende veelhoeken samengevoegd.

De query uitvoeren

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"))

Uitvoer

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

In het volgende voorbeeld wordt true geretourneerd vanwege de ongeldige cel.

De query uitvoeren

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

Uitvoer

is_null
1

In het volgende voorbeeld wordt true geretourneerd omdat het niveauverschil tussen de cel en de onderliggende cellen meer dan 5 is.

De query uitvoeren

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

Uitvoer

is_null
1