Class VirtualPerimeter
Definition
- Namespace:
- Tizen.Location.Geofence
- Assembly:
- Tizen.Location.Geofence.dll
- API Level:
- 3
Allows to create a virtual fence as geofence using the GeofenceManager instance. A user can manage all the geofence or place related data and events.
public class VirtualPerimeter
- Inheritance
-
VirtualPerimeter
Constructors
View SourceVirtualPerimeter(GeofenceManager)
Creates a VirtualPerimeter which can be used to create a virtual fence.
Declaration
public VirtualPerimeter(GeofenceManager manager)
Parameters
Type | Name | Description |
---|---|---|
GeofenceManager | manager | The GeofenceManager instance. |
Exceptions
Type | Condition |
---|---|
ArgumentException | In case of an invalid parameter. |
API Level: 3
Methods
View SourceAddGeofence(Fence)
Adds the geofence for a given Geofence manager.
Declaration
public int AddGeofence(Fence fence)
Parameters
Type | Name | Description |
---|---|---|
Fence | fence | The geofence instance to be added. |
Returns
Type | Description |
---|---|
Int32 | The geofence ID to be newly created on success. |
Remarks
The return value will always be a number greater than zero.
Exceptions
Type | Condition |
---|---|
ArgumentException | In case of an invalid parameter. |
InvalidOperationException | In case of any system error. |
UnauthorizedAccessException | In case privileges are not defined. |
NotSupportedException | In case the geofence is not supported. |
API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/location
View SourceAddPlaceName(String)
Creates a new place for the geofencing service.
Declaration
public int AddPlaceName(string name)
Parameters
Type | Name | Description |
---|---|---|
String | name | A place name to be created. |
Returns
Type | Description |
---|---|
Int32 | The place ID to be newly created on success. |
Exceptions
Type | Condition |
---|---|
ArgumentException | In case of an invalid parameter. |
InvalidOperationException | In case of any system error. |
UnauthorizedAccessException | In case privileges are not defined. |
NotSupportedException | In case the geofence is not supported. |
API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/location
View SourceGetFenceDataList()
Retrieves a list of fences registered in the specified Geofence manager.
Declaration
public IEnumerable<FenceData> GetFenceDataList()
Returns
Type | Description |
---|---|
IEnumerable<FenceData> | List of FenceData instances registered for each geofence. |
Exceptions
Type | Condition |
---|---|
InvalidOperationException | In case of any system error. |
UnauthorizedAccessException | In case privileges are not defined. |
NotSupportedException | In case geofence is not supported. |
API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/location
View SourceGetGeofenceDataListByPlaceId(Int32)
Retrieves a list of fences registered in the specified place.
Declaration
public IEnumerable<FenceData> GetGeofenceDataListByPlaceId(int placeId)
Parameters
Type | Name | Description |
---|---|---|
Int32 | placeId | The place ID. |
Returns
Type | Description |
---|---|
IEnumerable<FenceData> | The list of FenceData instances registered for each geofence for the specified place. |
Exceptions
Type | Condition |
---|---|
ArgumentException | In case of an invalid parameter. |
InvalidOperationException | In case of any system error. |
UnauthorizedAccessException | In case privileges are not defined. |
NotSupportedException | In case the geofence is not supported. |
API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/location
View SourceGetPlaceDataList()
Retrieves a list of places registered in the specified Geofence manager.
Declaration
public IEnumerable<PlaceData> GetPlaceDataList()
Returns
Type | Description |
---|---|
IEnumerable<PlaceData> | List of places registered as the PlaceData instance list. |
Exceptions
Type | Condition |
---|---|
InvalidOperationException | In case of any system error. |
UnauthorizedAccessException | In case privileges are not defined. |
NotSupportedException | In case the geofence is not supported. |
API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/location
View SourceGetPlaceName(Int32)
Gets the name of place.
Declaration
public string GetPlaceName(int placeId)
Parameters
Type | Name | Description |
---|---|---|
Int32 | placeId | The place ID. |
Returns
Type | Description |
---|---|
String | The name of the place. |
Exceptions
Type | Condition |
---|---|
ArgumentException | In case of an invalid parameter. |
InvalidOperationException | In case of any system error. |
UnauthorizedAccessException | In case privileges are not defined. |
NotSupportedException | In case the geofence is not supported. |
API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/location
View SourceRemoveGeofence(Int32)
Removes the geofence with a given geofence ID.
Declaration
public void RemoveGeofence(int fenceId)
Parameters
Type | Name | Description |
---|---|---|
Int32 | fenceId | The specified geofence ID. |
Exceptions
Type | Condition |
---|---|
ArgumentException | In case of an invalid parameter. |
InvalidOperationException | In case of any system error. |
UnauthorizedAccessException | In case privileges are not defined. |
NotSupportedException | In case the geofence is not supported. |
API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/location
View SourceRemovePlace(Int32)
Removes the specific place for the geofencing service.
Declaration
public void RemovePlace(int placeId)
Parameters
Type | Name | Description |
---|---|---|
Int32 | placeId | The specified place ID. |
Exceptions
Type | Condition |
---|---|
ArgumentException | Incase of an invalid parameter. |
InvalidOperationException | In case of any system error. |
UnauthorizedAccessException | In case privileges are not defined. |
NotSupportedException | In case the geofence is not supported. |
API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/location
View SourceUpdatePlace(Int32, String)
Updates the place name of a given place ID.
Declaration
public void UpdatePlace(int placeId, string name)
Parameters
Type | Name | Description |
---|---|---|
Int32 | placeId | The specified place ID. |
String | name | A new place name of the place ID. |
Exceptions
Type | Condition |
---|---|
ArgumentException | In case of an invalid parameter. |
InvalidOperationException | In case of any System error. |
UnauthorizedAccessException | In case privileges are not defined. |
NotSupportedException | In case the geofence is not supported. |