通过

getCurrentPosition （客户端 API 参考）

使用设备地理位置功能返回当前位置。

适用于

仅移动客户端支持此方法。

Syntax

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

参数

参数名称 类型 必选 Description
successCallback 功能 是的 返回当前地理位置信息时要调用的函数。 将具有以下值的地理位置对象传递给函数：
- coords：包含一组地理坐标以及关联的准确性和一组其他可选值，例如海拔和速度。
- timestamp：表示获取对象的时间，并表示为 DOMTimeStamp。
errorCallback 功能 是的 作失败时要调用的函数。 传递具有以下属性的对象：
- code：错误代码。 数字。
- message：描述错误详细信息的本地化消息。 String.

如果未在移动设备上启用用户位置设置，则错误消息指示相同。 如果使用的是早期版本的模型驱动应用移动客户端，或者移动设备上没有地理位置功能，则将 null 传递给错误回调。

返回值

成功后，返回具有 successCallback 函数前面指定的值的地理位置对象。

例外

请参阅 Web 服务错误代码

注解

若要使 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