# chooseLocation(Object object)

打开地图选择位置。
**注意事项**：注意事项：
- 调用前需要用户授权 `scope.userLocation`。了解如何授权，可查看[API 权限](https://open.feishu.cn/document/uYjL24iN/uITMuITMuITM)。
- 该 API 还需要用户在手机系统中给飞书客户端授予地理位置权限，位置精度和调用耗时会因设备而异。
- 因系统地图框架问题，该API在iOS 12不支持

## 支持说明

应用能力 | Android | iOS | PC | Harmony | 预览效果
---|---|---|---|---|---
小程序 | **✓** | **✓** | **X** | V7.35.0+ | 预览
网页应用 | V3.44.0+ | V3.44.0+ | **X** | V7.35.0+ | 预览

## 输入

该接口继承[标准对象输入](https://open.feishu.cn/document/uYjL24iN/ukzNy4SO3IjL5cjM)，无扩展属性。

## 输出

`success`返回对象的扩展属性：

名称 | 数据类型 | 描述
---|---|---
name | string | 位置名称
address | string | 详细地址（可能为空）
latitude | number | 纬度，浮点数，范围为-90~90，负数表示南纬。
longitude | number | 经度，浮点数，范围为-180~180，负数表示西经。
type | string | 坐标系类型。可能值：<br>- `wgs84`：wgs84 坐标系。<br>- `gcj02`：gcj02 坐标系。

## 示例代码

```js
tt.chooseLocation({
    "type": "gcj02",
    success(res) {
      console.log(JSON.stringify(res));
    },
    fail(res) {
      console.log(`chooseLocation fail: ${JSON.stringify(res)}`);
    }
});
```

`success`返回对象示例：
```json
{
    "longitude": "121.46181435590088",
    "name": "瑞金南路",
    "address": "瑞金南路",
    "latitude": "31.20728911127632",
    "errMsg": "chooseLocation:ok"
}
```