获取收货地址
======

#### 场景介绍

当应用需要获取用户收货地址时，可使用Account Kit提供的获取收货地址的能力，引导用户添加或选择已有的收货地址，并最终获取用户的收货地址。以下对Account Kit提供的获取收货地址能力进行介绍，获取收货地址功能还可使用场景化控件[选择收货地址Button](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/scenario-fusion-button-ship-to)进行实现。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/db/v3/kk8wIZG0SKe09QAawlxnuQ/zh-cn_image_0000002625188417.png?HW-CC-KV=V1&HW-CC-Date=20260612T073548Z&HW-CC-Expire=86400&HW-CC-Sign=EA5510718AD30D9E7367B70C151C63097CBB350B795D87533AD516D10747AB93 "点击放大")

#### 约束与限制

1.  收货地址中的手机号信息仅支持输入中国境内（香港特别行政区、澳门特别行政区、中国台湾除外）手机号、地址信息只支持填写中国境内（香港特别行政区、澳门特别行政区、中国台湾除外）。
    
2.  获取收货地址的能力支持Phone、Tablet、PC/2in1设备。并且从26.0.0版本开始，新增支持TV、Car设备。
    

#### 业务流程

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/66/v3/ZvKb5L7vSMqe-rloGBgkow/zh-cn_image_0000002625108561.png?HW-CC-KV=V1&HW-CC-Date=20260612T073548Z&HW-CC-Expire=86400&HW-CC-Sign=799AB41089ECA28D31CB0C2486655BADBB49F39ABC500D07B766DD79E9CA2776)

流程说明：

1.  用户需要使用收货地址时，应用程序调用选择收货地址API，打开华为账号收货地址管理页面。
    
2.  用户可以在收货地址管理页面添加新的收货地址或者选择已有收货地址，点击确认后，选择的收货地址将返回给应用。
    

#### 接口说明

获取收货地址关键接口如下表所示，具体API说明详见[API参考](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/account-choose-address)。

| 接口名 | 描述 |
| :-- | :-- |
| [chooseAddress](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/account-choose-address#chooseaddress)(context: [common.Context](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-ability-common#context)): Promise<[AddressInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/account-choose-address#addressinfo)\> | 拉起收货地址管理页面并返回用户所选择的收货地址。 |

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/db/v3/x0U0xtqUSQmt4R1Sl6kXkw/caution_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073548Z&HW-CC-Expire=86400&HW-CC-Sign=C77F81916F3B19C48A08ED240031D9CC9AE38E6468F4DF449B37A994988F1860)

上述接口需在页面或自定义组件生命周期内调用。

#### 开发前提

在进行代码开发前，请先确认以下准备工作是否完成：

1、是否完成[申请账号权限](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/account-config-permissions)，未申请通过调用获取收货地址API，将返回[1008100005 应用未申请对应permissions权限](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-account-kit#section1008100005-应用未申请对应permissions权限)错误码，无法获取收货地址。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ec/v3/LUoeFlYbQ86UaTTY3-ZRYg/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073548Z&HW-CC-Expire=86400&HW-CC-Sign=A0066E529CF1B248BAABC1CB0A9307E10C791FB4ABD1EA4038912AAAA59C34BC)

如果在权限申请前已完成“配置签名和指纹”，则需要重新[申请调试Profile](https://developer.huawei.com/consumer/cn/doc/app/agc-help-debug-profile-0000002248181278)，并重新[手动配置签名信息](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)。

2、是否完成[配置签名和指纹](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/account-sign-fingerprints)、[配置Client ID](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/account-client-id)，未配置调用获取收货地址API，将返回 [1008100004 应用指纹证书校验失败](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-account-kit#section1008100004-应用指纹证书校验失败)错误码，无法获取收货地址。

#### 开发步骤

1.  导入[shippingAddress](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/account-choose-address)模块及相关公共模块。
    
    import { shippingAddress } from '@kit.AccountKit';
    import { hilog } from '@kit.PerformanceAnalysisKit';
    import { BusinessError } from '@kit.BasicServicesKit';
    
2.  调用[chooseAddress](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/account-choose-address#chooseaddress)方法打开收货地址管理页面，引导用户添加或选择收货地址后，应用即可获取用户收货地址。
    
    // 执行请求
    try {
      // 此示例为代码片段，实际需在自定义组件实例中使用，并传入有效的Context上下文对象
      shippingAddress.chooseAddress(this.getUIContext().getHostContext())
        .then((data: shippingAddress.AddressInfo) => {
          hilog.info(0x0000, 'testTag', 'Succeeded in choosing address.');
          const userName: string = data.userName;
          const mobileNumber: string = data.mobileNumber;
          const countryCode: string = data.countryCode;
          const provinceName: string = data.provinceName;
          const cityName: string = data.cityName;
          const districtName: string = data.districtName;
          const streetName: string = data.streetName;
          const detailedAddress: string = data.detailedAddress;
          // 开发者处理获取的收货地址信息
          // ...
        }).catch((error: BusinessError) => {
        // ...
        dealAllError(error);
      });
    } catch (error) {
      // ...
      dealAllError(error);
    }
    
    // 错误处理
    function dealAllError(error: BusinessError): void {
      hilog.error(0x0000, 'testTag', \`Failed to chooseAddress. Code: ${error.code}, message: ${error.message}\`);
    }