STPointN (typ danych geograficznych)

Dotyczy:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBaza danych SQL w usłudze Microsoft Fabric

Zwraca określony punkt w wystąpieniu geograficznym .

Syntax

  
.STPointN ( expression )  

Arguments

expression
Jest wyrażeniem int z zakresu od 1 do liczby punktów w wystąpieniu geografii .

Typy zwracane

Typ zwracany programu SQL Server: lokalizacja geograficzna

Typ zwracany CLR: SqlGeography

Typ open Geospatial Consortium (OGC): Punkt

Remarks

Jeśli wystąpienie geograficzne jest tworzone przez użytkownika, funkcja STPointN() zwraca punkt określony przez wyrażenie , porządkując punkty w kolejności, w której zostały pierwotnie wprowadzone.

Jeśli wystąpienie geograficzne jest konstruowane przez system, funkcja STPointN() zwraca punkt określony przez wyrażenie , porządkując wszystkie punkty w tej samej kolejności, w której będą one wyjściowe: najpierw według wystąpienia geograficznego , a następnie przez pierścień w wystąpieniu (jeśli jest to konieczne), a następnie przez punkt w pierścieniu. Ta kolejność jest deterministyczna.

Jeśli ta metoda jest wywoływana z wartością mniejszą niż 1, zgłasza wyjątek ArgumentOutOfRangeException.

Jeśli ta metoda jest wywoływana z wartością większą niż liczba punktów w wystąpieniu, zwraca wartość null.

Examples

Poniższy przykład tworzy LineString wystąpienie i używa STPointN() go do pobrania drugiego punktu w opisie wystąpienia.

DECLARE @g geography;  
SET @g = geography::STGeomFromText('LINESTRING(-122.360 47.656, -122.343 47.656)', 4326);  
SELECT @g.STPointN(2).ToString();  

Zobacz też

Metody OGC w wystąpieniach geograficznych