getCurrentPosition (Client API reference)

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

Dostupno za

Ovaj metod je podržan samo za mobilne klijente.

Sintaksa

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

Parametri

Ime parametra Tip Potrebne Opis
successCallback Function Da Funkcija koju treba pozvati kada se daju trenutne informacije o geolokaciji. Funkciji se prosleđuje objekat geolokacije sa sledećim vrednostima.:
- coords: Sadrži skup geografskih koordinata zajedno sa povezanom preciznošću i skupom drugih opcionalnih vrednosti kao što su visina i brzina.
- timestamp: Predstavlja vreme kada je objekat preuzet i predstavljen kao DOMTimeStamp.
errorCallback Function Da Funkcija za pozivanje kada operacija ne uspe. Prosleđen je objekat sa sledećim svojstvima:
- code: Kôd greške. Broj.
- message: Lokalizovana poruka koja opisuje detalje o grešci. Niske.

Ako postavka korisničke lokacije nije omogućena na mobilnom uređaju, poruka o grešci ukazuje na isto. Ako koristite stariju verziju mobilnog klijenta aplikacija zasnovanog na modelu ili ako mogućnost geolokacije nije dostupna na mobilnom uređaju, povratnom pozivu se prosleđuje bez vrednosti.

Povratna vrednost

Prilikom uspeha vraća objekat geolokacije sa vrednostima navedenim ranije u funkciji successCallback .

Izuzetaka

Pogledajte kôd greške veb usluge

Primedbe

Da bi metod getCurrentPosition funkcionisao, mogućnost geolokacije mora da bude omogućena na mobilnom uređaju, a mobilni klijenti aplikacija koje posjeduju model moraju da imaju dozvole za pristup lokaciji uređaja, što nije podrazumevano omogućeno.

Primer

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