- Categorias:
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:
Sintaxe¶
H3_CELL_TO_PARENT( <cell_id> , <target_resolution> )
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_idfor um valor INTEGER, a função retornará ID como um valor INTEGER.
- Se - cell_idfor 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);
+------------------------------------------+
| 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);
+-----------------------------------------+
| H3_CELL_TO_PARENT('881F1D4887FFFFF', 7) |
|-----------------------------------------|
|  871F1D488FFFFFF                        |
+-----------------------------------------+