GPSGetPosition (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Standard functions / Geolocation functions

Managing locks
Browsers allowing the geolocation

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

GPSGetPosition (Function)

In french: GPSRécupèrePosition

Retrieves information about the current device position.

Example

MaPosition is geoPosition
MaPosition = GPSGetPosition()
// Vérifie validité de la position avec ErreurDétectée
IF ErrorOccurred THEN RETURN
Info(" Latitude : " + MaPosition.Latitude)  
Info(" Longitude : " + MaPosition.Longitude)

// Géolocalisation depuis WEBDEV, une procédure navigateur est appelée.
// Traitement réalisé depuis un bouton ayant comme action "aucune"
GPSGetPosition(ProcNavigateur, 200)

// Procédure navigateur "ProcNavigateur"
PROCEDURE ProcNavigateur(MaPosition is geoPosition, nMonErreur is int)
SWITCH nMonErreur
	CASE gpsErrorOK
		// Aucune erreur n'a été détectée
		PAGE_Page1.SAI_SansNom1 = MaPosition.Altitude + " " + MaPosition.Longitude
	CASE gpsErrorRights
		PAGE_Page1.SAI_SansNom1 = "Le navigateur n'a pas les droits " + ...
				"pour utiliser la géolocalisation (ou site non HTTPS)."
	CASE gpsErrorPosition
		PAGE_Page1.SAI_SansNom1 = "Impossible de déterminer la position " + ...
				"(erreur interne du fournisseur d'accès par exemple)."
	CASE gpsErrorTimeout
		PAGE_Page1.SAI_SansNom1 = ...
			"La position n'a pas pu être récupérée dans le temps imparti."
	OTHER CASE
		PAGE_Page1.SAI_SansNom1 = "Erreur indéterminée"
END

Syntax

Retrieving the information in browser code Hide the details

GPSGetPosition([<WLanguage procedure> [, <Timeout>]])

<WLanguage procedure>: Procedure name

Name of the WLanguage procedure in browser code ("callback") called when the location is retrieved.
This procedure has the following format:
PROCEDURE <Procedure name>(<Position>,<Error>)
where:
<Position> is a variable of type geoPosition containing information on the position. To determine if a value was assigned to the Speed, Accuracy, Direction or Altitude properties of a geoPosition variable when the location was retrieved, use the SpeedValid, AccuracyValid, DirectionValid and AltitudeValid properties.
<Error> is an Integer constant corresponding to the error code and that can take the following values:
gpsErrorOK No error was detected.
gpsErrorPosition Unable to determine the location (e.g., access provider internal error).
gpsErrorRights
The browser has no sufficient rights to use geolocation.
The browser is recent and the site is not using the HTTPS secure protocol.
gpsErrorTimeout The location could not be retrieved within the timeout.

<Timeout>: Optional integer or optional Duration

Maximum timeout (in hundredths of a second) for updating the device position.
If this timeout ends before the device position is updated, gpsErrorTimeOut is returned in the <Error> parameter of the WLanguage procedure.
If this parameter is not specified, the timeout is set to 1 minute.
Note: This parameter can correspond to:
an integer corresponding to the number of hundredths of a second,
a Duration variable,
the duration in a readable format (e.g., 1 s or 10 ms).

Remarks

Managing locks

GPSGetPosition blocks execution until the current device location is retrieved or until the timeout defined by the <Timeout> parameter expires.

If the function is called in the main thread of the application, an hourglass will be displayed during the function execution. The message displayed by the hourglass can be specified via the <Message> parameter.
Otherwise, the execution of secondary thread will be locked during the function execution and no hourglass will be displayed.

This function is not locking.

Note: To find out the last known position of the device without delay, use the GPSLastPosition function.. Caution, the positioning information that was retrieved may not correspond to the current device position if the device was moved while the GPS signal was not valid for example. You can use the MeasurementDate property of the geoPosition variable to determine the date and time at which the position was calculated.

Browsers allowing the geolocation

During the call to a geolocation function, the browser requests a location authorization.Note: As of Chrome 50 (including Android), the function GPSGetPosition function can only be used on secure sites (via an SSL certificate, for example). If the site is not secured, the function returns a result that cannot be used. During the test in local (localhost), the function operates properly.

Business / UI classification: Business Logic

Component: wd300java.dll