getCurrentPosition (Клиент API анықтамасы)

Құрылғының геолокациялық орналасу мүмкіндігін пайдаланып ағымдағы орынды қайтарады.

Қол жетімді

Бұл әдіс тек мобильді клиенттерге ғана қолдау көрсетіледі.

Синтаксис

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

Параметрлер

Параметр атауы	РаT�	Талап етіледі	Сипаттама
successCallback	Function	Иә	Ағымдағы геолокация ақпараты қайтарылған кезде шақырылатын функция. Геолокациялық нысан келесі мәндері бар функцияға беріледі: - coords: Географиялық координаттар жиынтығы, сонымен қатар байланысты дәлдікпен және биіктік пен жылдамдық сияқты басқа қосымша мәндер жиынтығын қамтиды. - timestamp: Объектіні сатып алған және DOMTimeStamp ретінде ұсынылған уақытты білдіреді.
errorCallback	Function	Иә	Операция істен шыққанда қоңырау шалу функциясы. Келесі қасиеттері бар нысан беріледі: - code: Қате коды. Сан. - message: Қате туралы мәліметтерді сипаттайтын локализацияланған хабарлама. Жол. Егер мобильді құрылғыда пайдаланушының орналасқан жері параметрі қосылмаса, қате туралы хабарлама дәл солай көрсетеді. Егер үлгіге негізделген бағдарламалар мобильді клиентінің алдыңғы нұсқасын пайдалансаңыз немесе мобильді құрылғыда геолокация мүмкіндігі қол жетімді болмаса, қате қоңырауына null жіберіледі.

Қайтаратын мән

Сәтті болғанда, successCallback функциясында бұрын көрсетілген мәндері бар геолокация нысаны қайтарады.

Ерекшеліктер

Веб-қызметтің қате кодтарын қараңыз

Ескертулер

getCurrentPosition әдісі жұмыс істеуі үшін мобильді құрылғыда геолокация мүмкіндігі қосылуы керек, ал модельге негізделген бағдарламалардың мобильді клиенттерінде әдепкі бойынша қосылмаған құрылғының орналасқан жеріне кіру рұқсаттары болуы керек.

Мысал

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