STGeomFromText (tipo de dados geography)

  • Artigo

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstâ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 os valores de Z (elevação) e de M (medida) presentes na instância.

Esse método de tipo de dados de geography é compatível com instâncias FullGlobe ou instâncias espaciais maiores que um hemisfério.

Sintaxe

  
STGeomFromText ( 'geography_tagged_text' , SRID )

Observação

Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.

Argumentos

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

SRID
É uma expressão int que representa a SRID (ID de referência espacial) da instância de geography que você deseja retornar.

Tipos de retorno

Tipo de retorno do SQL Server: geography

Tipo de retorno do 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 gerará uma ArgumentException se a entrada contiver uma borda oposta.

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. Confiar Polígono para obter mais informações.

Exemplos

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

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

Consulte Também

OGC Static Geography Methods