Criar, construir e consultar instâncias de geografia

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do Azure

O tipo de dados espacial de geografia, geography, representa dados em um sistema de coordenadas de terra redonda. Esse tipo é implementado como um tipo de dados CLR (Common Language Runtime) .NET no SQL Server. O tipo de dados geography do SQL Server armazena dados elipsoidais (terra redonda), como coordenadas de latitude e longitude de GPS.

O tipo geography é predefinido e está disponível em cada banco de dados. É possível criar colunas de tabelas do tipo geography e operar em dados de geography da mesma maneira como outros tipos fornecidos pelo sistema são usados.

Criando ou construindo uma nova instância de geografia

Criando uma nova instância de geografia de uma instância existente

O tipo de dados geography fornece vários métodos internos que podem ser usados para criar novas instâncias geography baseadas em instâncias existentes.

Para criar um buffer em torno de uma geografia
STBuffer (tipo de dados geography)

Para criar um buffer em torno de uma geografia, permitindo uma tolerância
BufferWithTolerance (tipo de dados geography)

Para criar uma geografia da interseção de duas instâncias de geografia
STIntersection (tipo de dados geography)

Para criar uma geografia da união de duas instâncias de geografia
STUnion (tipo de dados geography)

Para criar uma geografia dos pontos onde uma geografia não sobrepõe outra
STDifference (tipo de dados geography)

Construindo uma instância de geografia da entrada de texto conhecida

O tipo de dados de geography fornece vários métodos internos que geram uma geografia da representação WKT do OGC (Open Geospatial Consortium). O padrão WKT é uma cadeia de caracteres de texto que permite que dados de geografia sejam trocados em formulário textual.

Para construir qualquer tipo de instância de geografia de entrada WKT
STGeomFromText (tipo de dados geography)

Parse (tipo de dados geography)

Para construir uma instância de Point de geografia de entrada WKT
STPointFromText (tipo de dados geography)

Para construir uma instância de MultiPoint de geografia de entrada WKT
STMPointFromText (tipo de dados geography)

Para construir uma instância de LineString de geografia de entrada WKT
STLineFromText (tipo de dados geography)

Para construir uma instância de MultiLineString de geografia de entrada WKT
STMLineFromText (tipo de dados geography)

Para construir uma instância de Polygon de geografia de entrada WKT
STPolyFromText (tipo de dados geography)

Para construir uma instância de MultiPolygon de geografia de entrada WKT
STMPolyFromText (tipo de dados geography)

Para construir uma instância de GeometryCollection de geografia de entrada WKT
STGeomCollFromText (tipo de dados geography)

Construindo uma instância de geografia da entrada binária conhecida

WKB é um formato binário especificado pelo OGC que permite que dados Geography sejam trocados entre um aplicativo cliente e um banco de dados SQL. As seguintes funções aceitam entrada WKB para construir instâncias de geografia:

Para construir qualquer tipo de instância de geografia de entrada WKB
STGeomFromWKB (tipo de dados geography)

Para construir uma instância de Point de geografia de entrada WKB
STPointFromWKB (tipo de dados geography)

Para construir uma instância de MultiPoint de geografia de entrada WKB
STMPointFromWKB (tipo de dados geography)

Para construir uma instância de LineString de geografia de entrada WKB
STLineFromWKB (tipo de dados geography)

Para construir uma instância de MultiLineString de geografia de entrada WKB
STMLineFromWKB (tipo de dados geography)

Para construir uma instância de Polygon de geografia de entrada WKB
STPolyFromWKB (tipo de dados geography)

Para construir uma instância de MultiPolygon de geografia de entrada WKB
STMPolyFromWKB (tipo de dados geography)

Para construir uma instância de GeometryCollection de geografia de entrada WKB
STGeomCollFromWKB (Tipo de Dados de geografia) STGeomCollFromWKB (Tipo de Dados de geografia)

Construindo uma instância de geografia de entrada de texto GML

O tipo de dados geography oferece um método que gera uma instância geography de GML, uma representação XML de uma instância geography . O SQL Server oferece suporte a um subconjunto de GML.

Para obter mais informações sobre Geography Markup Language, veja a Especificação do OGC: OGC Specifications, Geography Markup Language.

Para construir qualquer tipo de instância de geografia de entrada GML
GeomFromGML (tipo de dados geography)

Retornando Well-Known Text e Well-Known Binary de uma instância de geografia

É possível usar os seguintes métodos para retornar o formato WKT ou WKB de uma instância geography :

Para retornar a representação WKT de uma instância de geografia
STAsText (tipo de dados geography)

ToString (tipo de dados geography)

Para retornar a representação WKT de uma instância de geometria incluindo qualquer valor Z e M
AsTextZM (tipo de dados geography)

Para retornar a representação WKB de uma instância de geografia
STAsBinary (tipo de dados geography)

Para retornar a representação GML de uma instância de geografia
AsGml (tipo de dados geography)

Consultando as propriedades e comportamentos de instâncias de geografia

Todas as instâncias de geografia têm várias propriedades que podem ser recuperadas por meio de métodos fornecidos pelo SQL Server. Os tópicos a seguir definem as propriedades e comportamentos de tipos de geografia e os métodos de consulta de cada um.

Informações de validade, tipo de instância e GeometryCollection

Quando uma instância geography é construída, é possível usar os seguintes métodos para retornar o tipo da instância ou, caso ela seja uma instância GeometryCollection , retornar uma instância geography específica.

Para retornar o tipo de instância de uma geografia
STGeometryType (tipo de dados geography)

Para determinar se uma geografia é um determinado tipo de instância
InstanceOf (tipo de dados geography)

Para determinar se uma instância de geografia é bem formada para seu tipo de instância
STNumGeometries (tipo de dados geography)

Para retornar uma geografia específica em uma instância GeometryCollection
STGeometryN (Tipo de Dados de geografia) STGeometryN (Tipo de Dados de geografia)

Número de Pontos

Todas as instâncias de geography não vazias são compostas por pontos. Esses pontos representam as coordenadas de latitude e longitude da terra nas quais as instâncias geography são obtidas. O tipo de dados geography fornece vários métodos internos de consulta de pontos de uma instância.

Para retornar o número de pontos que compõem uma instância
STNumPoints (tipo de dados geography)

Para retornar um ponto específico em uma instância
STPointN (tipo de dados geometry)

Para retornar o ponto inicial de uma instância
STStartPoint (tipo de dados geography)

Para retornar o ponto de extremidade de uma instância
STEndpoint (tipo de dados geography)

Dimensão

Uma instância geography não vazia pode ser zero, uni ou bidimensional. Instâncias geography com dimensional zero, como Point e MultiPoint, não têm comprimento nem área. Objetos unidimensionais, como LineString, CircularString, CompoundCurvee MultiLineString, têm comprimento. Instâncias bidimensionais, como Polygon, CurvePolygone MultiPolygon, têm área e comprimento. Instâncias vazias relatam uma dimensão de -1 e uma GeometryCollection relata a dimensão máxima de seu conteúdo.

Para retornar a dimensão de uma instância
STDimension (tipo de dados geography)

Para retornar o comprimento de uma instância
STLength (tipo de dados geography)

Para retornar a área de uma instância
STArea (tipo de dados geography)

Vazio

Uma instância emptygeography não tem pontos. O tamanho de instâncias LineString, CircularString, CompoundCurvee MultiLineString é 0. A área das instâncias Polygon, CurvePolygon e MultiPolygon vazias é 0.

Para determinar se uma instância está vazia
STIsEmpty (tipo de dados geography)

Fechamento

Uma instância closedgeography é uma figura cujos pontos inicial e final são os mesmos. As instânciasPolygon são consideradas fechadas. As instânciasPoint não estão fechadas.

Um anel é uma instância de LineString simples e fechada.

Para determinar se uma instância está fechada
STIsClosed (tipo de dados geography)

Para retornar o número de anéis em uma instância de Polígono
NumRings (tipo de dados geography)

Para retornar um anel especificado de uma instância de geografia
RingN (tipo de dados geography)

SRID (Spatial Reference ID)

A SRID (ID de referência espacial) é um identificador que especifica o sistema de coordenadas elipsoidais no qual a instância geography é representada. Duas instâncias geography com SRIDs diferentes não podem ser comparadas.

Para definir ou retornar o SRID de uma instância
STSrid (tipo de dados geography)

Essa propriedade pode ser modificada.

Determinando relações entre instâncias de geografia

O tipo de dados geography fornece vários métodos internos que podem ser usados para determinar relações entre duas instâncias de geography .

Para determinar se duas instâncias abrangem o mesmo conjunto de pontos
STEquals (tipo de dados geometry)

Para determinar se duas instâncias são não contíguas
STDisjoint (tipo de dados geometry)

Para determinar se há interseção entre duas instâncias
STIntersects (tipo de dados geometry)

Para determinar o ponto ou pontos de interseção de duas instâncias
STIntersection (tipo de dados geography)

Para determinar a distância mais curta entre pontos em duas instâncias de geografia
STDistance (tipo de dados geometry)

Para determinar a diferença em pontos entre duas instâncias de geografia
STDifference (tipo de dados geography)

Para derivar a diferença simétrica ou pontos exclusivos de uma instância de geografia comparada com outra instância
STSymDifference (tipo de dados geography)

Instâncias de geografia devem usar SRID com suporte

O SQL Server oferece suporte a SRIDs com base nos padrões EPSG. Um SRID compatível com o SQL Server para instâncias de geografia deve ser usado ao realizar cálculos ou usar métodos com dados espaciais de geografia. A SRID deve corresponder a uma das SRIDs exibidos na exibição de catálogo sys.spatial_reference_systems . Conforme mencionado anteriormente, ao executar cálculos nos dados espaciais usando o tipo de dados geography , os resultados dependerão de qual elipsoide foi usado na criação dos dados, pois cada elipsoide recebe um SRID (identificador de referência espacial) específico.

O SQL Server usa o SRID padrão de 4326, que mapeia para o sistema de referência espacial WGS 84, ao usar métodos em instâncias de geografia. Se você usar dados de um sistema de referência espacial diferente de WGS 84 (ou SRID 4326), será necessário determinar o SRID específico de seus dados espaciais de geografia.

Exemplos

Os exemplos a seguir mostram como adicionar e consultar dados de geografia.

Exemplo A.

Este exemplo cria uma tabela com uma coluna de identidade e uma coluna de geography, GeogCol1. Uma terceira coluna renderiza a coluna de geography em sua representação WKT (Well-Known Text) do Open Geospatial Consortium (OGC) e usa o método STAsText() . Em seguida, duas linhas são inseridas: uma linha que contém uma instância LineString de geographye uma linha que contém uma instância de Polygon .

IF OBJECT_ID ( 'dbo.SpatialTable', 'U' ) IS NOT NULL   
DROP TABLE dbo.SpatialTable;  
GO  
  
CREATE TABLE SpatialTable   
  ( id int IDENTITY (1,1),  
    GeogCol1 geography,   
    GeogCol2 AS GeogCol1.STAsText()
   );  
GO  
  
INSERT INTO SpatialTable (GeogCol1)  
VALUES (geography::STGeomFromText('LINESTRING(-122.360 47.656, -122.343 47.656)', 4326));  
  
INSERT INTO SpatialTable (GeogCol1)  
VALUES (geography::STGeomFromText('POLYGON((-122.358 47.653, -122.348 47.649, -122.348 47.658, -122.358 47.658, -122.358 47.653))', 4326));  
GO  

Exemplo B.

Este exemplo usa o método STIntersection() para retornar os pontos em que as duas instâncias de geography inseridas anteriormente se cruzam.

DECLARE @geog1 geography;  
DECLARE @geog2 geography;  
DECLARE @result geography;  
  
SELECT @geog1 = GeogCol1 FROM SpatialTable WHERE id = 1;  
SELECT @geog2 = GeogCol1 FROM SpatialTable WHERE id = 2;  
SELECT @result = @geog1.STIntersection(@geog2);  
SELECT @result.STAsText();  

Confira também

Dados espaciais (SQL Server)