ST_Length

Definition

ST_Length gibt die Länge eines Linestring oder Multilinestring zurück.

Syntax

Oracle und 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)

Eine Liste der unterstützten Einheitennamen finden Sie unter ST_Distance.

Rückgabetyp

Doppelte Genauigkeit

Beispiel

Ein Ökologe, der die Migrationsmuster der Lachspopulation in den Gewässern des Landes studiert, möchte die Länge aller Strom- und Flusssysteme des Landes ermitteln.

Die Tabelle "waterways" wird mit den Spalten "ID" und "name" erstellt, welche die einzelnen in der Tabelle gespeicherten Strom- und Flusssysteme eindeutig kennzeichnen. Die Spalte "water" enthält Multilinestrings, weil die Strom- und Flusssysteme häufig Aggregate von mehreren Linestrings sind.

Die SELECT-Abfrage gibt den Namen des Systems sowie die von der Funktion ST_Length generierte Länge des jeweiligen Systems aus. In Oracle und PostgreSQL werden die Einheiten des Koordinatensystems verwendet. In SQLite werden Kilometereinheiten angegeben.

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