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);
            }
        });
    }
});