getCurrentPosition (Bezeroaren APIaren erreferentzia)

Uneko kokalekua itzultzen du gailuaren geolokalizazio-gaitasuna erabiliz.

Horretarako erabilgarri

Metodo hau mugikorreko bezeroentzat soilik onartzen da.

Sintaxia

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

Parametroak

Parametroaren izena	Mota	Beharrezkoa	Deskribapenak
successCallback	Function	Bai	Uneko geolokalizazio-informazioa itzultzen denean deitzeko funtzioa. Balio hauek dituen geolokalizazio-objektu bat pasatzen zaio funtzioari: - coords: Koordenatu geografikoen multzo bat dauka, lotutako zehaztasunarekin batera eta aukerako beste balio batzuen multzo bat, hala nola altuera eta abiadura. - timestamp: Objektua eskuratu zen unea adierazten du, eta DOMTimeStamp gisa irudikatzen da.
errorCallback	Function	Bai	Eragiketan akats bat gertatzen denean deitzen zaion funtzioa. Propietate hauek dituen objektu bat pasatzen da: - code: Errore-kodea. Zenbakia. - message: Errorearen xehetasunak deskribatzen dituen mezu lokalizatua. Haria. Erabiltzailearen kokalekuaren ezarpena gailu mugikorrean gaituta ez badago, errore-mezuak gauza bera adierazten du. Model-driven apps mugikorreko bezeroaren aurreko bertsio bat erabiltzen ari bazara edo zure gailu mugikorrean geolokalizazio-gaitasuna erabilgarri ez badago, null errore-deiari pasatuko zaio.

Itzuli balioa

Arrakasta izanez gero, objektu bat itzultzen du successCallback funtzioan lehenago zehaztutako balioekin.

Salbuespenak

Ikusi web zerbitzuaren errore-kodeak

Oharrak

getCurrentPosition metodoak funtziona dezan, geolokalizazio-gaitasuna gailu mugikorrean gaituta egon behar da, eta modeloan oinarritutako aplikazio mugikorreko bezeroek gailuaren kokapenera sartzeko baimenak izan behar dituzte, lehenespenez gaituta ez dagoena.

Adibidez

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

Erlazionatutako artikuluak

Xrm.Device