Partilhar via


Construindo instâncias de geografia

É possível construir instâncias do tipo de dados de geografia inserindo dados no formato WKT (Well-Known Text) ou WKB (Well-Known Binary).

Construindo uma instância usando entrada WKT (Well-Known Text)

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

Para construir uma instância de Point de geografia de entrada WKT

Para construir uma instância de MultiPoint de geografia de entrada WKT

Para construir uma instância de LineString de geografia de entrada WKT

Para construir uma instância de MultiLineString de geografia de entrada WKT

Para construir uma instância de Polygon de geografia de entrada WKT

Para construir uma instância de MultiPolygon de geografia de entrada WKT

Para construir uma instância de GeometryCollection de geografia de entrada WKT

Construindo uma instância usando entrada WKB (Well-Known Binary)

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

Para construir uma instância de Point de geografia de entrada WKB

Para construir uma instância de MultiPoint de geografia de entrada WKB

Para construir uma instância de LineString de geografia de entrada WKB

Para construir uma instância de MultiLineString de geografia de entrada WKB

Para construir uma instância de Polygon de geografia de entrada WKB

Para construir uma instância de MultiPolygon de geografia de entrada WKB

Para construir uma instância de GeometryCollection de geografia de entrada WKB

Construindo uma instância usando entrada de texto de GML

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

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

Para construir qualquer tipo de instância de geografia de entrada de GML

GeomFromGML (tipo de dados geography)

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

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

To return the WKT representation of a geography instance

STAsText (tipo de dados geography)

ToString (tipo de dados geography)

To return the WKT representation of a geography instance including any Z and M values

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 informações de GEOMETRYCOLLECTION e de tipo de instância

Quando uma instância de geography é construída, é possível usar os seguintes métodos para retornar o tipo da instância ou, se ela for uma instância de GeometryCollection, retornar uma instância de 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 geometry)

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 de GEOMETRYCOLLECTION

STGeometryN (tipo de dados geography)