Partilhar via


STGeomFromText (tipo de dados geography)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Banco de Dados SQL no Microsoft Fabric

Retorna uma instância de geography de uma representação WKT (Well-Known Text) do OGC (Open Geospatial Consortium) aumentada com valores Z (elevação) e M (medida) presentes na instância.

Esse método de tipo de dados geography dá suporte a FullGlobe instâncias ou instâncias espaciais maiores que um hemisfério.

Sintaxe

STGeomFromText ( 'geography_tagged_text' , SRID )

Argumentos

geography_tagged_text

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

SRID

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

Tipos de retorno

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

Comentários

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

Esse método lança um ArgumentException if a entrada contiver uma aresta antípoda.

Observação

A ordem na qual os pontos são listados importa para polígonos de geografia. Ela determina se a área do polígono está dentro ou fora do anel determinado. Para obter mais informações, consulte Polígono.

Exemplos

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

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