

 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/). 

# ST\$1GeomFromGeoSquare
<a name="ST_GeomFromGeoSquare-function"></a>

ST\$1GeomFromGeoSquare retorna uma geometria que cobre a área representada por um valor de quadrado geográfico de entrada. A geometria retornada é sempre bidimensional. Para calcular um valor de quadrado geográfico, consulte [ST\$1GeoSquare](ST_GeoSquare-function.md).

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

```
ST_GeomFromGeoSquare(geosquare)
```

```
ST_GeomFromGeoSquare(geosquare, max_depth)
```

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

 *geosquare*   
Um valor do tipo de dados `BIGINT` ou uma expressão avaliada como um tipo `BIGINT` que é um valor de quadrado geográfico e descreve a sequência de subdivisões feitas no domínio inicial para alcançar o quadrado desejado. Esse valor é calculado por [ST\$1GeoSquare](ST_GeoSquare-function.md).

 *max\$1depth*   
Um valor do tipo de dados `INTEGER` que representa o número máximo de subdivisões de domínio feitas no domínio inicial. O valor deve ser igual ou maior que `1`.

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

`GEOMETRY`

Se o *geosquare* não for válido, a função retornará um erro. 

Se a entrada *max\$1depth* não estiver dentro do intervalo, a função retornará um erro. 

## Exemplos
<a name="ST_GeomFromGeoSquare-function-examples"></a>

O SQL a seguir retorna uma geometria de um valor de quadrado geográfico.

```
SELECT ST_AsText(ST_GeomFromGeoSquare(797852));
```

```
 st_astext       
--------------------------------------------------------------------------------------------------------------------
 POLYGON((13.359375 52.3828125,13.359375 52.734375,13.7109375 52.734375,13.7109375 52.3828125,13.359375 52.3828125))
```

O SQL a seguir retorna uma geometria de um valor de quadrado geográfico e uma profundidade máxima de `3`. 

```
SELECT ST_AsText(ST_GeomFromGeoSquare(797852, 3));
```

```
 st_astext       
--------------------------------------
 POLYGON((0 45,0 90,45 90,45 45,0 45))
```

O SQL a seguir primeiro calcula o valor de quadrado geográfico para Seattle especificando a coordenada x como longitude e a coordenada y como latitude (-122.3, 47.6). Depois, ele retorna o polígono para o quadrado geográfico. Embora a saída seja uma geometria bidimensional, ela pode ser usada para calcular dados espaciais em termos de longitude e latitude.

```
SELECT ST_AsText(ST_GeomFromGeoSquare(ST_GeoSquare(ST_Point(-122.3, 47.6))));
```

```
 st_astext
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
POLYGON((-122.335167014971 47.6080129947513,-122.335167014971 47.6080130785704,-122.335166931152 47.6080130785704,-122.335166931152 47.6080129947513,-122.335167014971 47.6080129947513))
```