geo_h3cell_parent()

Oblicza obiekt nadrzędny komórki H3.

Przeczytaj więcej o komórce H3.

Składnia

geo_h3cell_parent(h3cell,Rozdzielczość)

Dowiedz się więcej o konwencjach składniowych.

Parametry

Nazwa Typ Wymagane Opis
h3cell string ✔️ Wartość tokenu komórki H3 obliczana przez geo_point_to_h3cell().
Rozdzielczość int Definiuje żądane rozpoznawanie komórek podrzędnych. Obsługiwane wartości znajdują się w zakresie [0, 14]. Jeśli nie zostanie określona, zostanie obliczony token natychmiastowych elementów podrzędnych.

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

Dane wyjściowe

parent_cell
852a1073fffffffff

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

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

Dane wyjściowe

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

Dane wyjściowe

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

Dane wyjściowe

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

Dane wyjściowe

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

Dane wyjściowe

nieprawidłowe
1

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

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

Dane wyjściowe

nieprawidłowe
1