H3_FromPoint
H3_FromPoint exibe o ID da célula H3 correspondente de uma resolução e de um ponto de geometria de entrada. Para obter informações sobre a indexação H3, consulte H3.
Sintaxe
H3_FromPoint(geom, resolution)
Argumentos
- geom
-
Um valor de tipo de dados
GEOMETRY
ou uma expressão que é avaliada como um tipoGEOMETRY
. A geom deve ser umPOINT
. - resolução
-
Um valor do tipo de dados
INTEGER
ou uma expressão avaliada como um tipoINTEGER
. O valor representa a resolução do sistema de grade H3. O valor deve ser um número inteiro entre 0 e 15, inclusive. Com0
sendo o mais aproximado e15
sendo o mais preciso.
Tipo de retorno
BIGINT
: representa o ID da célula H3.
Se geom não for uma POINT
, será retornado um erro.
Se resolução estiver fora dos limites, um erro será retornado.
Se geom estiver vazio, NULL será retornado.
Exemplos
O SQL a seguir retorna o ID da célula H3 do ponto 0,0
e a resolução 10
.
SELECT H3_FromPoint(ST_GeomFromText('POINT(0 0)'), 10);
h3_frompoint
-------------------
623560421467684863