Skip to content

address ​

地址管理

概述 ​

k.commerce.address 提供地址相关操作,用于获取国家、省份、城市等地理信息。

countries() ​

获取所有国家信息。

参数:无。

ts
k.api.get(() => {
    const countries = k.commerce.address.countries()
    return { count: countries.length, items: countries.slice(0, 3) }
})

返回: Country[]

provinces() ​

根据国家名称获取省份列表。

ts
k.api.get(() => {
    const provinces = k.commerce.address.provinces('China')
    return { count: provinces.length, items: provinces.slice(0, 3) }
})

参数:

参数类型必填说明
countrystring是国家名称(英文)

返回: Province[]

cities() ​

根据国家与省份获取城市列表。

ts
k.api.get(() => {
    const cities = k.commerce.address.cities('China', 'Fujian')
    return { count: cities.length, items: cities.slice(0, 3) }
})

参数:

参数类型必填说明
countrystring是国家名称(英文)
provincestring是省份名称(英文)

返回: City[]

结构 ​

Country 属性 ​

属性说明类型
code国家代码string
name国家名称(英文)string
nameTranslations国家名称翻译NameTranslation[]
currency货币代码string
currencySymbol货币符号string
emojiFlag国旗 emojistring

Province 属性 ​

属性说明类型
country国家名称(英文)string
name省份名称(英文)string
nameTranslations省份名称翻译NameTranslation[]

City 属性 ​

属性说明类型
country国家名称(英文)string
province省份名称(英文)string
name城市名称(英文)string
nameTranslations城市名称翻译NameTranslation[]

NameTranslation 属性 ​

属性说明类型
key语言代码string
value对应翻译string

相关文档 ​