O Amazon Redshift não permitirá mais a criação de UDFs do Python a partir do Patch 198. As UDFs do Python existentes continuarão a funcionar normalmente até 30 de junho de 2026. Para ter mais informações, consulte a [publicação de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

# H3\$1FromPoint
<a name="H3_FromPoint-function"></a>

H3\$1FromPoint 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](spatial-terminology.md#spatial-terminology-h3).

## Sintaxe
<a name="H3_FromPoint-function-syntax"></a>

```
H3_FromPoint(geom, resolution)
```

## Argumentos
<a name="H3_FromPoint-function-arguments"></a>

 *geom*   
Um valor de tipo de dados `GEOMETRY` ou uma expressão que é avaliada como um tipo `GEOMETRY`. A *geom* deve ser um `POINT`.

 *resolução*   
Um valor do tipo de dados `INTEGER` ou uma expressão avaliada como um tipo `INTEGER`. O valor representa a resolução do sistema de grade H3. O valor deve ser um número inteiro entre 0 e 15, inclusive. Com `0` sendo o mais aproximado e `15` sendo o mais preciso. 

## Tipo de retorno
<a name="H3_FromPoint-function-return"></a>

`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
<a name="H3_FromPoint-function-examples"></a>

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
```