• Article

SqlGeography Class

The SqlGeography type represents data in a geodetic (round earth) coordinate system.

Inheritance Hierarchy

System.Object
  Microsoft.SqlServer.Types.SqlGeography

Namespace:  Microsoft.SqlServer.Types
Assembly:  Microsoft.SqlServer.Types (in Microsoft.SqlServer.Types.dll)

Syntax

'Declaration
<SerializableAttribute> _
<CLSCompliantAttribute(True)> _
<SqlUserDefinedTypeAttribute(Format.UserDefined, IsByteOrdered := False,  _
    MaxByteSize := , IsFixedLength := False)> _
Public NotInheritable Class SqlGeography _
    Implements INullable, IBinarySerialize
'Usage
Dim instance As SqlGeography

[SerializableAttribute]
[CLSCompliantAttribute(true)]
[SqlUserDefinedTypeAttribute(Format.UserDefined, IsByteOrdered = false, 
    MaxByteSize = , IsFixedLength = false)]
public sealed class SqlGeography : INullable, 
    IBinarySerialize

[SerializableAttribute]
[CLSCompliantAttribute(true)]
[SqlUserDefinedTypeAttribute(Format::UserDefined, IsByteOrdered = false, 
    MaxByteSize = , IsFixedLength = false)]
public ref class SqlGeography sealed : INullable, 
    IBinarySerialize

[<SealedAttribute>]
[<SerializableAttribute>]
[<CLSCompliantAttribute(true)>]
[<SqlUserDefinedTypeAttribute(Format.UserDefined, IsByteOrdered = false, 
    MaxByteSize = , IsFixedLength = false)>]
type SqlGeography =  
    class
        interface INullable
        interface IBinarySerialize
    end

public final class SqlGeography implements INullable, IBinarySerialize

The SqlGeography type exposes the following members.

Constructors

  Name Description
Public method SqlGeography Initializes a new instance of the SqlGeography class.

Top

Properties

  Name Description
Public property IsNull Determines whether the SqlGeography instance is null.
Public property Lat Returns the latitude property of the geography instance.
Public property Long Returns the longitude property of the geography instance.
Public property M Returns the M (measure) value of the geography instance.
Public propertyStatic member Null Returns a read-only property providing a null instance of the SqlGeography type.
Public property STSrid Gets or sets id is an integer representing the Spatial Reference Identifier (SRID) of the instance.
Public property Z Gets the Z (elevation) value of the instance. The semantics of the elevation value are user-defined.

Top

Methods

  Name Description
Public method AsGml Returns the Geography Markup Language (GML) representation of a SqlGeography instance.
Public method AsTextZM Returns the Open Geospatial Consortium (OGC) Well-Known Text (WKT) representation of a SqlGeography instance augmented with any Z (elevation) and M (measure) values carried by the instance.
Public method BufferWithTolerance Returns a geometric object representing the union of all point values whose distance from a SqlGeography instance is less than or equal to a specified value, allowing for a specified tolerance.
Public method EnvelopeAngle Returns the maximum angle between the point returned by the EnvelopeCenter method and a point in the geography instance in degrees.
Public method EnvelopeCenter Returns a point that can be used as the center of a bounding circle for the geography instance.
Public method Equals (Inherited from Object.)
Public method Filter Offers a fast, index-only intersection method to determine if a geography instance intersects another SqlGeography instance, assuming an index is available.
Protected method Finalize (Inherited from Object.)
Public methodStatic member GeomFromGml Constructs a SqlGeography instance given a representation in the SQL Server subset of the Geography Markup Language (GML).
Public method GetHashCode (Inherited from Object.)
Public method GetType (Inherited from Object.)
Public method InstanceOf Tests if the SqlGeography instance is the same as the specified type.
Protected method MemberwiseClone (Inherited from Object.)
Public method NumRings Returns the total number of rings in a Polygon instance.
Public methodStatic member Parse Returns a SqlGeography instance from an Open Geospatial Consortium (OGC) Well-Known Text (WKT) representation.
Public methodStatic member Point Constructs a SqlGeography instance representing a Point instance from its x and y values and a spatial reference ID (SRID).
Public method Populate Applies a geography type call sequence to IGeographySink object. The call sequence is a set of figures, lines, and points for geography types.
Public method Read Reads a binary representation of a geography type into a SqlGeometry object.
Public method Reduce Returns an approximation of the given geography instance produced by running the Douglas-Peucker algorithm on the instance with the given tolerance.
Public method RingN Returns the specified ring of the SqlGeography instance: 1 ≤ n ≤ NumRings().
Public method STArea Returns the total surface area of a SqlGeography instance.
Public method STAsBinary Returns the Open Geospatial Consortium (OGC) Well-Known Binary (WKB) representation of a SqlGeography instance.
Public method STAsText Returns the Open Geospatial Consortium (OGC) Well-Known Text (WKT) representation of a SqlGeography instance.
Public method STBuffer Returns a geography object that represents the union of all points whose distance from a SqlGeography instance is less than or equal to a specified value.
Public method STDifference Returns an object representing the points from one SqlGeography instance that do not lie within another SqlGeography instance.
Public method STDimension Returns the maximum dimension of a SqlGeography instance
Public method STDisjoint Determines whether the calling SqlGeography instance is spatially disjoint from the specified SqlGeography instance.
Public method STDistance Returns the shortest distance between a point in a SqlGeography instance and a point in another SqlGeography instance.
Public method STEndPoint Returns the end point of a SqlGeography instance.
Public method STEquals Determines whether the specified SqlGeography instance has the same point set as the calling SqlGeography instance.
Public methodStatic member STGeomCollFromText Returns a geography instance from an Open Geospatial Consortium (OGC) Well-Known Text (WKT) representation, augmented with any Z (elevation) and M (measure) values carried by the instance.
Public methodStatic member STGeomCollFromWKB Returns a GeometryCollection instance from an Open Geospatial Consortium (OGC) Well-Known Binary (WKB) representation.
Public method STGeometryN Returns a specified geography element in a GeometryCollection or one of its subtypes.
Public method STGeometryType Returns the Open Geospatial Consortium (OGC) type name represented by a geography instance.
Public methodStatic member STGeomFromText Returns a SqlGeography instance from an Open Geospatial Consortium (OGC) Well-Known Text (WKT) representation augmented with any Z (elevation) and M (measure) values carried by the instance.
Public methodStatic member STGeomFromWKB Returns a SqlGeography instance from an Open Geospatial Consortium (OGC) Well-Known Binary (WKB) representation.
Public method STIntersection Returns an object representing the points where a SqlGeography instance intersects another SqlGeography instance.
Public method STIntersects Determines whether the current SqlGeography instance intersects with the specified SqlGeography.
Public method STIsClosed Determines whether the calling SqlGeography instance is closed.
Public method STIsEmpty Determines whether the SqlGeography instance is empty.
Public method STLength Returns the total length of the elements in a SqlGeography instance or the SqlGeography instances within a GeometryCollection.
Public methodStatic member STLineFromText Returns a SqlGeography instance from an Open Geospatial Consortium (OGC) Well-Known Text (WKT) representation, augmented with any Z (elevation) and M (measure) values carried by the instance.
Public methodStatic member STLineFromWKB Returns a SqlGeography instance from an Open Geospatial Consortium (OGC) Well-Known Text (WKT) representation, augmented with any Z (elevation) and M (measure) values carried by the instance.
Public methodStatic member STMLineFromText Returns a SqlGeography instance from an Open Geospatial Consortium (OGC) Well-Known Text (WKT) representation, augmented with any Z (elevation) and M (measure) values carried by the instance.
Public methodStatic member STMLineFromWKB Returns a SqlGeography MultiLineString instance from an Open Geospatial Consortium (OGC) Well-Known Binary (WKB) representation.
Public methodStatic member STMPointFromText Returns a SqlGeography instance from an Open Geospatial Consortium (OGC) Well-Known Text (WKT) representation, augmented with any Z (elevation) and M (measure) values carried by the instance.
Public methodStatic member STMPointFromWKB Returns a SqlGeography MultiPoint instance from an Open Geospatial Consortium (OGC) Well-Known Binary (WKB) representation.
Public methodStatic member STMPolyFromText Returns a SqlGeography instance from an Open Geospatial Consortium (OGC) Well-Known Text (WKT) representation, augmented with any Z (elevation) and M (measure) values carried by the instance.
Public methodStatic member STMPolyFromWKB Returns a SqlGeography MultiPolygon instance from an Open Geospatial Consortium (OGC) Well-Known Binary (WKB) representation.
Public method STNumGeometries Returns the number of geometries that make up a SqlGeography instance.
Public method STNumPoints Returns the total number of points in each of the figures in a SqlGeography instance
Public methodStatic member STPointFromText Returns a SqlGeography instance from an Open Geospatial Consortium (OGC) Well-Known Text (WKT) representation, augmented with any Z (elevation) and M (measure) values carried by the instance.
Public methodStatic member STPointFromWKB Returns a SqlGeography Point instance from an Open Geospatial Consortium (OGC) Well-Known Binary (WKB) representation.
Public method STPointN Returns the specified point in a SqlGeography instance.
Public methodStatic member STPolyFromText Returns a SqlGeography instance from an Open Geospatial Consortium (OGC) Well-Known Text (WKT) representation augmented with any Z (elevation) and M (measure) values carried by the instance.
Public methodStatic member STPolyFromWKB Returns a SqlGeography Polygon instance from an Open Geospatial Consortium (OGC) Well-Known Binary (WKB) representation.
Public method STStartPoint Returns the start point of a SqlGeography instance.
Public method STSymDifference Returns an object representing all points that are either in one SqlGeography instance or another SqlGeography instance, but not those points that lie in both instances.
Public method STUnion Returns an object representing the union of a SqlGeography instance with another SqlGeography instance.
Public method ToString Returns the Open Geospatial Consortium (OGC) Well-Known Text (WKT) representation of a SqlGeography instance augmented with any Z (elevation) and M (measure) values carried by the instance. (Overrides Object.ToString().)
Public method Write Writes a SqlGeography object to a binary stream.

Top

Remarks

SQL Server 2008 supports a set of methods for the geography spatial data type. These methods include methods on geography that are defined by the Open Geospatial Consortium (OGC) standard and a set of Microsoft extensions to that standard.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.