# 地理位置 geolocation
# 导入模块
import geolocation from '@system.geolocation';
# geolocation.getLocation(OBJECT)
获取设备的地理位置。
- 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| timeout | number | 否 | 超时时间，单位为ms，默认值为180000。设置超时，是为了防止出现权限被系统拒绝、定位信号弱或者定位设置不当，导致请求阻塞的情况。超时后会使用fail回调函数。取值范围为32位正整数。如果设置值小于等于0，系统按默认值处理。 |
| coordType | string | 否 | 坐标系的类型，可通过getSupportedCoordTypes获取可选值，缺省值为wgs84。 |
| success | Function | 否 | 成功回调。 |
| fail | Function | 否 | 失败回调。 |
| complete | Function | 否 | 执行结束后的回调。 |
- success返回值
| 参数名 | 类型 | 说明 |
|---|---|---|
| longitude | number | 设备位置信息：经度。 |
| latitude | number | 设备位置信息：纬度。 |
| accuracy | number | 设备位置信息：精确度。 |
| time | number | 设备位置信息：时间。 |
- fail返回错误代码
| 错误码 | 说明 |
|---|---|
| 201 | 用户拒绝，获取定位权限失败 |
| 204 | 超时返回 |
- 示例
geolocation.getLocation({
success: function(data) {
console.log(
`handling success: longitude = ${data.longitude}, latitude = ${
data.latitude
}`
)
},
fail: function(data, code) {
console.log(`handling fail, code = ${code}`)
}
})
# geolocation.getSupportedCoordTypes()
获取设备支持的坐标系类型。
- 返回值
字符串数组，表示坐标系类型，如[wgs84, gcj02]。
- 示例
var types = geolocation.getSupportedCoordTypes();