DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de géolocalisation
  • Propriétés récupérées
  • Notes
  • Fonctionnalité d'application requise
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Demande à être notifié périodiquement de la position courante du périphérique.
Exemple
// Branche une procédure pour recevoir régulièrement la position du périphérique
GPSSuitDéplacement(ProcDeplacement)
// Procédure
PROCÉDURE ProcDeplacement(pos est une géoPosition)
 
Info(" Latitude : " + pos.Latitude)  
Info(" Longitude : " + pos.Longitude)
Syntaxe
Universal Windows 10 App

Activer le mécanisme de notification (sous un mobile) Masquer les détails

GPSSuitDéplacement(<Procédure WLangage> [, <Délai> [, <Distance>]])
<Procédure WLangage> : Nom de procédure
Nom de la procédure WLangage appelée à chaque notification.
Cette procédure est de la forme :
PROCEDURE <Nom de la Procédure>(<Position>)
Le paramètre <Position> est une variable de type géoPosition contenant les informations sur la position de l'appareil au moment de la notification.
<Délai> : Entier optionnel ou Durée optionnelle
Délai minimal (en centièmes de seconde) entre deux notifications. Si ce paramètre n'est pas spécifié, le délai minimal sera de 60 secondes.
Remarque : Ce paramètre peut correspondre à :
  • un entier correspondant au nombre de centièmes de seconde,
  • une variable de type Durée,
  • l'indication directe de la durée (par exemple 1 s ou 10 ms).
Universal Windows 10 App Ce paramètre n'est pas pris en compte.
<Distance> : Réel optionnel
Distance minimale (en mètres) entre deux notifications.
Si ce paramètre n'est pas spécifié, la distance minimale sera de 5 mètres.

Désactiver le mécanisme de notification

GPSSuitDéplacement()
Remarques
Universal Windows 10 App

Propriétés récupérées

  • Pour savoir si les propriétés Vitesse, Précision, Direction ou Altitude d'une variable de type géoPosition ont été renseignées lors de la récupération de la position, utilisez les propriétés VitesseValide, PrécisionValide, DirectionValide et AltitudeValide.
  • Pour réinitialiser une variable de type géoPosition, utilisez la fonction VariableRAZ.
  • Les informations de positionnement récupérées correspondent à la dernière position connue du périphérique : elles peuvent donc ne pas correspondre à la position actuelle du périphérique si par exemple le périphérique a été déplacé alors que le signal GPS n'était pas valide. Il est possible de connaître la date et l'heure à laquelle la position a été calculée grâce à la propriété DateMesure de la variable géoPosition.
  • Les propriétés Vitesse, Précision, Direction et Altitude seront renseignées uniquement si le fournisseur de localisation le permet (dans le cas contraire, elles prendront leur valeur par défaut).
Universal Windows 10 App

Notes

  • Les fonctions de géolocalisation peuvent consommer beaucoup de ressources sur le périphérique (batterie, bande passante, etc.). Il est conseillé de ne pas fixer de valeurs trop petites pour les paramètres de délai et de distance minimale entre deux notifications.
  • Pour ne plus recevoir de notifications, appelez la fonction GPSSuitDéplacement sans paramètre ou appelez la fonction GPSTermine.
Universal Windows 10 App

Fonctionnalité d'application requise

L'utilisation de cette fonction entraîne la déclaration d'une fonctionnalité d'application dans l'assistant de génération de l'application.
Fonctionnalité requise : Géolocalisation
Cette fonctionnalité permet aux applications d'accéder aux données de géolocalisation de l'appareil ou de l'ordinateur.
Attention : Spécificité Android 12 : Pour que la procédure appelée par la fonction GPSSuitDéplacement soit exécutée lorsque l'application est en arrière-plan, il est nécessaire de lancer un thread persistant (fonction ThreadPersistant).
Liste des exemples associés :
Android GPS Android (WINDEV Mobile) : Android GPS
[ + ] Cet exemple montre l'utilisation des fonctions GPS du WLangage dans une application Android.
Il permet de récupérer à intervalle régulier :
- La latitude
- La longitude
- L'altitude
- La vitesse
- la direction
WM Sports Exemples multiplateforme (WINDEV Mobile) : WM Sports
[ + ] Cet exemple est une application de sport vous permettant d'enregistrer vos performances.
L'application calcule la distance parcourue, le temps, la vitesse moyenne et le nombre de calories dépensées en fonction du sport pratiqué.
Le parcours réalisé est affiché sur un champ carte grâce à des marqueurs et un tracé d'itinéraire.
Si vous disposez d'une montre Apple Watch, vous pourrez piloter WM Sports avec votre montre !

L'exemple dispose aussi d'une partie serveur qui sert à la synchronisation des données des utilisateurs.
Ce webservice est disponible dans l'exemple WEBDEV "WW_Sports".
Composante : wd290java.dll
Version minimum requise
  • Version 15
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 30/11/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale