STPointN (тип данных geography)

  • Статья

Применимо к:SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure

Возвращает указанную точку в экземпляре geography.

Синтаксис

  
.STPointN ( expression )

Примечание.

Сведения о синтаксисе Transact-SQL для SQL Server 2014 (12.x) и более ранних версиях см . в документации по предыдущим версиям.

Аргументы

выражение
Выражение типа int со значением в диапазоне от 1 до числа точек в экземпляре geography.

Типы возвращаемых данных

Тип возвращаемого значения SQL Server: geography

Тип возвращаемых данных CLR: SqlGeography

Тип открытого геопространственного консорциума (OGC): Point

Замечания

Если экземпляр geography создан пользователем, то метод STPointN() возвращает точку, указанную expression путем размещения точек в порядке, в котором они были первоначально введены.

Если экземпляр geography формируется системой, метод STPointN() возвращает точку, указанную expression путем упорядочения всех точек в той последовательности, в которой они должны быть выведены: сначала по экземпляру geography, затем по кольцу в пределах экземпляра (если это применимо), после чего по точкам кольца. Это порядок является детерминированным.

Если этот метод вызывается со значением менее 1, то будет вызвано исключение ArgumentOutOfRangeException.

Если этот метод вызывается со значением, превышающим число точек в экземпляре, он возвращает значение NULL.

Примеры

В следующем примере создается экземпляр LineString, и при помощи метода STPointN() производится получение второй точки в его описании.

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

См. также

Методы OGC в экземплярах Geography