swan.chooseAddress

此 API 日后将被废弃,建议使用 button 组件实现相关功能。

解释: 调起用户编辑收货地址原生界面,并在编辑完成后返回用户选择的地址,使用该 API 需通过获取用户权限设置选择收货地址 swan.chooseAddress - 图1申请授权后方可对用户发起授权申请,可在需授权接口列表选择收货地址 swan.chooseAddress - 图2中查看相关错误码信息。

方法参数

Object object

object参数说明

属性名类型必填默认值说明
successFunction返回用户选择的收货地址信息
failFunction接口调用失败的回调函数
completeFunction接口调用结束的回调函数(调用成功、失败都会执行)

success返回参数说明 :

参数名类型说明最低版本
userNameString收货人姓名
postalCodeString邮编
provinceCodeString国标收货地址第一级地址国家码最低支持版本 3.90.4
provinceNameString国标收货地址第一级地址
cityCodeString国标收货地址第二级地址国家码最低支持版本 3.90.4
cityNameString国标收货地址第二级地址
countyCodeString国标收货地址第三级地址国家码最低支持版本 3.90.4
countyNameString国标收货地址第三级地址
townCodeString国标收货地址第四级地址国家码最低支持版本 3.90.4
townNameString国标收货地址第四级地址最低支持版本 3.90.4
detailInfoString详细收货地址信息
telNumberString收货人手机号码
nationalCodeString收货地址国家码

示例

扫码体验

选择收货地址 swan.chooseAddress - 图3请使用百度APP扫码

图片示例

选择收货地址 swan.chooseAddress - 图4

选择收货地址 swan.chooseAddress - 图5

选择收货地址 swan.chooseAddress - 图6

代码示例1 - 用户允许授权情况下 :

在开发者工具中预览效果

  • 在 swan 文件中
  1. <view class="wrap">
  2. <button type="primary" bindtap="chooseAddress">chooseAddress</button>
  3. </view>
  • 在 js 文件中
  1. Page({
  2. chooseAddress() {
  3. swan.chooseAddress({
  4. success: res => {
  5. console.log('chooseAddress success', res);
  6. },
  7. fail: err => {
  8. console.log('chooseAddress fail', err);
  9. }
  10. });
  11. }
  12. });

代码示例2 - 用户在拒绝了一次授权情况下,仍可访问此api :

在开发者工具中预览效果

  • 在 swan 文件中
  1. <view class="wrap">
  2. <button type="primary" bindtap="chooseAddress">chooseAddress</button>
  3. </view>
  • 在 js 文件中
  1. Page({
  2. chooseAddress() {
  3. swan.chooseAddress({
  4. success: res => {
  5. console.log('chooseAddress success', res);
  6. },
  7. fail: err => {
  8. if(errCode == 10003){
  9. swan.openSetting({});
  10. }
  11. console.log('chooseAddress fail', err);
  12. }
  13. });
  14. }
  15. });