H3_FromPoint

H3_FromPoint restituisce l’ID della cella H3 corrispondente di un punto delle geometria e di una risoluzione di input. Per ulteriori informazioni sull'indicizzazione H3, consulta H3.

Sintassi

H3_FromPoint(geom, resolution)

Argomenti

geom

Un valore di tipo GEOMETRY o un'espressione che restituisce un valore di tipo GEOMETRY. L'argomento geom deve essere POINT.

risoluzione

Un valore di tipo INTEGER o un'espressione che restituisce un valore di tipo INTEGER. Il valore rappresenta la risoluzione del sistema a griglia H3. Il valore deve essere un numero intero compreso tra 0 e 15, di cui 0 è la risoluzione più grossolana e 15 la più granulare.

Tipo restituito

BIGINT: rappresenta l'ID della cella H3.

Se geom non è un POINT, allora viene restituito un errore.

Se la risoluzione non è compresa nell'intervallo valido viene restituito un errore.

Se geom è vuoto, viene restituito NULL.

Esempi

La seguente istruzione SQL restituisce l'ID della cella H3 dal punto 0,0 e risoluzione 10.

SELECT H3_FromPoint(ST_GeomFromText('POINT(0 0)'), 10);

 h3_frompoint
-------------------
 623560421467684863