获取当前地理位置信息（单次定位）

调用device.geolocation.get获取当前地理位置信息（单次定位）。

调试

访问JSAPI Explorer在线调试该接口。

使用说明

Android客户端返回坐标是高德坐标；

iOS客户端2.7.6及以后版本支持返回高德坐标；iOS客户端低于2.7.6版本仅支持返回标准坐标，如需使用高德坐标，可对返回的坐标做转换，具体请参考坐标转换APIDemo演示页面。

客户端	Android	iOS	PC
支持说明	支持	支持	不支持

dd.device.geolocation.get({
    targetAccuracy : Number,
    coordinate : Number,
    withReGeocode : Boolean,
    useCache:true, //默认是true，如果需要频繁获取地理位置，请设置false
    onSuccess : function(result) {
        /* 高德坐标 result 结构
        {
            longitude : Number,
            latitude : Number,
            accuracy : Number,
            address : String,
            province : String,
            city : String,
            district : String,
            road : String,
            netType : String,
            operatorType : String,
            errorMessage : String,
            errorCode : Number,
            isWifiEnabled : Boolean,
            isGpsEnabled : Boolean,
            isFromMock : Boolean,
            provider : wifi|lbs|gps,
            isMobileEnabled : Boolean
        }
        */
    },
    onFail : function(err) {}
});

参数说明

参数	类型	说明
targetAccuracy	Number	期望定位精度半径(单位米)，定位结果尽量满足该参数要求，但是不一定能保证小于该误差，开发者需要读取返回结果的 accuracy 字段校验坐标精度。

说明

建议按照业务需求设置定位精度，推荐采用200m，可获得较好的精度和较短的响应时长。|
|coordinate|Number|

1：获取高德坐标
0：获取标准坐标

说明

推荐使用高德坐标，标准坐标没有 address字段。|
|withReGeocode|Boolean|是否需要带有逆地理编码信息。

说明

该功能需要网络请求，请根据自己的业务场景使用。|
|useCache|Boolean|是否缓存地理位置信息。默认是true。

如果为true，客户端会对定位的地理位置信息缓存，在缓存期内 (2分钟) 再次定位会返回旧的定位。|

返回结果

参数	说明
longitude	经度。
latitude	纬度。
accuracy	实际的定位精度半径 (单位米)。
address	格式化地址，如：北京市朝阳区南磨房镇北京国家广告产业园区。

注意

如需返回该参数，请使用高德坐标并将withReGeocode参数设置为true。|
|province|省份，如：北京市。

注意

获取当前地理位置信息（单次定位）

调试#

使用说明#

参数说明#

返回结果#

调试

使用说明

参数说明

返回结果