

 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\$1LineInterpolatePoint
<a name="ST_LineInterpolatePoint-function"></a>

ST\$1LineInterpolatePoint retorna um ponto ao longo de uma linha a uma distância fracionada do início da linha. 

Para determinar a igualdade de pontos, ST\$1LineInterpolatePoint opera na projeção 2D da geometria de entrada. Se a geometria de entrada estiver vazia, será retornado uma cópia na mesma dimensão da entrada. Para geometrias 3DZ, 3DM e 4D, a coordenada `z` ou `m` é a média das coordenadas `z` ou `m` do segmento onde se encontra o ponto.

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

```
ST_LineInterpolatePoint(geom, fraction)
```

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

 *geom*   
Um valor de tipo de dados `GEOMETRY` ou uma expressão que é avaliada como um tipo `GEOMETRY`. O subtipo é `LINESTRING`. 

 *fraction*   
Um valor de tipo de dados `DOUBLE PRECISION` que representa a posição de um ponto ao longo da linestring para a linha. O valor é uma fração no intervalo 0-1, inclusivo. 

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

`GEOMETRY` de subtipo `POINT`. 

Se *geom* ou *fraction* for nulo, null será retornado. 

Se *geom* estiver vazio, o ponto vazio será retornado. 

O valor do identificador do sistema de referência espacial (SRID - spatial reference system identifier) da geometria retornada é o valor do SRID das geometrias de entrada. 

Se *fraction* estiver fora do intervalo, será retornado um erro. 

Se *geom* não for uma linestring, será retornado um erro. 

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

O SQL a seguir retorna um ponto a meio caminho de uma linestring.

```
SELECT ST_AsEWKT(ST_LineInterpolatePoint(ST_GeomFromText('LINESTRING(0 0, 5 5, 7 7, 10 10)'), 0.50));
```

```
st_asewkt
-----------
 POINT(5 5)
```

O SQL a seguir retorna um ponto 90% do caminho ao longo de uma linestring.

```
SELECT ST_AsEWKT(ST_LineInterpolatePoint(ST_GeomFromText('LINESTRING(0 0, 5 5, 7 7, 10 10)'), 0.90));
```

```
st_asewkt
-----------
 POINT(9 9)
```