ST_Angle - Amazon Redshift
SintaxeArgumentosTipo de retornoExemplos

O Amazon Redshift não permitirá mais a criação de funções definidas pelo usuário (UDFs) do Python a partir de 1.º de novembro de 2025. Se quiser usar UDFs do Python, você deve criá-las antes dessa data. As UDFs do Python existentes continuarão a funcionar normalmente. Para ter mais informações, consulte a publicação de blog .

ST_Angle

ST_Angle retorna o ângulo em radianos entre pontos medidos no sentido horário da seguinte forma:

  • Se forem introduzidos três pontos, o ângulo retornado P1-P2-P3 é medido como se o ângulo fosse obtido girando de P1 para P3 em torno de P2 no sentido horário.

  • Se quatro pontos forem inseridos, o ângulo retornado no sentido horário formado pelas linhas direcionadas P1-P2 e P3-P4 é retornado. Se a entrada for um caso degenerado (ou seja, P1 é igual a P2 ou P3 igual a P4), então null é retornado.

O valor de retorno é em radianos e no intervalo [0, 2π).

ST_Angle opera em projeções 2D das geometrias de entrada.

Sintaxe

ST_Angle(geom1, geom2, geom3)
ST_Angle(geom1, geom2, geom3, geom4)

Argumentos

geom1

Um valor de tipo de dados GEOMETRY ou uma expressão que é avaliada como um tipo GEOMETRY. O subtipo deve ser POINT.

geom2

Um valor de tipo de dados GEOMETRY ou uma expressão que é avaliada como um tipo GEOMETRY. O subtipo deve ser POINT.

geom3

Um valor de tipo de dados GEOMETRY ou uma expressão que é avaliada como um tipo GEOMETRY. O subtipo deve ser POINT.

geom4

Um valor de tipo de dados GEOMETRY ou uma expressão que é avaliada como um tipo GEOMETRY. O subtipo deve ser POINT.

Tipo de retorno

DOUBLE PRECISION.

Se geom1 for igual a geom2 ou geom2 for igual a geom3, será retornado null.

Se geom1, geom2, geom3 ou geom4 forem nulos, será retornado null.

Se geom1, geom2, geom3 ou geom4 forem um ponto vazio, será retornado um erro.

Se geom1, geom2, geom3 e geom4 não tiverem o mesmo valor de identificador do sistema de referência espacial (SRID), será retornado um erro.

Exemplos

O SQL a seguir retorna o ângulo convertido em graus de três pontos de entrada. 

SELECT ST_Angle(ST_Point(1,1), ST_Point(0,0), ST_Point(1,0)) / Pi() * 180.0 AS angle;

 angle
---------------
    45

O SQL a seguir retorna o ângulo convertido em graus de quatro pontos de entrada. 

SELECT ST_Angle(ST_Point(1,1), ST_Point(0,0), ST_Point(1,0), ST_Point(2,0)) / Pi() * 180.0 AS angle;

 angle
---------------
   225