Dijeli putem


getCurrentPosition (referenca klijentskog API-ja)

Vraća trenutnu lokaciju pomoću geolokacije uređaja.

Dostupno za

Ta je metoda podržana samo za mobilne klijente.

Sintaksa

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

Parametara

Naziv parametra Tip Obvezno Opis
successCallback Function Jest Funkcija koja se poziva kada se vraćaju aktualni podaci o geolokaci. Funkciji se prosljeđuje objekt geolokacije sa sljedećim vrijednostima.:
- coords: Sadrži skup zemljopisnih koordinata uz povezanu točnost i skup drugih neobaveznih vrijednosti kao što su visina i brzina.
- timestamp: predstavlja vrijeme kada je objekt nabavljeni i predstavljen kao DOMTimeStamp.
errorCallback Function Jest Funkcija za pozivanje kada operacija ne uspije. Prosljeđuje se objekt sa sljedećim svojstvima:
- code: kôd pogreške. Broj.
- message: Lokalizirana poruka s opisom detalja o pogrešci. Gudački.

Ako postavka lokacije korisnika nije omogućena na mobilnom uređaju, poruka o pogrešci naznačuje isto. Ako koristite stariju verziju mobilnog klijenta aplikacija utemeljenih na modelu ili ako mogućnost geolokacije nije dostupna na mobilnom uređaju, povratnim pozivom o pogrešci prosljeđuje se vrijednost null.

Povratna vrijednost

Pri uspjehu vraća objekt geolokacije s vrijednostima navedenima ranije u funkciji successCallback .

Iznimke

Pogledajte kodove pogrešaka web-servisa

Primjedbe

Da bi metoda getCurrentPosition funkcionirala, mogućnost geolokacije mora biti omogućena na mobilnom uređaju, a mobilni klijenti aplikacija utemeljeni na modelu moraju imati dozvole za pristup lokaciji uređaja, što nije omogućeno po zadanom.

Primjer

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.Uređaj