Interface ISN_ICLLocationManagerDelegate
The methods that you use to receive events from an associated location manager object.
Namespace: SA.iOS.CoreLocation
Assembly: cs.temp.dll.dll
Syntax
public interface ISN_ICLLocationManagerDelegateMethods
DidChangeAuthorizationStatus(ISN_CLAuthorizationStatus)
Tells the delegate that the authorization status for the application changed.
This method is called whenever the application’s ability to use location services changes. Changes can occur because the user allowed or denied the use of location services for your application or for the system as a whole.
Declaration
void DidChangeAuthorizationStatus(ISN_CLAuthorizationStatus authorizationStatus)Parameters
| Type | Name | Description |
|---|---|---|
| ISN_CLAuthorizationStatus | authorizationStatus | The new authorization status for the application. |
DidFailWithError(SA_Error)
Tells the delegate that the location manager was unable to retrieve a location value. If you do not implement this method, Core Location throws an exception when attempting to use location services.
Declaration
void DidFailWithError(SA_Error error)Parameters
| Type | Name | Description |
|---|---|---|
| SA_Error | error | The error object containing the reason the location or heading could not be retrieved. |
DidFinishDeferredUpdatesWithError(SA_Error)
Tells the delegate that updates will no longer be deferred.
The location manager object calls this method to let you know that it has stopped deferring the delivery of location events. The manager may call this method for any number of reasons. For example, it calls it when you stop location updates altogether, when you ask the location manager to disallow deferred updates, or when a condition for deferring updates (such as exceeding a timeout or distance parameter) is met.
Declaration
void DidFinishDeferredUpdatesWithError(SA_Error error)Parameters
| Type | Name | Description |
|---|---|---|
| SA_Error | error | The error object containing the reason deferred location updates could not be delivered. |
DidPauseLocationUpdates()
Tells the delegate that location updates were paused.
When the location manager detects that the device’s location is not changing, it can pause the delivery of updates in order to shut down the appropriate hardware and save power. When it does this, it calls this method to let your app know that this has happened.
After a pause occurs, it is your responsibility to restart location services again at an appropriate time. You might use your implementation of this method to start region monitoring at the user's current location or enable the visits location service to determine when the user starts moving again. Another alternative is to restart location services immediately with a reduced accuracy (which can save power) and then return to a greater accuracy only after the user starts moving again.
Declaration
void DidPauseLocationUpdates()DidResumeLocationUpdates()
Tells the delegate that the delivery of location updates has resumed.
When you restart location services after an automatic pause, Core Location calls this method to notify your app that services have resumed. You are responsible for restarting location services in your app. Core Location does not resume updates automatically after it pauses them.
Declaration
void DidResumeLocationUpdates()DidUpdateLocations(ISN_CLLocationArray)
Tells the delegate that new location data is available.
Declaration
void DidUpdateLocations(ISN_CLLocationArray locations)Parameters
| Type | Name | Description |
|---|---|---|
| ISN_CLLocationArray | locations | An array of ISN_CLLocation objects containing the location data. This array always contains at least one object representing the current location. If updates were deferred or if multiple locations arrived before they could be delivered, the array may contain additional entries. The objects in the array are organized in the order in which they occurred. Therefore, the most recent location update is at the end of the array. |