getCurrentPosition (référence de l’API client)

  • Article

Renvoie la position actuelle à l’aide de la fonctionnalité de géolocalisation de l’appareil.

Disponible pour

Cette méthode est uniquement prise en charge pour les clients mobiles.

Syntaxe

Xrm.Device.getCurrentPosition().then(successCallback, errorCallback)

Paramètres

Nom du paramètre Type Requise Description
successCallback Function Oui Fonction à appeler lorsque les informations de géolocalisation actuelles sont renvoyées. Un objet de géolocalisation est transmis à la fonction avec les valeurs suivantes :
- coords  : coordonnées : contient un ensemble de coordonnées géographiques avec la précision associée ainsi qu’un ensemble d’autres valeurs facultatives telles que l’altitude et la vitesse.
- timestamp  : Représente la date d’acquisition de l’objet qui est représentée en tant que DOMTimeStamp.
errorCallback Function Oui Fonction à appeler lorsque l’opération échoue. Un objet avec les propriétés suivantes est transmis :
- code  : Code d’erreur. Numéro.
- message  : message localisé décrivant les détails de l’erreur. Chaîne.

Si le paramètre d’emplacement de l’utilisateur n’est pas activé sur votre appareil mobile, le message d’erreur indique la même information. Si vous utilisez une version antérieure du client mobile des applications pilotées par modèle ou si la fonctionnalité de géolocalisation n’est pas disponible sur votre appareil mobile, la valeur null est passée au rappel d’erreur.

Valeur renvoyée

En cas de réussite, renvoie un objet de géolocalisation avec les valeurs spécifiées précédemment dans la fonction successCallback.

Exceptions

Voir Codes d’erreur du service Web

Remarques

Pour que la méthode getCurrentPosition puisse fonctionner, la fonctionnalité de géolocalisation doit être activée sur votre appareil, et les clients mobiles des applications pilotées par modèle doivent disposer d’autorisations pour accéder à l’emplacement de l’appareil, qui n’est pas activé par défaut.

Exemple

Xrm.Device.getCurrentPosition().then(
    function success(location) {
        Xrm.Navigation.openAlertDialog({
            text: "Latitude: " + location.coords.latitude +
            ", Longitude: " + location.coords.longitude
        });
    },
    function (error) {
        Xrm.Navigation.openAlertDialog({ text: error.message });
    }
);

Xrm.Device

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).