Show / Hide Table of Contents

    Namespace Tizen.Location.Geofence

    The Tizen.Location.Geofence namespace provides classes for virtual perimeter.

    Overview

    This API provides functions to set the gofence with a geopoint, MAC address of Wi-Fi, and Bluetooth address. Also, notifications on events like changing in service status are provided.

    There are two kinds of places and fences:

    • Public places and fences that are created by the MyPlace application can be used by all applications.
    • Private places and fences that are created by the specified application can be used by the same application.

    Notifications can be received about the following events:

    • Zone in when a device enters a specific area.
    • Zone out when a device exits a specific area.
    • Results and errors for each event requested to geofence module.

    The Geofence manager has the following properties:

    • The geofence type.
    • The status.
    • 'Service state change' callback

    Related Features

    To guarantee that the geofence application runs on a device with the geofence profile feature, declare the following feature requirements in the config file:

    • http://tizen.org/feature/location
    • http://tizen.org/feature/location.Geofence
    • http://tizen.org/feature/location.wps

    Classes

    Fence

    Geofence defines a virtual perimeter for a real-world geographic area. If you create a geofence, you can trigger some activities when a device enters (or exits) the geofences defined by you. You can create a geofence with the information of the Geopoint, Wi-Fi, or BT.

    • Geopoint: Geofence is specified by the coordinates (Latitude and Longitude) and radius.
    • WIFI: Geofence is specified by the BSSID of the Wi-Fi access point.
    • BT: Geofence is specified by the Bluetooth address.
    The Basic service set identifier (BSSID) is the MAC address of the wireless access point (WAP) generated by combining the 24-bit Organization Unique Identifier (the manufacturer's identity) and the manufacturer's assigned 24-bit identifier for the radio chipset in the WAP.

    FenceData

    Represents the geofence list item data.

    FenceStatus

    The geofence status describes the current state and duration of a geofence.

    • State: The state is specified by the current state of the fence.
    • Duration: Geofence is specified by the duration of the current state.

    GeofenceManager

    The Geofence Manager API provides service related to geofence (geo-fence). Geofence is a virtual perimeter for a real-world geographic area. This API provides functions to set geofence with a geopoint, MAC address of Wi-Fi, and Bluetooth address. Also, notifications on events like changing in service status are provided. There are two kinds of places and fences:

    • Public places and fences are created by the MyPlace application that can be used by all applications.
    • Private places and fences are created by the specified application that can be used by the same application.
    Notifications can be received about the following events:
    • Zone in when a device enters a specific area.
    • Zone out when a device exits a specific area.
    • Results and errors for each event requested to the geofence module.

    GeofenceResponseEventArgs

    Event arguments are passed when an event occurs in geofence and the place, such as add, update, etc..

    GeofenceStateEventArgs

    Event arguments are passed when an event is triggered to notify the geofence state change.

    PlaceData

    Represents the place list item data.

    ProximityStateEventArgs

    Event arguments are passed when an event is triggered to notify the proximity state change.

    VirtualPerimeter

    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.

    Enums

    FenceType

    Enumeration for the geofence types.

    GeofenceError

    Enumeration for the types of error occured, if any.

    GeofenceEventType

    Enumeration for the geofence management events.

    GeofenceState

    Enumeration for the state of geofence.

    ProximityProvider

    Enumeration for the provider of proximity.

    ProximityState

    Enumeration for the state of proximity.

    Back to top Copyright © 2016-2022 Samsung
    Generated by DocFX