ST_Centroid - Amazon Redshift
SintaxeArgumentosTipo de retornoExemplos

ST_Centroid

ST_Centroid retorna um ponto que representa um centroide de uma geometria:

  • Para geometrias POINT, retorna o ponto cujas coordenadas são a média das coordenadas dos pontos da geometria.

  • Para geometrias LINESTRING, retorna o ponto cujas coordenadas são a média ponderada dos pontos médios dos segmentos da geometria, onde os pesos são os comprimentos dos segmentos da geometria.

  • Para geometrias POLYGON, retorna o ponto cujas coordenadas são a média ponderada dos centroides de uma triangulação da geometria plana onde os pesos são as áreas dos triângulos na triangulação.

  • Para coleções de geometrias, retorna a média ponderada dos centroides das geometrias da dimensão topológica máxima na coleção de geometrias.

Sintaxe

ST_Centroid(geom)

Argumentos

geom

Um valor de tipo de dados GEOMETRY ou uma expressão que é avaliada como um tipo GEOMETRY.

Tipo de retorno

GEOMETRY

Nulo será retornado se geom for nulo.

Nulo será retornado se geom estiver vazio.

Exemplos

O SQL a seguir retorna um ponto central de uma linestring de entrada. 

SELECT ST_AsEWKT(ST_Centroid(ST_GeomFromText('LINESTRING(110 40, 2 3, -10 80, -7 9, -22 -33)', 4326)))

                     st_asewkt
----------------------------------------------------
 SRID=4326;POINT(15.6965103455214 27.0206782881905)