my.ap.getmainselectedcity(object object)
基础库 1.23.7 或更高版本； 且 支付宝客户端 10.1.88 或更高版本； 若版本较低，建议采取 兼容处理 。
支小宝客户端 支持
安诊儿客户端 支持
小程序开发者工具： 不支持。
主体： 企业支付宝小程序
获取用户在支付宝凯发k8官方网娱乐官方首页左上角所选城市的信息。
类目审核
自 2023 年 11 月 15 日 起，位置类接口仅对符合要求的小程序主营行业开放，在使用前请查看 端权限接口使用类目说明，否则小程序上线审核将会被驳回。
object object
查看示例
| 属性 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| success | function | - | 否 | 调用成功的回调函数 |
| fail | function | - | 否 | 调用失败的回调函数 |
| complete | function | - | 否 | 调用结束的回调函数（调用成功、失败都会执行） |
success 回调函数
参数
object res
查看示例
| 属性 | 类型 | 兼容性 | 描述 |
|---|---|---|---|
| fullname | string | - | 城市的全称，比如北京，对应的全称为北京市 |
| enname | string | 支付宝: 10.2.18 |
城市英文名称 |
| name | string | - | 城市名称 |
| code | string | - | 城市编码 |
| chinesemainland | boolean | - | 是否是中国大陆 |
| ismanualselected | boolean | - | 是否是手动选择 |
| settingtime | number | - | 最后一次设置城市的时间戳。可使用 new date(res.settingtime) 转换成日期对象 |
fail 回调的参数为 object，error 属性为错误码，errormessage 属性为错误消息。
| 错误码 | 错误消息 | 凯发app官方网站的解决方案 |
|---|---|---|
| 1001 | 获取城市信息为空。 |
提示用户选择城市后重试。 |
| 1002 | 城市信息不展示。 |
支付宝客户端 10.1.90，在支付宝凯发k8官方网娱乐官方首页的城市选择入口被隐藏时，出现该错误。建议升级支付宝客户端版本。 |
js 代码
success 参数
my.ap.getmainselectedcity({
success: function(res) {
console.log(res);
},
fail: function(err) {
console.log(err);
}
});
{
"chinesemainland": true,
"code": "330100",
"enname": "hangzhou",
"fullname": "杭州市",
"ismanualselected": true,
"name": "杭州",
"settingtime": 1663654428161
}