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: 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
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
System.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
System.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
System.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
System.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
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
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
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
System.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
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
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
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
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
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
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