swan.chooseAddress
此 API 日后将被废弃,建议使用 button 组件实现相关功能。
解释: 调起用户编辑收货地址原生界面,并在编辑完成后返回用户选择的地址,使用该 API 需通过获取用户权限设置申请授权后方可对用户发起授权申请,可在需授权接口列表中查看相关错误码信息。
方法参数
Object object
object参数说明
属性名 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
success | Function | 否 | 返回用户选择的收货地址信息 | |
fail | Function | 否 | 接口调用失败的回调函数 | |
complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
success返回参数说明 :
参数名 | 类型 | 说明 | 最低版本 |
---|---|---|---|
userName | String | 收货人姓名 | |
postalCode | String | 邮编 | |
provinceCode | String | 国标收货地址第一级地址国家码 | 最低支持版本 3.90.4 |
provinceName | String | 国标收货地址第一级地址 | |
cityCode | String | 国标收货地址第二级地址国家码 | 最低支持版本 3.90.4 |
cityName | String | 国标收货地址第二级地址 | |
countyCode | String | 国标收货地址第三级地址国家码 | 最低支持版本 3.90.4 |
countyName | String | 国标收货地址第三级地址 | |
townCode | String | 国标收货地址第四级地址国家码 | 最低支持版本 3.90.4 |
townName | String | 国标收货地址第四级地址 | 最低支持版本 3.90.4 |
detailInfo | String | 详细收货地址信息 | |
telNumber | String | 收货人手机号码 | |
nationalCode | String | 收货地址国家码 |
示例
扫码体验
请使用百度APP扫码
图片示例
代码示例1 - 用户允许授权情况下 :
- 在 swan 文件中
<view class="wrap">
<button type="primary" bindtap="chooseAddress">chooseAddress</button>
</view>
- 在 js 文件中
Page({
chooseAddress() {
swan.chooseAddress({
success: res => {
console.log('chooseAddress success', res);
},
fail: err => {
console.log('chooseAddress fail', err);
}
});
}
});
代码示例2 - 用户在拒绝了一次授权情况下,仍可访问此api :
- 在 swan 文件中
<view class="wrap">
<button type="primary" bindtap="chooseAddress">chooseAddress</button>
</view>
- 在 js 文件中
Page({
chooseAddress() {
swan.chooseAddress({
success: res => {
console.log('chooseAddress success', res);
},
fail: err => {
if(errCode == 10003){
swan.openSetting({});
}
console.log('chooseAddress fail', err);
}
});
}
});