geoTrackingProcedure (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Specific features
Tracking management: low precision

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

geoTrackingProcedure (Function)

In french: géoSuiviProcédure

Defines the WLanguage procedure that will be called when the user position changes.

Example

// -- Project initialization
geoTrackingProcedure(TrackingProcedure)

// Implement the TrackingProcedure procedure
PROCEDURE TrackingProcedure(mPosition is geoPosition)
// Send the position to the server
SendServer(mPosition)

Syntax

<Result> = geoTrackingProcedure(<Procedure name>)

<Result>: Boolean

True if the system for tracking position is available,
False if the system for tracking position is not available. To find out the error details, use ErrorInfo.

<Procedure name>: Character string (with or without quotes)

Name of WLanguage procedure called when the user position changes.
This procedure has the following format:

PROCEDURE <Procedure name>(<Position> is geoPosition)

In this code, <Position> is a geoPosition variable corresponding to the current position of user.
This procedure must be a global procedure of application.

Remarks

Specific features

geoTrackingProcedure must be called in the initialization code of project. Indeed, the WLanguage procedure can be called just after the initialization, for a clock in background mode for example.
When receiving a position, the application is automatically restarted if it is in stand-by mode.
geoTrackingProcedure can be used in background mode. You should not access the interface or open windows in the WLanguage procedure because iOS does not allow the accesses to the interface when the application is in background.

Tracking management: low precision

Caution: The tracking is a low-precision tracking. The events are sent only if significant changes of position occur and at time intervals exceeding several minutes. For information, the sending conditions per platform are as follows:

The events regarding the change of position are not sent if the move is less than 500 meters or if the time interval is less than 5 minutes (December 2014).
The events regarding the change of position are sent with a time interval included between 30 seconds and 10 minutes according to the movement speed.

For a more precise tracking, you must use GPSFollowMovement. However, this function:

requires the application to be started,
requires the application to be in the foreground,
consumes more battery.

Component : wp240device.dll