Dalintis per


getCurrentPosition (kliento API nuoroda)

Grąžina dabartinę vietą naudodama įrenginio geografinės vietos galimybę.

Galima naudoti

Šis metodas palaikomas tik mobiliesiems klientams.

Sintaksė

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

Parametrus

Parametro pavadinimas Rūšis Privalomas Aprašą
successCallback Funkcija Taip Funkcija, iškviečianti, kai grąžinama dabartinė geografinės vietos informacija. Funkcijai perduodamas geografinės vietos objektas su šiomis reikšmėmis.:
- coords: apima geografinių koordinačių rinkinį kartu su susijusiu tikslumu ir kitų pasirinktinių reikšmių, pvz., aukščio ir greičio, rinkinį.
- timestamp: nurodo laiką, kada objektas buvo įsigytas ir vaizduojamas kaip DOMTimeStamp.
errorCallback Funkcija Taip Funkcija, kurią reikia iškviesti, kai operacija nepavyksta. Perduotas objektas su šiomis ypatybėmis:
- code: klaidos kodas. Numeris.
- message: Lokalizuotas pranešimas, kuriame aprašoma išsami klaidos informacija. Eilutės.

Jei vartotojo vietos nustatymo parametras jūsų mobiliajame įrenginyje neįgalintas, klaidos pranešimas nurodo tą patį. Jei naudojate ankstesnę modeliu pagrįstų programėlių mobiliųjų įrenginių kliento versiją arba jei jūsų mobiliajame įrenginyje geografinės vietos galimybių nėra, atgalinis klaidos iškvietimas perduodamas nuliui.

Grąžinimo reikšmė

Sėkmingai grąžins geografinės vietos objektą su reikšmėmis, nurodytomis anksčiau funkcijoje successCallback .

Išimtys

Žr . žiniatinklio tarnybos klaidų kodus

Pastabos

Kad getCurrentPosition metodas veiktų, mobiliajame įrenginyje turi būti įgalinta geografinės vietos funkcija, o modeliu pagrįstos programėlės mobiliesiems klientams turi turėti teises pasiekti įrenginio buvimo vietą, kuri nėra įgalinta pagal numatytuosius parametrus.

Pavyzdžiui

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