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
Demande à être notifié lorsque le périphérique arrive à proximité d'une position donnée.
Exemple
// Active la demande de notification
GPSDétectePosition(ProcDétection, 1.145258, 30.968745)
// Procédure appelée lors de la notification
PROCÉDURE ProcDétection(Entrée est un booléen)
SI Entrée = Vrai ALORS
	Info("Vous êtes arrivé à destination.")
FIN
Syntaxe
<Résultat> = GPSDétectePosition(<Procédure WLangage> , <Latitude> , <Longitude> [, <Rayon> [, <Délai>]])
<Résultat> : Entier
Identifiant de détection.
Cet identifiant est utilisé dans les cas suivants :
  • pour interrompre le mécanisme de notification. Il suffit de passer cet identifiant en paramètre à la fonction GPSArrêteDétection.
  • pour identifier la position traitée dans la procédure WLangage appelée (cas où une même procédure WLangage est utilisée pour traiter plusieurs positions).
<Procédure WLangage> : Nom de procédure
Nom de la procédure WLangage (également nommée "callback") appelée lorsque le périphérique entre ou sort de la région délimitée par les paramètres spécifiés.
Pour plus de détails sur cette procédure, consultez Paramètres de la procédure utilisée par la fonction GPSDétectePosition.
<Latitude> : Réel
Latitude de la position dont on veut détecter la proximité.
<Longitude> : Réel
Longitude de la position dont on veut détecter la proximité.
<Rayon> : Réel optionnel
Rayon (en mètres) autour de la position dont on veut détecter la proximité à partir duquel on souhaite être notifié.
Si ce paramètre n'est pas spécifié, le rayon autour de la position sera de 50 mètres.
<Délai> : Entier optionnel ou Durée optionnelle
Délai d'expiration (en centièmes de seconde) de l'alerte de proximité. Ce délai démarre à partir de l'appel de la fonction.
  • Si ce paramètre vaut -1 ou n'est pas spécifié, aucun délai d'expiration ne sera fixé.
  • Si ce délai est précisé, le mécanisme de notification s'arrête automatiquement lors de l'expiration du délai.
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).
Remarques

Cas particuliers

  • Pour ne plus recevoir de notifications, utilisez la fonction GPSTermine.
  • Pour arrêter la détection de la proximité d'une position spécifique ;
  • Il est possible de détecter la proximité de plusieurs positions en appelant la fonction GPSDétectePosition pour chacune des positions. Si une même procédure est appelée pour plusieurs positions, il est possible de différencier ces positions dans la procédure WLangage grâce au paramètre <Identifiant de détection>. Ce paramètre correspond au résultat de la fonction GPSDétectePosition.
  • Les mesures de position peuvent être plus ou moins approximatives en fonction des paramètres du fournisseur de localisation. Ainsi si le périphérique passe brièvement à proximité de la région surveillée, il se peut qu'aucune notification ne soit transmise. De la même manière, si le périphérique s'approche très près de la région surveillée sans y entrer, il se peut qu'une notification soit reçue.
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.
Classification Métier / UI : Code métier
Composante : wd300java.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