getCurrentPosition (referință API client)

Returnează locația curentă utilizând capacitatea de localizare geografică a dispozitivului.

Disponibil pentru

Această metodă este acceptată doar pentru clienții mobili.

Sintaxă

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

Parametri

Nume parametru	Tip	Obligatoriu	Descriere
successCallback	Funcţie	Da	O funcție de apelat atunci când se returnează informațiile curente despre locație geografică. Un obiect de locație geografică cu următoarele valori este transmis funcției.: - coords: Conține un set de coordonate geografice, împreună cu acuratețea asociată și un set de alte valori opționale, cum ar fi altitudinea și viteza. - timestamp: Reprezintă ora la care a fost achiziționat obiectul și este reprezentat ca DOMTimeStamp.
errorCallback	Funcţie	Da	O funcție de apelat atunci când operațiunea eșuează. Se transmite un obiect cu următoarele proprietăți: - code: Codul de eroare. Număr. - message: Mesaj localizat care descrie detaliile erorii. Șir. Dacă setarea de locație a utilizatorului nu este activată pe dispozitivul mobil, mesajul de eroare indică același lucru. Dacă utilizați o versiune anterioară a clientului mobil de aplicații bazate pe modele sau dacă capacitatea de localizare geografică nu este disponibilă pe dispozitivul mobil, se transmite nul la apelarea inversă a erorii.

Valoarea returnată

La succes, returnează un obiect de locație geografică cu valorile specificate anterior în funcția successCallback .

Excepții

Vedeți codurile de eroare ale serviciului Web

Remarci

Pentru ca metoda GetCurrentPosition să funcționeze, capacitatea de localizare geografică trebuie să fie activată pe dispozitivul mobil, iar aplicațiile mobile bazate pe modele trebuie să aibă permisiuni pentru a accesa locația dispozitivului, care nu este activată în mod implicit.

Exemplu

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

Articole asociate

Xrm.Device