Criar, construir e consultar instâncias de geografia

O tipo de dados espacial de geografia, geography, representa dados em um sistema de coordenadas de terra redonda. Este tipo é implementado como um tipo de dados CLR (Common Language Runtime) .NET no SQL Server. O tipo de dados SQL Server geography armazena dados elipsoidais (terra redonda), como coordenadas de latitude e longitude 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 de 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 Open Geospatial Consortium (OGC). 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 de geografia)

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

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 de 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 geography)STGeomCollFromWKB (tipo de dados geography)

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

O geography tipo de dados fornece um método que gera uma geography instância de GML, uma representação XML de uma geography instância. 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 de 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 geography instâncias têm várias propriedades que podem ser recuperadas por meio de métodos que SQL Server fornece. 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

Depois que uma geography instância é construída, você pode usar os métodos a seguir para retornar o tipo de instância ou, se for uma GeometryCollection instância, retornar uma instância específica geography .

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 geography)STGeometryN (tipo de dados geography)

Número de pontos

Todas as instâncias não geography vazias são compostas por pontos. Esses pontos representam as coordenadas de latitude e longitude da terra nas quais as instâncias de 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 unidimensionais geography , como Point e MultiPoint, não têm comprimento ou área. Objetos unidimensionais, como LineString, CircularString, CompoundCurve e MultiLineString, têm comprimento. Instâncias bidimensionais, como Polygon, CurvePolygon, e 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 vaziageography não tem pontos. O comprimento de instâncias de LineString, CircularString, CompoundCurve e MultiLineString vazias é 0. A área de 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 fechadageography é uma figura cujos pontos de partida e pontos de extremidade são os mesmos. As instâncias Polygon são consideradas fechadas. As instâncias Point 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 ID de referência espacial (SRID) é 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

SQL Server dá suporte a SRIDs baseadas nos padrões do EPSG. Um SRID com suporte SQL Server para geography instâncias deve ser usado ao executar 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 de geography, os resultados dependerão de qual elipsoide foi usado na criação dos dados, pois cada elipsoide recebe um SRID ( spatial reference identifier) específico.

SQL Server usa o SRID padrão de 4326, que é mapeado para o sistema de referência espacial WGS 84, ao usar métodos em geography instâncias. 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.

• O primeiro exemplo cria uma tabela com uma coluna de identidade e uma coluna de geographyGeogCol1. 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  
  

• O segundo exemplo usa o método STIntersection() para retornar os pontos onde 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();  
  

Consulte Também

Dados espaciais (SQL Server)