getCurrentPosition (sklic na API odjemalca)

Vrne trenutno mesto z zmogljivostjo geolokacije naprave.

Na voljo za

Ta način je podprt le za mobilne odjemalce.

Sintaksa

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

Parametri

Ime parametra	Vrsta	Zahtevano	Description
successCallback	Function	Da	Funkcija, ki pokliče, ko so vrnjene trenutne geolokacijske informacije. Geolokacijska funkcija funkciji poda geolokacijske predmete s temi vrednostmi.: - coords: vsebuje nabor geografskih koordinat skupaj s povezano natančnostjo in naborom drugih izbirnih vrednosti, kot sta nadmorska višina in hitrost. - timestamp: Predstavlja čas, ko je bil predmet pridobljen in predstavljen kot DOMTimeStamp.
errorCallback	Function	Da	Funkcija, ki jo pokličete, ko operacija ne uspe. Podan je predmet s temi lastnostmi: - code: Koda napake. številka. - message: Lokalizirano sporočilo, ki opisuje podrobnosti o napaki. Niz. Če nastavitev lokacije uporabnika v prenosni napravi ni omogočena, sporočilo o napaki označuje enako. Če uporabljate starejšo različico mobilnega odjemalca aplikacij, ki temeljijo na modelu, ali če zmogljivost geolokacije ni na voljo v prenosni napravi, je povratnim klicem napake posredovana ničelna vrednost.

Vrednost vračila

Ob uspehu vrne geolokacijska predmet z vrednostmi, ki so določene prej v funkciji successCallback .

Izjeme

Oglejte si kode napak spletne storitve

Pripombe

Če želite, da način getCurrentPosition deluje, mora biti v prenosni napravi omogočena geolokacijska zmogljivost, mobilni odjemalci z modelom pa morajo imeti dovoljenja za dostop do lokacije naprave, ki privzeto ni omogočena.

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

Povezani članki

Xrm.Device