float LocationGetHorizontalAccuracy();

Gets the current radius of uncertainty (in meters) of location readings.

Return Value

Returns a non-zero value if the call was successful, zero otherwise.

Remarks

LocationGetHorizontalAccuracy() returns the current uncertainty radius of location in meters.

Windows Simulator NOTE: To provide values for the Windows Simulator, be sure to edit C:\DragonFireSDK\DragonFireSDK.ini and modify the value for HorizontalAccuracy in the Location section.

NOTE: It is recommended to call LocationMonitorLocation() prior to calling LocationGetHorizontalAccuracy().  This gives the device time to begin receiving more and more accurate location data prior to getting location data.  Subsequent calls to LocationGetHorizontalAccuracy() may become more accurate over time as the device pinpoints your location.

Availability

Available in DragonFireSDK 1.4 and later.

Example

#include "DragonFireSDK.h"

int MyFont;

int HorizontalAccuracyText;

char TextBuffer[100];

void AppMain()

{

  LandscapeMode();

  // Begin monitoring location

  LocationMonitorLocation(1);

  MyFont = FontAdd("Helvetica", "Regular", 24, 0x00FF00);

  HorizontalAccuracyText = TextAdd(10, 10, "Horizontal Accuracy:", MyFont);

}

//===============================================

void OnTimer()

{

  float horizontalAccuracy;

  horizontalAccuracy = LocationGetHorizontalAccuracy();

  sprintf(TextBuffer, "Horizontal Accuracy: %fm", horizontalAccuracy);

  TextSetText(HorizontalAccuracyText, TextBuffer);

}

//===============================================

void AppExit()

{

}