Partilhar via


STGeomFromText (tipo de dados geográficos)

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBase de dados SQL no Microsoft Fabric

Retorna uma instância de geografia de um Open Geospatial Consortium (OGC) Well-Known representação Text (WKT) aumentada com quaisquer valores Z (elevação) e M (medida) transportados pela instância.

Este método de tipo de dados geográficos suporta FullGlobe instâncias ou instâncias espaciais que são maiores do que um hemisfério.

Syntax

STGeomFromText ( 'geography_tagged_text' , SRID )

Arguments

geography_tagged_text

A representação WKT da instância geográfica a ser retornada. geography_tagged_text é nvarchar(max).

SRID

Uma expressão int que representa o ID de referência espacial (SRID) da instância geográfica a ser retornada.

Tipos de devolução

  • Tipo de retorno do SQL Server: geografia
  • Tipo de retorno CLR: SqlGeography

Remarks

O tipo OGC da instância de geografia retornada por é definido como STGeomFromText() a entrada WKT correspondente.

Este método lança um ArgumentException se a entrada contém uma borda antipodal.

Note

A ordem em que os pontos são listados importa para polígonos geográficos. Ele determina se a área do polígono está dentro ou fora do anel dado. Para obter mais informações, consulte Polígono.

Examples

O exemplo a seguir usa STGeomFromText() para criar uma instância de geografia .

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();