DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE
Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de géolocalisation
  • Gestion des blocages
  • Propriétés récupérées
  • 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
Récupère les informations sur la position actuelle du périphérique.
Universal Windows 10 App La fonction GPSRécupèrePosition doit être exécutée dans un thread.
Exemple
MaPosition est une géoPosition
MaPosition = GPSRécupèrePosition()
// Vérifie validité de la position avec ErreurDétectée
SI ErreurDétectée ALORS RETOUR
Info(" Latitude : " + MaPosition.Latitude) 
Info(" Longitude : " + MaPosition.Longitude)
Syntaxe
WINDEVUniversal Windows 10 App

Récupération des informations sur un périphérique (mobile, ...) Masquer les détails

<Résultat> = GPSRécupèrePosition([<Timeout> [, <Message>]])
<Résultat> : Variable de type géoPosition
Variable de type géoPosition contenant les informations sur la position du périphérique. Si la position est invalide, la variable ErreurDétectée vaut Vrai et le détail de l'erreur peut être obtenu avec la fonction ErreurInfo.
<Timeout> : Entier optionnel ou Durée optionnelle
Délai maximal (en centièmes de seconde) d'attente pour la mise à jour de la position du périphérique.
  • Si ce délai est écoulé avant que la position du périphérique n'ait été mise à jour, une erreur se produit. Cette erreur peut être détectée grâce à la variable ErreurDétectée et le détail de l'erreur peut être obtenu avec la fonction ErreurInfo.
  • Si ce paramètre n'est pas spécifié, le délai est de 1 minute.
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).
<Message> : Chaîne de caractères optionnelle
Message du sablier affiché pendant la mise à jour de la position.
Remarque : Ce paramètre est pris en compte uniquement si l'appel est effectué dans le thread principal de l'application.
WINDEVUniversal Windows 10 App Ce paramètre n'est pas pris en compte.
Remarques

Gestion des blocages

La fonction GPSRécupèrePosition est bloquante jusqu'à ce que la position actuelle de l'appareil ait pu être déterminée ou que le délai d'attente fixé par le paramètre <Timeout> ait expiré.
Si la fonction est appelée dans le thread principal de l'application, un sablier sera affiché durant l'exécution de la fonction. Le message affiché par le sablier peut être spécifié grâce au paramètre <Message>.
Dans le cas contraire, l'exécution du thread secondaire sera bloquée durant l'exécution de la fonction et aucun sablier ne sera affiché.
Remarque : Pour connaître la dernière position connue de l'appareil sans délai d'attente, utilisez la fonction GPSDernièrePosition. Attention, les informations de positionnement récupérées peuvent 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 de type géoPosition.
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

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.
Classification Métier / UI : Code métier
Composante : wd300java.dll
Voir Aussi
Version minimum requise
  • Version 15
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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