citypicker Android Studio实现
前言
在实际的项目中需要使用到省市区三级联动的功能,在网上找来找去,都没有找到一个合适的库, 所以自己就封装了一个,不需要自己添加数据源,直接引用即可。
亮点
- 无需自己配置省市区域的数据,不需要再进行解析之类的繁杂操作,只需引用即可,结果返回省市区、经纬度、城市code等多种数据信息,如果不满意样式的话可以自己修改源码!
- 多种样式选择,高仿iOS滚轮实现以及列表选择。
效果预览
样式选择
本库提供两种省市区城市选择器,一是列表,而是仿iOS滚轮实现的选择器。
1、高仿iOS滚轮实现城市选择器
拥有多种属性,个性化设置。
2、城市列表选择器
列表展示所有城市数据
支持快捷搜索,以及右边字母快捷定位所在城市
使用方法
gradle引用
compile 'liji.library.dev:citypickerview:2.1.0'
代码示例
1、城市列表选择器代码
友情提醒:
列表选择器的原理主要就是通过startActivityForResult方法来实现的,如果不熟悉startActivityForResult的应用,请自行解决。
//首先跳转到列表页面,通过startActivityForResult实现页面跳转传值
Intent intent = new Intent(MainActivity.this, CityListSelectActivity.class);
startActivityForResult(intent, CityListSelectActivity.CITY_SELECT_RESULT_FRAG);
//接收选择器选中的结果:
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (requestCode == CityListSelectActivity.CITY_SELECT_RESULT_FRAG) {
if (resultCode == RESULT_OK) {
if (data == null) {
return;
}
Bundle bundle = data.getExtras();
CityInfoBean cityInfoBean = (CityInfoBean) bundle.getParcelable("cityinfo");
if (null == cityInfoBean)
return;
//城市名称
String cityName = cityInfoBean.getName();
//纬度
String latitude = cityInfoBean.getLongitude();
//经度
String longitude = cityInfoBean.getLatitude();
//获取到城市名称,经纬度值后可自行使用...
}
}
}
2、高仿iOS滚轮实现选择器代码
//详细属性设置,如果不需要自定义样式的话,可以直接使用默认的,去掉下面的属性设置,直接build()即可。
CityConfig cityConfig = new CityConfig.Builder(CitypickerWheelActivity.this)
.title("选择地区")
.titleBackgroundColor("#E9E9E9")
.textSize(18)
.titleTextColor("#585858")
.textColor("0xFF585858")
.confirTextColor("#0000FF")
.cancelTextColor("#000000")
.province("江苏")
.city("常州")
.district("新北区")
.visibleItemsCount(5)
.provinceCyclic(true)
.cityCyclic(true)
.districtCyclic(true)
.itemPadding(5)
.setCityInfoType(CityConfig.CityInfoType.BASE)
.setCityWheelType(CityConfig.WheelType.PRO_CITY_DIS)
.build();
//配置属性
CityPickerView cityPicker = new CityPickerView(cityConfig);
cityPicker.show();
//监听方法,获取选择结果
cityPicker.setOnCityItemClickListener(new CityPickerView.OnCityItemClickListener() {
@Override
public void onSelected(ProvinceBean province, CityBean city, DistrictBean district) {
//ProvinceBean 省份信息
//CityBean 城市信息
//DistrictBean 区县信息
}
@Override
public void onCancel() {
}
});
注意:上述属性中存在一个属性CityInfoType:
//设置加载省市区的数据类型
setCityInfoType(CityConfig.CityInfoType.BASE)
该属性是一个枚举类型
/**
* 城市数据类别
* BASE: 基本的城市数据信息,只包含省市区名称,不包含详细的经纬度、code、等数据
* DETAIL: 包含详细的经纬度、code、省市区数据名称等数据
*/
public enum CityInfoType {
BASE, DETAIL
}
如果没有特别要求,只是显示基本的省市区名称时,建议选择BASE类型,因为 BASE 和 DETAIL 类型所对应的 json 文件大小相差接近 20 倍,所以导致解析速度相差很大。如果需要 code 、经纬度等信息时请选择 DETAIL 类型
数据结构概览
BASE数据结构
json 文件对应于(assets/simple_cities_pro.json),改属性只包含基础的城市名称,而不包含经纬度、code等值,选择时请根据需要来决定使用哪个json文件。
[
{
"name":"北京(直辖市)",
"cityList":[
{
"name":"东城区"
},
{
"name":"西城区"
},
{
"name":"崇文区"
},
{
"name":"宣武区"
},
Object{...}
],
{
"name":"天津(直辖市)",
"cityList":[
{
"name":"和平区"
},
{
"name":"河东区"
},
{
"name":"河西区"
},
...
},
DETAIL数据结构
json 文件对应于(assets/simple_cities_pro_city_dis.json),改属性包含基础的城市名称经纬度(百度、高德)、code、等值,选择时请根据需要来决定使用哪个json文件。
"pinYin":"Beijing",
"id":"110000",
"gisGcj02Lng":116.409,
"cityList":[
{
"pinYin":"Beijing",
"id":"110100",
"gisGcj02Lng":116.408,
"cityList":[
{
"id":"110101",
"name":"东城区",
"status":1,
"orderId":null,
"createAccount":null,
"createTime":null,
"modifyAccount":null,
"modifyTime":null,
"gisBd09Lat":39.935,
"gisBd09Lng":116.422,
"gisGcj02Lat":39.9288,
"gisGcj02Lng":116.416,
"stubGroupCnt":1,
"pinYin":"Dongcheng"
},
Object{...},
Object{...},
Object{...},
...
数据返回
- ProvinceBean:表示:省份信息
- CityBean:表示:城市信息
- DistrictBean:表示:区县信息
返回结果参数说明
ProvinceBean , CityBean , DistrictBean 同样的数据结构
仿iOS滚轮实现的选择的结果:
省份数据结构
城市数据结构
区县数据结构
属性说明:
id //城市code
name //城市名称
pinYin //城市拼音
gisGcj02Lat //高德坐标系-纬度
gisGcj02Lng //高德坐标系-经度
gisBd09Lat //百度坐标系-纬度
gisBd09Lng //百度坐标系-经度
高仿iOS滚轮实现方法说明
- textSize(滚轮文字的大小,int 类型,默认为18)
- title(选择器标题,默认为“选择地区”)
- titleTextColor(标题文字颜色,默认为 #585858)
- titleBackgroundColor(标题栏背景,默认为灰色,#E9E9E9)
- confirTextColor(确认按钮字体颜色,默认#0000FF 值)
- cancelTextColor(取消按钮字体颜色,默认#000000 值)
- province(默认的显示省份,显示选择器后直接定位的item位置)
- city(默认的显示市,显示选择器后直接定位的item位置)
- district(默认的显示区,显示选择器后直接定位的item位置)
- textColor(滚轮文字的颜色 , 默认为0xFF585858)
- provinceCyclic(省份的滚轮是否循环滚动)
- cityCyclic(市的滚轮是否循环滚动)
- districtCyclic(区的滚轮是否循环滚动)
- visibleItemsCount(滚轮显示的item个数,int 类型,默认为5个)
- itemPadding(滚轮item间距,默认为5dp)
- setCityWheelType(CityConfig.WheelType )(只显示省份滚轮、显示省份和城市滚轮、显示省市区三级滚轮)
- setCityInfoType(CityConfig.CityInfoType )(显示加载的城市数据类别,base和detail类型)
更新日志
V2.1.0版本更新内容(2017.11.06)
V2.0.2版本更新内容(2017.08.24)
- 更新**省市区数据
- 修复#50问题
V2.0.1版本更新内容(2017.08.22)
- 修复选中**、澳门、香港时崩溃的问题;
V2.0.0版本更新内容(2017.08.22)
- 更丰富的数据结构、包含选择地区的百度、高德经纬度、城市code等;
- 更全面的全国省市区数据信息;
- 优化及修复bug。
V1.1.0版本更新内容(2017.05.26)
- 增加列表选择器,可获取相关城市的经纬度(百度经纬度)
- 修复已知的bug。
V1.0.0版本更新内容(2017.03.21)
V0.9.0版本更新内容(2017.01.03)
- 新增标题字体颜色的属性titleTextColor
- 修复#15问题
V0.8.0版本更新内容(2016.12.10)
V0.7.0版本更新内容(2016.11.14)
V0.6.0版本更新内容(2016.11.09)
- 修复部分城市数据不全的问题
- 添加修改标题的属性
V0.5.0版本更新内容(2016.10.28)
- 修复当数据源少于7个item时,设置字体颜色有阴影的bug
V0.4.0版本更新内容(2016.10.24)
- 新增只显示省市两级联动设置
- 新增确认和取消按钮文字颜色的设置
- 新增设置默认省市区的设置
V0.3.0版本更新内容(2016.10.13)
- 新增item间距属性
- 拆分省市区三个滚轮循环显示为分别是否循环滚动
- 优化代码结构
V0.2.0版本更新内容(2016.05.16)
- 滚轮是否循环滚动
- 新增文字颜色修改
- 新增文字大小修改
- 新增滚轮内容可见数量
V0.1.0版本更新内容(2016.05.08)
- 直接传入context获取省市区信息