my.getaddress(object object)
基础库 1.20.4 或更高版本； 且 支付宝客户端 10.1.75 或更高版本； 若版本较低，建议采取 兼容处理 。
支小宝客户端 支持
安诊儿客户端 支持
主体： 企业支付宝小程序
获取用户收货地址。
接口调用时会弹出用户已录入的收货地址列表供其选择，返回选中的项。若用户从未录入过收货地址，会提示新增收货地址。
object object
查看示例
| 属性 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| success | function | - | 否 | 调用成功的回调函数 |
| fail | function | - | 否 | 调用失败的回调函数 |
| complete | function | - | 否 | 调用结束的回调函数（调用成功、失败都会执行） |
success 回调函数
参数
object res
查看示例
| 属性 | 类型 | 描述 | |||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| resultstatus | string | 结果码 |
|||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||
| result | object | 结果详情 |
|||||||||||||||||||||||||||||||
|
my.getaddress(object object)
success 参数
my.getaddress({
success: function(res) {
console.log(res);
},
fail: function(err) {
console.log(err);
}
});
{
"result": {
"address": "飞天园区", // 用户新增的地址不返回省市区信息，只返回用户手动填写的详细信息
"area": "西湖区",
"city": "杭州市",
"country": "中国",
"fullname": "测试号",
"mobilephone": "11111111111",
"prov": "浙江省",
"latitude": "30.132317",
"longitude": "120.080074",
"citycode": "330106"
"street": ""
},
"resultstatus": "9000"
}
``-
tip选中的收货地址信息里 street 字段为历史遗留，值恒为空，忽略即可。
-
tip用户也可通过 支付宝“我的” -> 点击“头像” -> 我的档案 ->地址薄 进入收货地址列表页面并进行管理。
q：my.getaddress 能否返回省市编码？
a：
未提供此能力，需要开发者自己用名称匹配。