CoreLocation Namespace

The CoreLocation namespace provides classes for tracking and monitoring location, regions (including iBeacons), and geocoding.

Classes

CLAuthorizationChangedEventArgs	Provides data for the AuthorizationChanged event.
CLBeacon	Represents a local-area device that can be used for fine-grained location monitoring.
CLBeaconRegion	CoreLocation region determined by an iBeacon.
CLCircularRegion	A CLRegion defined by a center and a radius (in meters).
CLFloor	Information describing a building level.
CLGeocoder	Provides support for converting between an address in text form and a location described using latitude and longitude or to convert from a latitue and longitude to a user-friendly location (street, city, state, country).
CLHeading	Heading data as generated by the CLLocationManager.
CLHeadingUpdatedEventArgs	Provides data for the UpdatedHeading event.
CLLocation	Location information as generated byt he CLLocationManager class.
CLLocationDistance	A class whose static members define constants relating to filtering and maximum distance.
CLLocationManager	Manages the delivery of location, region, and heading events to your application.
CLLocationManagerDelegate	Virtual methods on this class receive notifications from the CLLocationManager.
CLLocationManagerDelegate_Extensions	Extension methods to the ICLLocationManagerDelegate interface to support all the methods from the CLLocationManagerDelegate protocol.
CLLocationsUpdatedEventArgs	Provides data for the LocationsUpdated event.
CLLocationUpdatedEventArgs	Provides data for the UpdatedLocation event.
CLPlacemark	Associates data such as street address with a coordinate.
CLRegion	The base class for trackable geographical regions.
CLRegionBeaconsFailedEventArgs	Provides data for the RangingBeaconsDidFailForRegion event.
CLRegionBeaconsRangedEventArgs	Provides data for the DidRangeBeacons event.
CLRegionErrorEventArgs	Provides data for the MonitoringFailed event.
CLRegionEventArgs	Provides data for the RegionLeft, E:CoreLocation.CLRegionEventArgs.RegionEntered and E:CoreLocation.CLRegionEventArgs.RegionLeft events.
CLRegionStateDeterminedEventArgs	Provides data for the DidDetermineState event.
CLVisit	Relates a location and radius with an arrival and departure time.
CLVisitedEventArgs	Provides data for the DidVisit event.

Structs

CLLocationCoordinate2D

Geographical coordinates.

Interfaces

ICLLocationManagerDelegate

Interface representing the required methods (if any) of the protocol CLLocationManagerDelegate.

Enums

CLActivityType	An enumeration whose values specify different types of activity.
CLAuthorizationStatus	An enumeration whose values specify the current status of authorization to use location services.
CLDeviceOrientation	An enumeration whose values represent the device's physical orientation.
CLError	Errors returned by the CLLocationManager.
CLProximity	An enumeration whose values specify the physical proximity of an iBeacon.
CLRegionState	An enumeration whose values specify whether the device is inside or outside a region or unknown.

Delegates

CLGeocodeCompletionHandler	A delegate that is the completionHandler in calls to GeocodePostalAddressAsync(CNPostalAddress, NSLocale).
CLLocationManagerEventArgs	Event arguments generated by the ShouldDisplayHeadingCalibration event.

Remarks

The Core Location namespace revolves around tracking and monitoring user location, the device's entry-and-exit from regions (either fixed or iBeacon-based), and geocoding between addresses and locations.

Geocoding use-cases center on the CLGeocoder class. Geocoding is simple:

async void GeocodeToConsoleAsync (string address) {
    var geoCoder = new CLGeocoder();
    var placemarks = await geoCoder.GeocodeAddressAsync(address);
    foreach (var placemark in placemarks) {
	      Console.WriteLine(placemark);
    }   

As is reverse-geocoding:

async void ReverseGeocodeToConsoleAsync (CLLocation location) {
    var geoCoder = new CLGeocoder();
    var placemarks = await geoCoder.ReverseGeocodeLocationAsync(location);
    foreach (var placemark in placemarks) {
	      Console.WriteLine(placemark);
    }          
}

Other use-cases typically will start with the CLLocationManager class:

• Tracking the device's location:
• Region monitoring (Geofencing):
• iBeacon ranging:

These use-cases are discussed in the CLLocationManager class documentation.