st_centroid Função

Aplica-se a: Databricks SQL Databricks Runtime 17.1 e superior

Devolve o centróide do valor de entrada GEOMETRY como um valor de ponto GEOMETRY 2D.

Syntax

st_centroid ( geoExpr )

Arguments

• geoExpr: Um GEOMETRY valor.

Returns

Devolve o centróide (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 centróide é a média das coordenadas X e Y dos pontos.
• Se o valor de entrada GEOMETRY contém segmentos lineares (mas sem geometrias de área), o centróide é a média ponderada dos pontos médios dos segmentos lineares, onde os pesos são os comprimentos dos segmentos.
• Se o valor de entrada GEOMETRY contiver polígonos, o centróide é a média ponderada dos centróides dos polígonos, onde os pesos são as áreas dos polígonos.

No caso de componentes mistos de dimensão topológica, o cálculo centróide é baseado nos componentes de maior dimensão topológica. O valor SRID do valor de saída GEOMETRY é o mesmo que o 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