Compartilhar via

STGeomFromText (tipo de dados geography)

  • Artigo

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

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

Conteúdo relacionado