Compartilhar via


Análise (tipo de dados geográficos)

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). Parse() é equivalente a STGeomFromText (geography Data Type), exceto que ele assume um ID de referência espacial (SRID) de 4326 como parâmetro. A entrada pode conter valores opcionais Z (elevação) e M (medida).

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

Sintaxe

Parse ( 'geography_tagged_text' )

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 geografia a ser retornada. geography_tagged_text é nvarchar(max).

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 Parse() é definido como a entrada de WKT correspondente.

A cadeia de caracteres 'Null' é interpretada como uma instância de geografia nula.

Esse método é ArgumentException lançado se a entrada contiver uma borda antípoda.

Exemplos

O exemplo a seguir usa Parse() 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::Parse('LINESTRING(-122.360 47.656, -122.343 47.656)');
SELECT @g.ToString();