getCurrentPosition (справка за API на клиент)

Връща текущото местоположение с помощта на възможността за геопозициониране на устройството.

Налично за

Този метод се поддържа само за мобилни клиенти.

Синтаксис

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

Параметри

Име на параметъра	Вид	Необходимо	Описание
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