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

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

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

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

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

<!-- Initial Contributors:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE concept

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

# Quality Profiles for LBS services

#

[1]

ProfileID= 0

MaxTime= 130

HorizontalAccuracy= 50

VerticalAccuracy= 1000

MeasurementInitialTime= 15

MeasurementIntermediateTime= 5

FinalNetPositionLag= 10

[2]

ProfileID= 1

MaxTime= 120

HorizontalAccuracy= 20

VerticalAccuracy= 1000

MeasurementInitialTime= 15

MeasurementIntermediateTime= 5</codeblock> <p>The following table describes the purpose of the parameters in <filepath>lbsprofile.ini</filepath>. </p> <table id="GUID-D544BF11-EDB4-5226-9222-1E9BAD39B307"><tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/><thead><row><entry>Parameter </entry> <entry>Type</entry> <entry>Description</entry> </row> </thead> <tbody><row><entry><p>ProfileID </p> </entry> <entry><p>Integer </p> </entry> <entry><p>The ID of the profile. This must be a unique value for each quality profile defined in this file. This value is used as a key from the administration repository file. </p> </entry> </row> <row><entry><p>MaxTime </p> </entry> <entry><p>Integer </p> </entry> <entry><p>The default maximum time (in seconds) to calculate a location fix for the profile. This is the time to obtain GPS measurements and use them to calculate a fix for autonomous or terminal based GPS mode. See also <codeph>FinalNetPositionLag</codeph> below. </p> </entry> </row> <row><entry><p>HorizontalAccuracy </p> </entry> <entry><p>Float </p> </entry> <entry><p>The maximum acceptable error (in metres) in horizontal position for this quality profile. </p> </entry> </row> <row><entry><p>VerticalAccuracy </p> </entry> <entry><p>Float </p> </entry> <entry><p>The maximum acceptable error (in metres) in vertical position for this quality profile. </p> </entry> </row> <row><entry><p>MeasurementInitialTime </p> </entry> <entry><p>Float </p> </entry> <entry><p>The maximum time (in seconds) to get the first GPS measurements (but not a GPS location fix). Used in terminal assisted GPS mode. </p> </entry> </row> <row><entry><p>MeasurementIntermediateTime </p> </entry> <entry><p>Float </p> </entry> <entry><p>The maximum time (in seconds) to get subsequent GPS measurements after the first measurements have been received. </p> </entry> </row> <row><entry><p>FinalNetPositionLag </p> </entry> <entry><p>Integer </p> </entry> <entry><p>An additional time (in seconds) that the Location Server waits to receive a position update for a MO-LR self-locate before it notifies the client that the request has timed out. This additional time is to allow the "final position" to be retrieved from the network. The final position may have been calculated by a network server for Terminal Assisted Mode. </p> <p>For example, if a client application calls <codeph>RPositioner::NotifyPositionUpdate(TPositionInfoBase &amp;aPosInfo,

                  TRequestStatus &amp;aStatus)</codeph> and the profile is configured for MO-LR self locate, then the Location Server waits a total of <codeph>MaxTime</codeph> + <codeph>FinalNetPositionLag</codeph> seconds to receive a position before it completes the request with <codeph>aStatus = KErrTimedOut</codeph>. </p> <p> <b>Note:</b> if a client application sets an update timeout by calling <codeph>RPositioner::SetUpdateOptions(TPositionUpdateOptions&amp;

                  options)</codeph> and has set a timeout on the options by calling <xref href="GUID-E8ACE5F3-5479-3C86-ACC9-89190ED29649.dita"><apiname>options.SetUpdateTimeout()</apiname></xref>, then the Location Server waits a total of <xref href="GUID-4C597C79-46BB-3796-B6AA-020722D172B7.dita"><apiname>options.UpdateTimeOut() </apiname></xref> + <codeph>FinalNetPositionLag</codeph> to receive a position before it completes the request with <codeph>aStatus = KErrTimedOut</codeph>. Where <codeph>FinalNetPositionLag</codeph> is omitted from a profile, it is assumed to be 0. </p> </entry> </row> </tbody> </tgroup> </table> </section> </conbody><related-links><link href="GUID-5E6CA805-6861-54B1-8687-B997A6F4E6EE.dita"><linktext>Quality

                Profile API</linktext> </link> <link href="GUID-0D49DE9F-AE0D-552F-8769-D056BC505FC1.dita"><linktext>How

                to use the Quality Profile API</linktext> </link> <link href="GUID-D0318BB6-0B9F-5A1C-AB0B-61BA22D28661.dita"><linktext>Location Acquisition API</linktext> </link> <link href="GUID-D18B4715-3942-52EA-9D2F-E145037FA47A.dita"><linktext>LBS

                Integration and Configuration Guide</linktext> </link> </related-links></concept>