ST_Length

定义

ST_Length 用于返回线串或多线串的长度。

语法

Oracle 和 PostgreSQL

sde.st_length (line1 sde.st_geometry)
sde.st_length (multiline1 sde.st_geometry)

SQLite

st_length (line1 geometryblob)
st_length (multiline1 geometryblob)
st_length (line1  geometryblob, unit_name text)
st_length (multiline1  geometryblob, unit_name text)

有关支持的单位名称列表，请参阅 ST_Distance。

返回类型

双精度型

示例

生态学家研究当地水道中鲑鱼种群的迁移模式时，需要获取当地所有溪流与河流系统的长度。

将创建一个包含 ID 和名称列的水道表，这些列标识了表格中所存储的各溪流和河流系统。水体列是多线串类型，因为溪流与河流系统常常是多个线串的聚合体。

SELECT 查询将返回系统名称以及 ST_Length 函数生成的系统长度。在 Oracle 和 PostgreSQL 中，使用坐标系中的单位。在 SQLite 中，指定以千米为单位。

Oracle

CREATE TABLE waterways (
 oid integer,
 name varchar(128),
 water sde.st_geometry
);

INSERT INTO waterways (oid, name, water) VALUES (
  1111,
  'Genesee', 
  sde.st_multilinestring ('multilinestring ((33 2, 34 3, 35 6),
(28 4, 29 5, 31 8, 43 12), (39 3, 37 4, 36 7))', 4326)
);

SELECT name, sde.st_length (water) "Length"
 FROM WATERWAYS;

NAME	Length

Genesee	27.6437123

PostgreSQL

CREATE TABLE waterways (
 oid serial,
 name varchar(128),
 water sde.st_geometry
);

INSERT INTO waterways (name, water) VALUES (
  'Genesee', 
  sde.st_multilinestring ('multilinestring ((33 2, 34 3, 35 6),
(28 4, 29 5, 31 8, 43 12), (39 3, 37 4, 36 7))', 4326)
);

SELECT name AS "Watershed Name",
 sde.st_length (water) AS "Length"
 FROM waterways;

Watershed Name	 |  Length

Genesee	       | 27.6437123387202

SQLite

CREATE TABLE waterways (
 oid integer primary key autoincrement not null,
 name text(128)
);

SELECT AddGeometryColumn (
 NULL,
 'waterways',
 'water',
 4326,
 'multilinestring',
 'xy',
 'null'
);

INSERT INTO waterways (name, water) VALUES (
  'Genesee', 
  st_multilinestring ('multilinestring ((33 2, 34 3, 35 6),
(28 4, 29 5, 31 8, 43 12), (39 3, 37 4, 36 7))', 4326)
);

SELECT name AS "Watershed Name",
 st_length (water, 'kilometer') AS "Length"
 FROM waterways1;

Watershed Name	    Length

Genesee	           3047.75515002795