1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-05931546-C3C9-4085-8D5F-6B6C3F21D24C" xml:lang="en"><title>Location

    13 Triggering API</title><shortdesc>The Location Triggering API enables a client application to create

    14 and manage location based triggers. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

    15 <p>Location based triggers notify a client application when a device enters

    16 or leaves a specified geographical area. For example, an end user could set

    17 a trigger so that their device notifies them when they are in the vicinity

    18 of a specific train station. </p>

    19 <p>A trigger has various attributes, including a triggering condition and

    20 a system reaction. The triggering condition determines when the trigger is

    21 fired. The system reaction determines how the client application is notified

    22 when the triggering condition is met.</p>

    23 <p>Typical use cases include:</p>

    24 <ul>

    25 <li><p>Creating a trigger</p></li>

    26 <li><p>Modifying a trigger</p></li>

    27 <li><p>Deleting a trigger</p></li>

    28 <li><p>Handling a trigger firing event.</p></li>

    29 </ul>

    30 <p>For detailed information about the Location Triggering API, see the Location

    31 Triggering API Specification document.</p>

    32 </conbody><related-links>

    33 <link href="GUID-D0318BB6-0B9F-5A1C-AB0B-61BA22D28661.dita"><linktext>Location

    34 Acquisition API</linktext></link>

    35 </related-links></concept>