Class Locator

Definition

Namespace:
Tizen.Location
Assembly:
Tizen.Location.dll
API Level:
3

This class contains the functionality for obtaining the geographical information and setting the boundary condition. Notifications on events like service becoming enabled or disabled, new position data being available, and others can also be acquired.

C#
Copy
public class Locator : IDisposable
Inheritance
System.Object
Locator
Implements
System.IDisposable

Constructors

View Source

Locator(LocationType)

The constructor of the Locator class.

Declaration
C#
Copy
public Locator(LocationType locationType)
Parameters
Type Name Description
LocationType locationType

The back-end positioning method to be used for LBS.

Exceptions
Type Condition
System.InvalidOperationException

Thrown when the operation is invalid for the current state.

System.ArgumentException

Thrown when an invalid argument is used.

System.NotSupportedException

Thrown when the location is not supported.

API Level: 3
Feature: http://tizen.org/feature/location.gpshttp://tizen.org/feature/location.wps

Properties

View Source

BatchInterval

The time interval between the position collection in batch mode. Should be in the range of 1~255 seconds.

Declaration
C#
Copy
public int BatchInterval { get; set; }
Property Value
Type Description
Int32
Exceptions
Type Condition
System.ArgumentException

Thrown when an invalid argument is used.

API Level: 4
View Source

BatchPeriod

The time interval between batch callback updates. The BatchPeriod should be greater than or equal to the BatchInterval. If the BatchPeriod is zero or smaller than the BatchInterval, then the batch mode will not work. In addition, sometimes the period may not work as you intended, the maximum permissible value for the batch period is device specific. Should be in the range of 0~60000 seconds.

Declaration
C#
Copy
public int BatchPeriod { get; set; }
Property Value
Type Description
Int32
Exceptions
Type Condition
System.ArgumentException

Thrown when an invalid argument is used.

API Level: 4
View Source

Distance

The distance between callback updates. Should be in the range of 1-120 meters.

Declaration
C#
Copy
public double Distance { get; set; }
Property Value
Type Description
System.Double
Exceptions
Type Condition
System.ArgumentException

Thrown when an invalid argument is used.

API Level: 3
View Source

EnableMock

Gets the status whether the mock location is enabled or not.

Declaration
C#
Copy
public bool EnableMock { get; set; }
Property Value
Type Description
Boolean
Exceptions
Type Condition
UnauthorizedAccessException

Thrown when the application has no privilege to use the location.

System.NotSupportedException

Thrown when the location is not supported.

API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/location
View Source

Interval

The time interval between callback updates. Should be in the range of 1~120 seconds.

Declaration
C#
Copy
public int Interval { get; set; }
Property Value
Type Description
Int32
Exceptions
Type Condition
System.ArgumentException

Thrown when an invalid argument is used.

API Level: 3
View Source

Location

Gets the location object.

Declaration
C#
Copy
public Location Location { get; }
Property Value
Type Description
Location
API Level: 3
View Source

LocationType

Gets the type used to obtain the location data.

Declaration
C#
Copy
public LocationType LocationType { get; }
Property Value
Type Description
LocationType
API Level: 3
View Source

StayInterval

The time interval between the distance-based location callback updates. Should be in the range of 1~120 seconds.

Declaration
C#
Copy
public int StayInterval { get; set; }
Property Value
Type Description
Int32
Exceptions
Type Condition
System.ArgumentException

Thrown when an invalid argument is used.

API Level: 3

Methods

View Source

AddBoundary(LocationBoundary)

Adds a bound for a given locator.

Declaration
C#
Copy
public void AddBoundary(LocationBoundary locationBoundary)
Parameters
Type Name Description
LocationBoundary locationBoundary

The boundary object to be added to the locator.

Exceptions
Type Condition
System.InvalidOperationException

Thrown when the operation is invalid for the current state.

System.ArgumentException

Thrown when an invalid argument is used.

System.NotSupportedException

Thrown when the location is not supported.

API Level: 3
View Source

ClearMock()

Clears a mock location for the given location method.

Declaration
C#
Copy
public void ClearMock()
Exceptions
Type Condition
System.InvalidOperationException

Thrown when the operation is invalid for the current state.

System.ArgumentException

Thrown when an invalid argument is used.

UnauthorizedAccessException

Thrown when the application has no privilege to use the location.

System.NotSupportedException

Thrown when the location is not supported.

API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/location
View Source

Dispose()

The overidden Dispose method of the IDisposable class.

Declaration
C#
Copy
public void Dispose()
Exceptions
Type Condition
System.ArgumentException

Thrown when an invalid argument is used.

API Level: 3
View Source

Dispose(Boolean)

Dispose.

Declaration
C#
Copy
protected virtual void Dispose(bool disposing)
Parameters
Type Name Description
Boolean disposing
API Level: 3
View Source

Finalize()

The destructor of the Locator class.

Declaration
C#
Copy
protected void Finalize()
API Level: 3
View Source

GetLocation()

Gets the details of the location.

Declaration
C#
Copy
public Location GetLocation()
Returns
Type Description
Location

Which contains the current location details.

Exceptions
Type Condition
System.InvalidOperationException

Thrown when the operation is invalid for the current state.

System.ArgumentException

Thrown when an invalid argument is used.

UnauthorizedAccessException

Thrown when the application has no privilege to use the location.

System.NotSupportedException

Thrown when the location is not supported.

API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/location
View Source

GetLocationAsync(Int32)

Gets the details of the location asynchronously.

Declaration
C#
Copy
public Task<Location> GetLocationAsync(int timeout)
Parameters
Type Name Description
Int32 timeout

Timeout to stop requesting a single location after (seconds).

Returns
Type Description
System.Threading.Tasks.Task<Location>

A task which contains the current location details.

Exceptions
Type Condition
System.InvalidOperationException

Thrown when the operation is invalid for the current state.

System.ArgumentException

Thrown when an invalid argument is used.

UnauthorizedAccessException

Thrown when the application has no privilege to use the location.

System.NotSupportedException

Thrown when the location is not supported.

API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/location
View Source

RemoveBoundary(LocationBoundary)

Deletes a bound for a given locator.

Declaration
C#
Copy
public void RemoveBoundary(LocationBoundary locationBoundary)
Parameters
Type Name Description
LocationBoundary locationBoundary

The boundary object to be removed from the locator.

Exceptions
Type Condition
System.InvalidOperationException

Thrown when the operation is invalid for the current state.

System.ArgumentException

Thrown when an invalid argument is used.

System.NotSupportedException

Thrown when the location is not supported.

API Level: 3
View Source

SetMockLocation(Location)

Sets a mock location for the given location method.

Declaration
C#
Copy
public void SetMockLocation(Location location)
Parameters
Type Name Description
Location location

The location object containing the mock location details.

Exceptions
Type Condition
System.InvalidOperationException

Thrown when the operation is invalid for the current state.

System.ArgumentException

Thrown when an invalid argument is used.

UnauthorizedAccessException

Thrown when the application has no privilege to use the location.

System.NotSupportedException

Thrown when the location is not supported.

API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/location
View Source

Start()

Starts the Location Manager which has been created using the specified method.

Declaration
C#
Copy
public void Start()
Exceptions
Type Condition
System.InvalidOperationException

Thrown when the operation is invalid for the current state.

System.ArgumentException

Thrown when an invalid argument is used.

UnauthorizedAccessException

Thrown when the application has no privilege to use the location.

System.NotSupportedException

Thrown when the location is not supported.

API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/location
View Source

Stop()

Stops the Location Manager which has been activated using the specified method. Does not destroy the manager.

Declaration
C#
Copy
public void Stop()
Exceptions
Type Condition
System.InvalidOperationException

Thrown when the operation is invalid for the current state.

System.ArgumentException

Thrown when an invalid argument is used.

System.NotSupportedException

Thrown when the location is not supported.

API Level: 3

Events

View Source

DistanceBasedLocationChanged

The DistanceBasedLocationChanged event is raised with the updated location information. The callback will be invoked at a minimum interval or minimum distance with the updated position information.

Declaration
C#
Copy
public event EventHandler<LocationChangedEventArgs> DistanceBasedLocationChanged
Event Type
Type Description
System.EventHandler<LocationChangedEventArgs>
Exceptions
Type Condition
System.ArgumentException

Thrown when an invalid argument is used.

System.NotSupportedException

Thrown when the location is not supported.

API Level: 3
View Source

LocationChanged

The LocationUpdated event is raised at defined intervals of time with the updated location information. The callback will be invoked periodically.

Declaration
C#
Copy
public event EventHandler<LocationChangedEventArgs> LocationChanged
Event Type
Type Description
System.EventHandler<LocationChangedEventArgs>
Exceptions
Type Condition
System.ArgumentException

Thrown when an invalid argument is used.

System.NotSupportedException

Thrown when the location is not supported.

API Level: 3
View Source

ServiceStateChanged

The ServiceStateChanged event is invoked when the location service state is changed.

Declaration
C#
Copy
public event EventHandler<ServiceStateChangedEventArgs> ServiceStateChanged
Event Type
Type Description
System.EventHandler<ServiceStateChangedEventArgs>
Exceptions
Type Condition
System.ArgumentException

Thrown when an invalid argument is used.

System.NotSupportedException

Thrown when the location is not supported.

API Level: 3
View Source

SettingChanged

The SetttingChanged event is raised when the location setting is changed.

Declaration
C#
Copy
public event EventHandler<SettingChangedEventArgs> SettingChanged
Event Type
Type Description
System.EventHandler<SettingChangedEventArgs>
Exceptions
Type Condition
System.InvalidOperationException

Thrown when the operation is invalid for the current state.

System.ArgumentException

Thrown when an invalid argument is used.

System.NotSupportedException

Thrown when the location is not supported.

API Level: 3
View Source

ZoneChanged

The ZoneChanged event is invoked when the previously set boundary area is entered or left.

Declaration
C#
Copy
public event EventHandler<ZoneChangedEventArgs> ZoneChanged
Event Type
Type Description
System.EventHandler<ZoneChangedEventArgs>
Exceptions
Type Condition
System.ArgumentException

Thrown when an invalid argument is used.

System.NotSupportedException

Thrown when the location is not supported.

API Level: 3

Implements

System.IDisposable