LineString

Ein LineString ist ein eindimensionales Objekt, das eine Sequenz aus Punkten und die sie verbindenden Liniensegmente darstellt.

LineString-Instanzen

Die nachfolgende Abbildung enthält Beispiele für LineString-Instanzen.

Folgendes wird dargestellt:

• Abbildung 1 zeigt eine einfache, nicht geschlossene LineString-Instanz.

• Abbildung 2 zeigt eine nicht einfache, nicht geschlossene LineString-Instanz.

• Abbildung 3 zeigt eine einfache, geschlossene LineString-Instanz und daher einen Ring.

• Abbildung 4 zeigt eine nicht einfache, geschlossene LineString-Instanz und daher keinen Ring.

Akzeptierte Instanzen

Akzeptierte LineString-Instanzen können in eine geometry-Variable eingegeben werden. Möglicherweise sind sie jedoch keine gültigen LineString-Instanzen. Damit eine LineString-Instanz akzeptiert wird, müssen die folgenden Kriterien erfüllt sein. Die Instanz muss aus mindestens zwei Punkten gebildet werden, oder sie muss leer sein. Die folgenden LineString-Instanzen werden akzeptiert.

DECLARE @g1 geometry = 'LINESTRING EMPTY';
DECLARE @g2 geometry = 'LINESTRING(1 1,2 3,4 8, -6 3)';
DECLARE @g3 geometry = 'LINESTRING(1 1, 1 1)';

@g3 zeigt, dass eine LineString-Instanz zwar akzeptiert werden kann, dass sie möglicherweise jedoch nicht gültig ist.

Die folgende LineString-Instanz wird nicht akzeptiert. Sie löst eine System.FormatException aus.

DECLARE @g geometry = 'LINESTRING(1 1)';

Gültige Instanzen

Damit eine LineString-Instanz gültig ist, muss sie die folgenden Kriterien erfüllen.

1. Die LineString-Instanz muss akzeptiert sein.

2. Wenn eine LineString-Instanz nicht leer ist, muss sie mindestens zwei unterschiedliche Punkte enthalten.

3. Die LineString-Instanz kann sich über ein Intervall von zwei oder mehr aufeinanderfolgenden Punkten nicht selbst überschneiden.

Die folgenden LineString-Instanzen sind gültig.

DECLARE @g1 geometry= 'LINESTRING EMPTY';
DECLARE @g2 geometry= 'LINESTRING(1 1, 3 3)';
DECLARE @g3 geometry= 'LINESTRING(1 1, 3 3, 2 4, 2 0)';
DECLARE @g4 geometry= 'LINESTRING(1 1, 3 3, 2 4, 2 0, 1 1)';
SELECT @g1.STIsValid(), @g2.STIsValid(), @g3.STIsValid(), @g4.STIsValid();

Die folgenden LineString-Instanzen sind nicht gültig.

DECLARE @g1 geometry = 'LINESTRING(1 4, 3 4, 2 4, 2 0)';
DECLARE @g2 geometry = 'LINESTRING(1 1, 1 1)';
SELECT @g1.STIsValid(), @g2.STIsValid();

Vorsicht
Die Erkennung von LineString-Überschneidungen basiert auf Gleitkommaberechnungen, die nicht genau sind.

Beispiele

Das folgende Beispiel zeigt, wie eine geometry LineString-Instanz aus drei Punkten und mit einem SRID von 0 (null) erstellt wird:

DECLARE @g geometry;
SET @g = geometry::STGeomFromText('LINESTRING(1 1, 2 4, 3 9)', 0);

Jeder Punkt in der LineString-Instanz kann Z- (Erweiterung) und M-Werte (Measure) enthalten. In diesem Beispiel werden M-Werte zur LineString-Instanz hinzugefügt, die im Beispiel weiter oben erstellt wurde. M und Z können NULL-Werte sein.

DECLARE @g geometry;
SET @g = geometry::STGeomFromText('LINESTRING(1 1 NULL 0, 2 4 NULL 12.3, 3 9 NULL 24.5)', 0);

Im folgenden Beispiel wird veranschaulicht, wie eine geometry LineString-Instanz mit zwei Punkten erstellt wird, die identisch sind. Ein Aufruf von IsValid gibt an, dass die LineString-Instanz nicht gültig ist, und durch einen Aufruf von MakeValid wird die LineString-Instanz in einen Point konvertiert.

DECLARE @g geometry
SET @g = geometry::STGeomFromText('LINESTRING(1 3, 1 3)',0);
IF @g.STIsValid() = 1
  BEGIN
     SELECT @g.ToString() + ' is a valid LineString.';  
  END
ELSE
  BEGIN
     SELECT @g.ToString() + ' is not a valid LineString.';
     SET @g = @g.MakeValid();
     SELECT @g.ToString() + ' is a valid Point.';  
  END

Der obige Codeausschnitt gibt Folgendes zurück:

LINESTRING(1 3, 1 3) is not a valid LineString
POINT(1 3) is a valid Point.

Siehe auch

Verweis

STLength (geometry-Datentyp)

STStartPoint (geometry-Datentyp)

STEndpoint (geometry-Datentyp)

STPointN (geometry-Datentyp)

STNumPoints (geometry-Datentyp)

STIsRing (geometry-Datentyp)

STIsClosed (geometry-Datentyp)

STPointOnSurface (geometry-Datentyp)

Konzepte

Räumliche Daten (SQL Server)