getCurrentPosition (referència de l'API del client)

Retorna la ubicació actual mitjançant la capacitat de geolocalització del dispositiu.

Disponible per a

Aquest mètode només s'admet per als clients mòbils.

Sintaxi

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

Paràmetres

Nom del paràmetre	Tipus	Necessari	Descripció
successCallback	Function	Sí	Funció per cridar quan es retorna la informació de geolocalització actual. Es passa un objecte de geolocalització amb els valors següents a la funció.: - coords: Conté un conjunt de coordenades geogràfiques juntament amb la precisió associada i un conjunt d'altres valors opcionals com ara altitud i velocitat. - timestamp: Representa l'hora en què s'ha adquirit l'objecte i es representa com a DOMTimeStamp.
errorCallback	Function	Sí	Una funció per cridar quan l'operació falla. Es passa un objecte amb les propietats següents: - code: El codi d'error. Número. - message: missatge localitzat que descriu els detalls de l'error. Corda. Si la configuració de la ubicació de l'usuari no està activada al dispositiu mòbil, el missatge d'error indica el mateix. Si utilitzeu una versió anterior del client mòbil d'aplicacions basades en models o si la capacitat de geolocalització no està disponible al dispositiu mòbil, null es passa a la devolució de trucada d'error.

Valor de retorn

En cas d'èxit, retorna un objecte de geolocalització amb els valors especificats anteriorment a la funció successCallback .

Excepcions

Vegeu Codis d'error del servei web

Observacions

Perquè el mètode getCurrentPosition funcioni, la capacitat de geolocalització ha d'estar habilitada al dispositiu mòbil i els clients mòbils d'aplicacions basades en models han de tenir permisos per accedir a la ubicació del dispositiu, que no està habilitada per defecte.

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 });
    }
);

Articles relacionats

Xrm.Dispositiu