STPointN (tipo de dados geography)
Retorna o ponto especificado em uma instância de geography.
Sintaxe
.STPointN ( expression )
Argumentos
- expression
É 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: geographygeography
Tipo de retorno CLR: SqlGeographySqlGeography
Tipo OGC (Open Geospatial Consortium): PointPoint
Comentários
Se uma instância de geography for criada pelo usuário, STPointN() retornará o ponto especificado por expression ordenando os pontos pela ordem de sua entrada original.
Se uma instância de geography for construída pelo sistema, STPointN() retornará o ponto especificado por expression ordenando os pontos na mesma ordem de saída: primeiro por 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, lançará 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 de 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();