城市选择器

更新时间：2021-10-20

一、打开城市选择列表页面的接口

参数说明：

参数	类型	必填	说明
data	Object	是	请求结构体
success	function	是	成功回调
fail	function	否	失败回调

二、其中data是一个object对象

需要填入以下字段：

参数	类型	必填	说明
location	Object	否	当前定位信息
hot	Array	否	热门城市列表
all	Array	否	全部城市列表

三个参数非必填，其中location为空的情况下显示未定位，热门或者全部城市列表为空时会默认加载宿主本地的json城市列表文件。

三、location字段结构：

参数	类型	必填	说明
cityId	String	是	当前城市id
city	String	是	当前城市名
latitude	String	是	当前城市经度
longitude	String	是	当前城市纬度

四、城市列表字段结构：

参数	类型	必填	说明
id	String	是	城市id
name	String	是	城市名
pinyin	String	是	城市拼音，主要用作分类展示
extra	String	否	额外信息，宿主只做返回透传，不做任何处理。主要针对一些小程序需要额外的参数带入

五、返回数据说明：

参数	类型	说明
location	Object	当前定位信息，数据结构同请求参数location一致
data	Object	选中城市信息，数据结构同请求参数城市列表字段一致

swan.iovauto.openCitySelectPage({
            data:{
                location:{
                    cityId: '13',
                    city : '深圳',
                    latitude :'22524814',
                    longitude :'113943196',
                },
                hot:[
                    {
                        id: '1',
                        name: '北京',
                        pinyin: 'beijing'
                    },
                ],
                all:[
                    {
                        id: '1',
                        name: '北京',
                        pinyin: 'beijing',
                        extra:'extra'
                    },
                ]
            },
            success: res => {
					console.log('currentCity: ', res.location.city + ', selectCity: ' + res.data.name); 
                }
            })
        })

打开车辆信息编辑页面性能优化