STPointN (тип данных geography)
Область применения: SQL Server
База данных SQL Azure
Управляемый экземпляр SQL Azure
базе данных SQL в Microsoft Fabric
Возвращает указанную точку в экземпляре geography.
Синтаксис
.STPointN ( expression )
Аргументы
выражение
Выражение типа 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();