Udostępnij za pośrednictwem

geo_h3cell_parent()

  • Artykuł

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

Oblicza element nadrzędny komórki H3.

Przeczytaj więcej na temat komórki H3.

Składnia

geo_h3cell_parent(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 [0, 14]. Jeśli nie zostanie określony, zostanie obliczony natychmiastowy token podrzędny.

Zwraca

Token nadrzędny stringkomórki H3 . Jeśli komórka H3 jest nieprawidłowa lub nadrzędna rozdzielczość jest wyższa niż dana komórka, zapytanie spowoduje wygenerowanie pustego wyniku.

Przykłady

print parent_cell = geo_h3cell_parent('862a1072fffffff')

Wyjście

parent_cell
852a1073fffff

Poniższy przykład oblicza element nadrzędny komórki na poziomie 1.

print parent_cell = geo_h3cell_parent('862a1072fffffff', 1)

Wyjście

parent_cell
812a3ffffffff 
print parent_res = geo_h3cell_level(geo_h3cell_parent((geo_point_to_h3cell(1,1,10))))

Wyjście

parent_res
9 
print parent_res = geo_h3cell_level(geo_h3cell_parent(geo_point_to_h3cell(1,1,10), 3))

Wyjście

parent_res
3

Poniższy przykład generuje pusty wynik z powodu nieprawidłowych danych wejściowych komórki.

print invalid = isempty(geo_h3cell_parent('123'))

Wyjście

nieprawidłowe
1

Poniższy przykład generuje pusty wynik z powodu nieprawidłowego rozwiązania nadrzędnego.

print invalid = isempty(geo_h3cell_parent('862a1072fffffff', 100))

Wyjście

nieprawidłowe
1

Poniższy przykład generuje pusty wynik, ponieważ element nadrzędny nie może być wyższą rozdzielczością niż element podrzędny.

print invalid = isempty(geo_h3cell_parent('862a1072fffffff', 15))

Wyjście

nieprawidłowe
1