Compartilhar via


Ponto

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

Tipo de dados de geografia

O tipo Point para o tipo de dados de geografia representa um único local onde x e y representam os valores de longitude e latitude, respectivamente. Os valores de longitude e latitude são medidos em graus. Os valores de longitude sempre residem no intervalo (-180, 180] e os valores inseridos fora desse intervalo são delimitados para se ajustarem a nesse intervalo. Por exemplo, se 190 for inserido para longitude, ele será delimitado como o valor -170. Os valores de latitude sempre residem no intervalo [-90, 90] e os valores inseridos fora desse intervalo gerarão uma exceção.

Exemplos

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

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

O próximo exemplo cria uma instância de geometryPoint 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)');

O exemplo final retorna os valores X, Y, Z e M para a instância geometryPoint .

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

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)');