getCurrentPosition (kliendi API viide)

Tagastab praeguse asukoha, kasutades seadme asukoha määramise funktsiooni.

Saadaval:

Seda meetodit toetatakse ainult mobiiliklientide puhul.

Süntaks

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

Parameetrid

Parameetri nimi	Liik	Nõutav	Kirjeldus
successCallback	Function	Jah	Funktsioon, mis helistab praeguse asukohateabe tagastamisel. Funktsioonile edastatakse järgmiste väärtustega asukoha määramise objekt. - coords: Sisaldab geograafiliste koordinaatide kogumit koos sellega seotud täpsusega ja muude valikuliste väärtuste kogumiga, nagu kõrgus ja kiirus. - timestamp: Tähistab objekti hankimise aega ja seda esitatakse DOMTimeStampina.
errorCallback	Function	Jah	Funktsioon, mida kutsuda, kui toiming nurjub. Edastatakse järgmiste atribuutidega objekt: - code: Tõrkekood. Arv. - message: Lokaliseeritud sõnum, mis kirjeldab tõrke üksikasju. String. Kui kasutaja asukoha säte pole mobiilsideseadmes lubatud, näitab tõrketeade sama. Kui kasutate mudelipõhiste rakenduste mobiilikliendi varasemat versiooni või kui asukoha tuvastamise funktsioon pole mobiilsideseadmes saadaval, edastatakse tõrke tagasikutsumisele tühiväärtus.

Tagastatav väärtus

Õnnestumisel tagastab asukoha määramise objekti, mille väärtused on funktsioonis successCallback varem määratud.

Erandid

Vaadake veebiteenuse tõrkekoode

Märkused

Meetodi getCurrentPosition toimimiseks peab asukoha määramise funktsioon olema mobiilsideseadmes lubatud ja mudelipõhistel rakendustel peavad olema seadme asukohale juurdepääsu õigused, mis pole vaikimisi lubatud.

Näide

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

Seotud artiklid

Xrm.Device