Geocircle Geocircle Geocircle Geocircle Class

Definition

Describes a geographic circle with a center point and a radius.

public : sealed class Geocircle : IGeocircle, IGeoshape
public sealed class Geocircle : IGeocircle, IGeoshape
Public NotInheritable Class Geocircle Implements IGeocircle, IGeoshape
var geocircle = new geocircle(position, radius);
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)
Capabilities
location

Constructors

Geocircle(BasicGeoposition, Double) Geocircle(BasicGeoposition, Double) Geocircle(BasicGeoposition, Double) Geocircle(BasicGeoposition, Double)

Create a geographic circle object for the given position and radius.

public : Geocircle(BasicGeoposition position, double radius)
public Geocircle(BasicGeoposition position, Double radius)
Public Sub New(position As BasicGeoposition, radius As Double)
var geocircle = new geocircle(position, radius);
Parameters
position
BasicGeoposition BasicGeoposition BasicGeoposition BasicGeoposition

The geographic position of the new circle.

radius
double Double Double Double

The radius of the new circle, in meters.

Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)
Capabilities
location

Remarks

The constructor will throw an exception if the provided BasicGeoposition has a latitude is less than -90 or greater than 90 or if the supplied Radius is outside of the allowed range.

Geocircle(BasicGeoposition, Double, AltitudeReferenceSystem) Geocircle(BasicGeoposition, Double, AltitudeReferenceSystem) Geocircle(BasicGeoposition, Double, AltitudeReferenceSystem) Geocircle(BasicGeoposition, Double, AltitudeReferenceSystem)

Create a geographic circle object for the given position, radius and altitude reference system.

public : Geocircle(BasicGeoposition position, double radius, AltitudeReferenceSystem altitudeReferenceSystem)
public Geocircle(BasicGeoposition position, Double radius, AltitudeReferenceSystem altitudeReferenceSystem)
Public Sub New(position As BasicGeoposition, radius As Double, altitudeReferenceSystem As AltitudeReferenceSystem)
var geocircle = new geocircle(position, radius, altitudeReferenceSystem);
Parameters
position
BasicGeoposition BasicGeoposition BasicGeoposition BasicGeoposition

The geographic position of the new circle.

radius
double Double Double Double

The radius of the new circle, in meters.

altitudeReferenceSystem
AltitudeReferenceSystem AltitudeReferenceSystem AltitudeReferenceSystem AltitudeReferenceSystem

The altitude reference system of the new circle.

Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)
Capabilities
location

Geocircle(BasicGeoposition, Double, AltitudeReferenceSystem, UInt32) Geocircle(BasicGeoposition, Double, AltitudeReferenceSystem, UInt32) Geocircle(BasicGeoposition, Double, AltitudeReferenceSystem, UInt32) Geocircle(BasicGeoposition, Double, AltitudeReferenceSystem, UInt32)

Create a geographic circle object for the given position, radius, altitude reference system, and spatial reference id.

public : Geocircle(BasicGeoposition position, double radius, AltitudeReferenceSystem altitudeReferenceSystem, unsigned int spatialReferenceId)
public Geocircle(BasicGeoposition position, Double radius, AltitudeReferenceSystem altitudeReferenceSystem, UInt32 spatialReferenceId)
Public Sub New(position As BasicGeoposition, radius As Double, altitudeReferenceSystem As AltitudeReferenceSystem, spatialReferenceId As UInt32)
var geocircle = new geocircle(position, radius, altitudeReferenceSystem, spatialReferenceId);
Parameters
position
BasicGeoposition BasicGeoposition BasicGeoposition BasicGeoposition

The geographic position of the new circle.

radius
double Double Double Double

The radius of the new circle, in meters.

altitudeReferenceSystem
AltitudeReferenceSystem AltitudeReferenceSystem AltitudeReferenceSystem AltitudeReferenceSystem

The altitude reference system of the new circle.

spatialReferenceId
unsigned int UInt32 UInt32 UInt32

The spatial reference Id of the new circle.

Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)
Capabilities
location

Properties

AltitudeReferenceSystem AltitudeReferenceSystem AltitudeReferenceSystem AltitudeReferenceSystem

The altitude reference system of the geographic circle.

public : AltitudeReferenceSystem AltitudeReferenceSystem { get; }
public AltitudeReferenceSystem AltitudeReferenceSystem { get; }
Public ReadOnly Property AltitudeReferenceSystem As AltitudeReferenceSystem
var altitudeReferenceSystem = geocircle.altitudeReferenceSystem;
Value
AltitudeReferenceSystem AltitudeReferenceSystem AltitudeReferenceSystem AltitudeReferenceSystem

The altitude reference system of the geographic circle.

Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)
Capabilities
location

Remarks

Windows supports the Ellipsoid altitude reference system.

Center Center Center Center

The center point of a geographic circle.

public : BasicGeoposition Center { get; }
public BasicGeoposition Center { get; }
Public ReadOnly Property Center As BasicGeoposition
var basicGeoposition = geocircle.center;
Value
BasicGeoposition BasicGeoposition BasicGeoposition BasicGeoposition

The center point of a geographic circle.

Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)
Capabilities
location

GeoshapeType GeoshapeType GeoshapeType GeoshapeType

The type of geographic shape.

public : GeoshapeType GeoshapeType { get; }
public GeoshapeType GeoshapeType { get; }
Public ReadOnly Property GeoshapeType As GeoshapeType
var geoshapeType = geocircle.geoshapeType;
Value
GeoshapeType GeoshapeType GeoshapeType GeoshapeType

The type of geographic shape.

Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)
Capabilities
location

Radius Radius Radius Radius

The radius of a geographic circle in meters.

public : double Radius { get; }
public double Radius { get; }
Public ReadOnly Property Radius As double
var double = geocircle.radius;
Value
double double double double

The radius of a geographic circle.

Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)
Capabilities
location

Remarks

The valid range of radius values is from .1 to 10018754.3 meters. 10018754.3 meters is one quarter of the earth’s circumference.

SpatialReferenceId SpatialReferenceId SpatialReferenceId SpatialReferenceId

The spatial reference identifier for the geographic circle, corresponding to a spatial reference system based on the specific ellipsoid used for either flat-earth mapping or round-earth mapping.

public : unsigned int SpatialReferenceId { get; }
public uint SpatialReferenceId { get; }
Public ReadOnly Property SpatialReferenceId As uint
var uint = geocircle.spatialReferenceId;
Value
unsigned int uint uint uint

The spatial reference identifier for the geographic circle, corresponding to a spatial reference system based on the specific ellipsoid used for either flat-earth mapping or round-earth mapping.

Additional features and requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)
Capabilities
location

Remarks

The spatial reference id (SRID) corresponds to a spatial reference system based on the specific ellipsoid used for either flat-earth mapping or round-earth mapping. Spatial instances with the same SRID can be used when performing operations with spatial data methods on your data. The result of any spatial method derived from two spatial data instances is valid only if those instances have the same SRID that is based on the same unit of measurement, datum, and projection used to determine the coordinates of the instances. The most common units of measurement of a SRID are meters or square meters. The default SRID for the Windows platform is 4326 which is WGS84 ellipsoid.

The spatial reference identification system is defined by the European Petroleum Survey Group (EPSG) standard, which is a set of standards developed for cartography, surveying, and geodetic data storage. This standard is owned by the Oil and Gas Producers (OGP) Surveying and Positioning Committee.