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

  • Last updated on