Categorias:

Funções geoespaciais

H3_CELL_TO_PARENT

Retorna o ID do pai de uma célula H3 para uma determinada resolução. O ID é retornado como um valor INTEGER (se um valor INTEGER foi fornecido como ID de entrada) ou como um VARCHAR contendo o ID hexadecimal (se o ID hexadecimal foi fornecido como ID de entrada).

Consulte também:

H3_CELL_TO_CHILDREN , H3_CELL_TO_CHILDREN_STRING

Sintaxe

H3_CELL_TO_PARENT( <cell_id> , <target_resolution> )
Copy

Argumentos

cell_id

Um INTEGER que representa o ID da célula H3 (índice) ou um VARCHAR que representa o ID da célula em formato hexadecimal.

target_resolution

Um INTEGER entre 0 e 15 (inclusive) especificando resolução H3 que você deseja usar para a célula H3 retornada.

Especificar qualquer outro valor INTEGER resulta em erro.

Retornos

Retorna o ID da célula pai H3 na resolução de destino especificada. O ID está em um dos seguintes formatos:

  • Se cell_id for um valor INTEGER, a função retornará ID como um valor INTEGER.

  • Se cell_id for um valor VARCHAR contendo o ID hexadecimal, a função retornará o ID hexadecimal como um valor VARCHAR.

Exemplos

O exemplo a seguir retorna o ID da célula H3 para o pai da célula H3 com ID 613036919424548863 (especificado como um valor INTEGER):

SELECT H3_CELL_TO_PARENT(613036919424548863, 7);
Copy
+------------------------------------------+
| H3_CELL_TO_PARENT(613036919424548863, 7) |
|------------------------------------------|
|                       608533319805566975 |
+------------------------------------------+

O exemplo a seguir retorna o ID da célula H3 para o pai da célula H3 com ID 881F1D4887FFFFF (especificado como um valor VARCHAR):

SELECT H3_CELL_TO_PARENT('881F1D4887FFFFF', 7);
Copy
+-----------------------------------------+
| H3_CELL_TO_PARENT('881F1D4887FFFFF', 7) |
|-----------------------------------------|
|  871F1D488FFFFFF                        |
+-----------------------------------------+