Partilhar via


STPointN (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 o ponto especificado em uma instância de geography.

Sintaxe

  
.STPointN ( expression )  

Argumentos

expressão
É uma expressão int entre 1 e o número de pontos na instância de geography.

Tipos de retorno

Tipo de retorno do SQL Server: geography

Tipo de retorno do CLR: SqlGeography

Tipo do OGC (Open Geospatial Consortium): Point

Comentários

Se uma instância de geography for criada pelo usuário, STPointN() retornará o ponto especificado pela expressão ordenando os pontos pela ordem de entrada original.

Se uma instância de geography for construída pelo sistema, STPointN() retornará o ponto especificado pela expressão ordenando os pontos na mesma ordem em que eles seriam emitidos: primeiro pela instância de geography, depois pelo anel na instância (se apropriado) e, em seguida, pelo ponto dentro do anel. Essa ordem é determinística.

Se esse método for chamado com um valor menor que 1, ele gerará uma ArgumentOutOfRangeException.

Se esse método for chamado com um valor maior que o número de pontos na instância, retornará nulo.

Exemplos

O exemplo a seguir cria uma instância LineString e usa STPointN() para recuperar o segundo o ponto na descrição da instância.

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

Consulte Também

Métodos do OGC em instâncias de geography