Поделиться через


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

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

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

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

Синтаксис

STGeomFromText ( 'geography_tagged_text' , SRID )

Примечание.

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

Аргументы

geography_tagged_text

Представление WKT возвращаемого экземпляра географического объекта. geography_tagged_text — nvarchar(max).

SRID

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

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

  • Тип возвращаемого значения SQL Server: geography
  • Тип возвращаемого значения СРЕДЫ CLR: SqlGeography

Замечания

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

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

Примечание.

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

Примеры

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

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