Поделиться через

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

Возвращает текущее расположение с помощью возможности географического расположения устройства.

Доступно для

Этот метод поддерживается только для мобильных клиентов.

Синтаксис

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

Параметры

Имя параметра Тип Обязательно Description
successCallback Функция Да Функция для вызова при возврате текущей информации о географическом расположении. Объект геолокации со следующими значениями передается функции.:
- coords: содержит набор географических координат вместе с связанной точностью и набором других необязательных значений, таких как высота и скорость.
- timestamp: представляет время получения объекта и представляется как DOMTimeStamp.
errorCallback Функция Да Функция, вызываемая при сбое операции. Передается объект со следующими свойствами:
- code: код ошибки. Номер.
- message: локализованное сообщение, описывающее сведения об ошибке. Струна.

Если параметр расположения пользователя не включен на мобильном устройстве, сообщение об ошибке указывает на то же самое. Если вы используете более раннюю версию мобильного клиента приложений, управляемых моделью, или если возможность географического расположения недоступна на мобильном устройстве, значение NULL передается обратному вызову ошибки.

Возвращаемое значение

При успешном выполнении возвращает объект географического расположения со значениями, указанными ранее в функции successCallback .

Exceptions

См . коды ошибок веб-службы

Замечания

Чтобы метод getCurrentPosition работал, возможность географического расположения должна быть включена на мобильном устройстве, а мобильные клиенты на основе модели должны иметь разрешения на доступ к расположению устройства, которое по умолчанию не включено.

Example

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