Определение
ST_Centroid принимает объект полигона, мультиполигона или мультилинии и возвращает точку, являющуюся центром огибающей геометрии. Это означает, что точка центроида находится посередине между минимальным и максимальным экстентом x и y геометрии.
Синтаксис
Oracle и PostgreSQL
sde.st_centroid (polygon sde.st_geometry) sde.st_centroid (multipolygon sde.st_geometry) sde.st_centroid (multilinestring sde.st_geometry)
SQLite
st_centroid (polygon geometryblob) st_centroid (multipolygon geometryblob) st_centroid (multilinestring geometryblob)
Тип возвращаемого значения
ST_Point
Пример
Городской ГИС-техник хочет отобразить мультиполигоны контуров зданий как точки на графике плотности зданий. Контуры зданий хранятся в таблице bfp, созданной и заполненной выражениями, показанными для каждой базы данных.
Oracle
--Create and populate table
CREATE TABLE bfp (
building_id integer,
footprint sde.st_geometry);
INSERT INTO bfp VALUES (
1,
sde.st_polygon ('polygon ((0 0, 0 10, 10 10, 10 0, 0 0))', 4326)
);
INSERT INTO bfp VALUES (
2,
sde.st_polygon ('polygon ((20 0, 30 20, 40 0, 20 0))', 4326)
);
INSERT INTO bfp VALUES (
3,
sde.st_polygon ('polygon ((20 30, 25 35, 30 30, 20 30))', 4326)
);
--The ST_Centroid function returns the centroid of each building footprint multipolygon.
--The ST_AsText function converts each centroid point into a text representation recognized by the application.
SELECT building_id,
sde.st_astext (sde.st_centroid (footprint)) Centroid
FROM bfp;
BUILDING_ID Centroid
1 POINT (5.00000000 5.00000000)
2 POINT (30.00000000 10.00000000)
3 POINT (25.00000000 32.50000000)
PostgreSQL
--Create and populate table
CREATE TABLE bfp (
building_id serial,
footprint sde.st_geometry);
INSERT INTO bfp (footprint) VALUES (
sde.st_polygon ('polygon ((0 0, 0 10, 10 10, 10 0, 0 0))', 4326)
);
INSERT INTO bfp (footprint) VALUES (
sde.st_polygon ('polygon ((20 0, 30 20, 40 0, 20 0))', 4326)
);
INSERT INTO bfp (footprint) VALUES (
sde.st_polygon ('polygon ((20 30, 25 35, 30 30, 20 30))', 4326)
);
--The ST_Centroid function returns the centroid of each building footprint multipolygon.
--The ST_AsText function converts each centroid point into a text representation recognized by the application.
SELECT building_id, sde.st_astext (sde.st_centroid (footprint))
AS centroid
FROM bfp;
building_id centroid
1 POINT (5 5)
2 POINT (30 10)
3 POINT (25 33)
SQLite
--Create table, add geometry column, and populate table
CREATE TABLE bfp (
building_id integer primary key autoincrement not null
);
SELECT AddGeometryColumn (
NULL,
'bfp',
'footprint',
4326,
'polygon',
'xy',
'null'
);
INSERT INTO bfp (footprint) VALUES (
st_polygon ('polygon ((0 0, 0 10, 10 10, 10 0, 0 0))', 4326)
);
INSERT INTO bfp (footprint) VALUES (
st_polygon ('polygon ((20 0, 30 20, 40 0, 20 0))', 4326)
);
INSERT INTO bfp (footprint) VALUES (
st_polygon ('polygon ((20 30, 25 35, 30 30, 20 30))', 4326)
);
--The ST_Centroid function returns the centroid of each building footprint multipolygon.
--The ST_AsText function converts each centroid point into a text representation recognized by the application.
SELECT building_id, st_astext (st_centroid (footprint))
AS "centroid"
FROM bfp;
building_id centroid
1 POINT (5.00000000 5.00000000)
2 POINT (30.00000000 10.0000000)
3 POINT (25.00000000 32.5000000)