GPSDétectePosition (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de géolocalisation

Cas particuliers
Permissions requises
Fonctionnalité d'application requise

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

GPSDétectePosition (Fonction)

En anglais : GPSDetectPosition

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 ;
- renvoyez Faux dans la procédure WLangage associée,
- utilisez la fonction GPSArrêteDétection.
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.

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.

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