st_centroid Função

Aplica-se a: Databricks SQL Databricks Runtime 17.1 and above

Retorna o centroide do valor de entrada GEOMETRY como um valor de ponto GEOMETRY 2D.

Syntax

st_centroid ( geoExpr )

Arguments

• geoExpr: valor de GEOMETRY.

Returns

Retorna o centroide (como um ponto 2D) do valor de entrada GEOMETRY como uma geometria. Mais precisamente:

• Se o valor de entrada GEOMETRY estiver vazio, o ponto vazio 2D será retornado.
• Se o valor de entrada GEOMETRY consistir apenas em pontos, o centroide será a média das coordenadas X e Y dos pontos.
• Se o valor de entrada GEOMETRY contiver segmentos lineares (mas nenhuma geometria areal), o centroide será a média ponderada dos pontos médios dos segmentos lineares, em que os pesos são os comprimentos dos segmentos.
• Se o valor de entrada GEOMETRY contiver polígonos, o centroide será a média ponderada dos centroides dos polígonos, em que os pesos são as áreas dos polígonos.

No caso de componentes de dimensão topológica misturada, a computação centroide baseia-se nos componentes da dimensão topológica mais alta. O valor SRID do valor de saída GEOMETRY é o mesmo do valor de entrada.

Examples

> SELECT st_asewkt(st_centroid(st_geomfromtext('POLYGON((1 0, 0.5 0.866, -0.5 0.866, -1 0, -0.5 -0.866, 0.5 -0.866, 1 0))', 3857)));
  SRID=3857;POINT(0 0)

Funções relacionadas

• st_point função
• st_envelope função