Point

Artigo
07/15/2024

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

Em dados espaciais do SQL Server, um ponto é um objeto de dimensão 0 que representa um único local e pode conter valores Z (elevação) e M (medida).

Tipo de dados de geografia

O tipo de Ponto para o tipo de dados geography representa um único local em que Lat representa latitude e Long representa longitude. Os valores de latitude e longitude são medidos em graus. Valores para latitude sempre estão no intervalo [-90, 90] e os valores inseridos fora desse intervalo gerarão uma exceção. Os valores de longitude estão sempre no intervalo (-180, 180]; e os valores inseridos fora desse intervalo são ajustados para caberem nesse intervalo. Por exemplo, se 190 for inserido para longitude, ele será ajustado para o valor -170. SRID representa a ID de referência espacial da instância geography que você deseja retornar.

Tipo de dados geometry

O tipo de Ponto para o tipo de dados geometry representa um único local onde X representa a coordenada X do Ponto que é gerado e Y representa a coordenada de Y do Ponto que é gerado. SRID representa a ID de referência espacial da instância geometry que você deseja retornar.

Exemplos

Exemplo A.

O exemplo a seguir cria uma instância de Ponto de geometria que representa o ponto (3, 4) com um SRID de 0.

DECLARE @g geometry;  
SET @g = geometry::STGeomFromText('POINT (3 4)', 0);

Exemplo B.

O exemplo a seguir cria uma instância de Ponto de geometria que representa o ponto (3, 4) com um valor Z (elevação) de 7, um valor M (medida) de 2,5 e o SRID padrão de 0.

DECLARE @g geometry;  
SET @g = geometry::Parse('POINT(3 4 7 2.5)');

Exemplo C.

O exemplo a seguir retorna os valores X, Y, Z e M para a instância de Ponto de geometria.

SELECT @g.STX;  
SELECT @g.STY;  
SELECT @g.Z;  
SELECT @g.M;

Exemplo D.

Podem ser especificados valores Z e M como NULL, conforme mostrado no exemplo a seguir.

DECLARE @g geometry;  
SET @g = geometry::Parse('POINT(3 4 NULL NULL)');

Confira também

MultiPoint
STX (tipo de dados geometry)
STY (tipo de dados geometry)
Dados espaciais (SQL Server)

Compartilhar via