STGeomFromText (географический тип данных)

  • Статья

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

Возвращает экземпляр geography из WKT-представления открытого геопространственного консорциума (OGC) вместе со значениями Z (высота) и M (мера), сопровождающими экземпляр.

Этот метод типа данных geography поддерживает экземпляры FullGlobe или пространственные экземпляры, размер которых больше полушария.

Синтаксис

  
STGeomFromText ( 'geography_tagged_text' , SRID )

Примечание.

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

Аргументы

geography_tagged_text
WKT-представление возвращаемого экземпляра geography. geography_tagged_text является выражением типа nvarchar(max).

SRID
Выражение типа int, представляющее идентификатор пространственной ссылки (SRID) возвращаемого экземпляра geography.

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

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

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

Замечания

Тип OGC экземпляра geography, возвращаемый методом STGeomFromText(), получает значение в зависимости от соответствующих входных данных WKT.

Этот метод вызывает исключение ArgumentException, если входные данные содержат противоположную границу.

Примечание.

Порядок, в котором указаны точки, имеет значение для географических многоугольников. Он определяет, находится ли область многоугольника внутри или за пределами данного кольца. Дополнительные сведения см. в разделе Многоугольник.

Примеры

В следующем примере метод STGeomFromText() применяется для создания экземпляра geography.

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

См. также

Статические географические методы OGC