geo_h3cell_parent()

Calcula o pai da célula H3.

Leia mais sobre a Célula H3.

Syntax

geo_h3cell_parent(h3cell,Resolução)

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
h3cell	string	✔️	Um valor de token de célula H3 como foi calculado por geo_point_to_h3cell().
Resolução	int		Define a resolução de células filho solicitada. Os valores com suporte estão no intervalo [0, 14]. Se não for especificado, um token filho imediato será calculado.

Retornos

Token stringpai da célula H3 . Se a célula H3 for inválida ou a resolução pai for maior do que determinada, a consulta produzirá um resultado vazio.

Exemplos

Executar a consulta

print parent_cell = geo_h3cell_parent('862a1072fffffff')

Saída

parent_cell
852a1073fffffffff

O exemplo a seguir calcula o pai da célula no nível 1.

Executar a consulta

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

Saída

parent_cell
812a3ffffffff

Executar a consulta

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

Saída

parent_res
9

Executar a consulta

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

Saída

parent_res
3

O exemplo a seguir produz um resultado vazio devido à entrada de célula inválida.

Executar a consulta

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

Saída

inválido
1

O exemplo a seguir produz um resultado vazio devido à resolução pai inválida.

Executar a consulta

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

Saída

inválido
1

O exemplo a seguir produz um resultado vazio porque o pai não pode ter uma resolução maior do que o filho.

Executar a consulta

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

Saída

inválido
1