DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de géolocalisation
  • Cas particuliers
  • Permissions requises
  • 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
Renvoie les informations sur le fournisseur de localisation utilisé par l'application pour les fonctions de géolocalisation.
Exemple
Universal Windows 10 AppAndroidWidget Android
// Test du type de fournisseur utilisé
SI GPSInfo(gpsType) = gpsSatellite ALORS
Info("La géolocalisation du téléphone utilise le système GPS.")
FIN
SI GPSInfo(gpsVitesse) = Faux ALORS
Erreur("La vitesse de déplacement du téléphone ne peut pas être déterminée.")
FIN
Syntaxe
<Résultat> = GPSInfo(<Information>)
<Résultat> : Variant
Information demandée en fonction du paramètre <Information>.
<Information> : Constante de type Entier
Type d'information demandée.
gpsAltitudeAltitude du périphérique disponible.<Résultat> correspondra à :
  • Vrai si le fournisseur de localisation permet de connaître l'altitude du périphérique,
  • Faux dans le cas contraire ou si aucun fournisseur de localisation n'a été trouvé.
gpsDirectionDirection du déplacement du périphérique disponible.<Résultat> correspondra à :
  • Vrai si le fournisseur de localisation permet de connaître la direction du déplacement du périphérique,
  • Faux dans le cas contraire ou si aucun fournisseur de localisation n'a été trouvé.
gpsEnergieConsommation d'énergie requise par le fournisseur.<Résultat> correspondra à :
  • gpsEnergieFaible : Le fournisseur doit requérir une faible quantité d'énergie.
  • gpsEnergieMoyenne : Le fournisseur peut requérir une quantité moyenne d'énergie.
  • gpsEnergieElevée : Le fournisseur peut requérir une quantité d'énergie élevée.
gpsPrécisionPrécision de la mesure de position effectuée par le fournisseur.<Résultat> correspondra à :
  • gpsPrécisionElevée : calcul de la position avec une précision élevée.
  • gpsPrécisionFaible : calcul de la position avec une précision faible.
gpsTypeType du fournisseur de localisation.<Résultat> correspondra à :
  • gpsSatellite : fournisseur de localisation par le réseau de satellites GPS.
  • gpsRéseau : fournisseur de localisation par le réseau des antennes mobiles ou Wi-Fi.
  • 0 si le type du fournisseur de localisation n'a pas été déterminé.
WINDEV Cette constante n'est pas disponible.
gpsVitesseVitesse de déplacement du périphérique disponible.<Résultat> correspondra à :
  • Vrai si le fournisseur de localisation permet de connaître la vitesse de déplacement du périphérique,
  • Faux dans le cas contraire ou si aucun fournisseur de localisation n'a été trouvé.
Remarques

Cas particuliers

  • Il est conseillé d'initialiser les paramètres du fournisseur de localisation à l'aide de la fonction GPSInitParamètre avant de récupérer les informations de ce fournisseur.
  • L'état d'activation du fournisseur de localisation peut être connu grâce à la fonction GPSEtat.
AndroidWidget Android

Permissions requises

L'utilisation de cette fonction entraîne la modification des permissions requises par l'application.
Permission requise : ACCESS_FINE_LOCATION.
Spécificité Android 11 : L'utilisation de cette fonction nécessite la mise en place de la permission ACCESS_BACKGROUND_LOCATION permettant la localisation de l'appareil.
Cette permission permet d'autoriser l'utilisation de la fonction lorsque l'application est en arrière-plan.
Si l'application nécessite la localisation en arrière-plan, il faut :
  • Ajouter manuellement la permission "ACCESS_BACKGROUND_LOCATION" dans l'assistant de génération de l'application Android.
  • Demander explicitement la permission de localisation en arrière-plan à l'utilisateur avec la fonction PermissionDemande. Par exemple :
    PermissionDemande(permLocalisationEnArrièrePlan, Callback)
    PROCÉDURE INTERNE Callback(p est une Permission)
    SI p.Accordé ALORS
    // Utilisation possible des fonctions nécessitant la localisation en arrière-plan
    FIN
    FIN
Une fenêtre permet à l'utilisateur de :
  • accepter l'accès à la position de l'appareil avec l'application en arrière-plan,
  • limiter l'accès à la position à l'application active,
  • refuser l'accès à la position.
L'utilisateur peut également modifier son autorisation à posteriori dans les réglages de Android.
Remarques :
  • Respectez les spécifications Google concernant les applications utilisant la localisation en arrière-plan. Pour plus de détails, consultez https://support.google.com/googleplay/android-developer/answer/9799150. Si ces conditions ne sont pas remplies (notamment les conditions d'information de l'utilisateur), les applications pourront ne pas obtenir l'autorisation de publication sur Play Store.
  • La demande de permission de localisation en arrière-plan ne doit être effectuée que si la permission de localisation a été accordée. Dans le cas contraire, la fonction PermissionDemande échouera.
  • Si le choix de l'utilisateur lors de la demande de permission de localisation en arrière-plan est plus restrictif que le choix effectué lors de la demande de permission de localisation, l'application sera automatiquement relancée.
  • Sur les appareils en version inférieure à Android 10, si la permission de localisation a été accordée à l'application, la demande de permission de localisation en arrière-plan sera accordée sans affichage de fenêtre.
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.
Composante : wd290java.dll
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