st_centroid Función

Se aplica a: Databricks SQL Databricks Runtime 17.1 y versiones posteriores

Important

Esta característica está en versión preliminar pública.

Nota:

Esta característica no está disponible en almacenes clásicos de Databricks SQL. Para más información sobre los almacenes de SQL de Databricks, consulte Tipos de almacenamiento de SQL.

Devuelve el centroide del valor de entrada GEOMETRY como un valor de punto GEOMETRY 2D.

Syntax

st_centroid ( geoExpr )

Arguments

• geoExpr: Un GEOMETRY valor.

Returns

Devuelve el centroide (como punto 2D) del valor de entrada GEOMETRY como una geometría. Más precisamente:

• Si el valor de entrada GEOMETRY está vacío, se devuelve el punto vacío 2D.
• Si el valor de entrada GEOMETRY consta solo de puntos, el centroide es el promedio de las coordenadas X e Y de los puntos.
• Si el valor de entrada GEOMETRY contiene segmentos lineales (pero no geometrías areales), el centroide es el promedio ponderado de los puntos medio de los segmentos lineales, donde los pesos son las longitudes de los segmentos.
• Si el valor de entrada GEOMETRY contiene polígonos, el centroide es el promedio ponderado de los centroide de los polígonos, donde los pesos son las áreas de los polígonos.

En el caso de componentes mixtos de dimensión topológica, el cálculo centroide se basa en los componentes de la dimensión topológica más alta. El valor SRID del valor de salida GEOMETRY es el mismo que el del 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)

Funciones relacionadas

• st_point Función
• st_envelope Función