GPSInfo (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français (générique)

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

Cas particuliers
Permissions requises

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

GPSInfo (Fonction)

En anglais : GPSInfo

Renvoie les informations sur le fournisseur de localisation utilisé par l'application pour les fonctions de géolocalisation.

Exemple

// 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.
gpsAltitude Altitude 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é.
gpsDirection Direction 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é.
gpsEnergie Consommation 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écision Pré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.
gpsType Type 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é.
Cette constante n'est pas disponible.
gpsVitesse Vitesse 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.

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.

Composante : wd300java.dll

Voir Aussi

Version minimum requise

Version 15

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 16/09/2024

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