目录
碎片(Fragment)
百度地图API
使用百度地图定位并显示位置
首先展示一下最终的成品效果吧,首先是登陆界面:
然后是地图显示界面(A表示自身位置,B表示自行车位置):
此外还有密码修改界面:
扫描二维码界面:
下面是我写的app的apk安装包下载地址:安卓apk安装包下载
此外,我也把我的源码公开出来给大家(希望大家点个赞支持一下):源码下载
注:app的账号和密码在上面下载页里面有说。
共享单车客户端的几个基本功能:首先是在地图上查询自身位置,查询自行车的位置、找到了自行车的话需要扫描二维码实现开锁,以及一开始的软件登陆等等功能。
想看第二偏关于如何进行二维码的扫描请看:二维码
这里的地图模块,我使用的是百度地图,也就是说在程序里面嵌入一个控件(Fragment),首先介绍一下Fragment。
碎片(Fragment)是一种可以可以镶嵌在活动里面的一个小型的控件,但是这个空间的面积已经形式可以任意调节,在碎片里面我们也可以放置其他的控件。抽象的说,我们可以把碎片理解成一个控件化的活动,他可大可小,可以大到一个完整的手机界面,也可以小到一个按键那么大。
我在这里之所以使用碎片(fragment),是因为希望在这个碎片里面添加进百度地图的界面,和修改密码等其他设置的一个界面,而在碎片以外的其他空间,放置一个导航栏,这样的设计对于用户的交互性最好。我在程序中一共使用了2个碎片,分别用来放置百度地图和各种设置的控件,分别叫做FragmentMap、FragmentSetting。
然后申请百度地图的API。
在手机地图领域做得最好的就是百度地图[22]和谷歌地图了,并且这两种地图都提供了丰富的API,使得任何开发者都可以轻松将地图加入自己应用程序中。因为相对来说百度地图更方便,这里我们选择使用百度地图来显示自己的位置和自行车的位置,首先我们需要申请一个API Key(服务秘钥),步骤如下:
1、我们进入自己的百度账号,然后打开API控制台,再点击创建应用,开始申请开发秘钥,如图:
2、填写应用名称,应用类型选择“Android SDK”,正确填写安全码,点击确认,然后系统会自动分配一个对应的开发秘钥,如图5.8。注意这里我们需要填写发布版SHA1和开发板SHA1,因为我们先在处于开发阶段,我们填写的实际上是开发板的SHA1,这个获取方式如图5.9。然后还要填写包名,获取方式是打开AndroidManifest.xml 然后查询如图:
然后我们为使用百度地图控件做一些准备:
首先我们在上面的官网上下载百度地图SDK,然后将下载的jar包和so文件添加进libs目录,然后将它们添加进构建路径里面。然后我们在AndroidManifest.xml文件里面添加刚才申请的秘钥和运行百度地图所需要的权限。如图:
因为我们是在fragment里面添加一个百度地图控件的,所以在fragment的布局文件里面添加一个百度地图控件,关键代码如下:
这样我们就可以在fragment里面控制和使用百度地图控件了,另外需要注意的一点是在活动创建一开始的时候,也就是在Oncreat()函数里需要加上下面一句话:
SDKInitializer.initialize(getApplicationContext());
并且initialize方法传入的必须是ApplicationContext,不能是this,否则会出错,因为我们是在fragment里面使用,所以我们应该写成:
SDKInitializer.initialize(getActivity().getApplicationContext());
然后我们在活动的onResume、onPause、onDestory方法中分别执行mapview的onReusme、onPause、onDestory方法,用来完善这个控件的生命周期。
首先,我们需要使用百度地图的SDK来获取经纬度,这样才能显示位置[23],获取经纬度的步骤如下:
1、初始化LocationClient类
public LocationClient mLocationClient = null;
private MyLocationListener myListener = new MyLocationListener();
public void onCreate() {
mLocationClient = new LocationClient(getApplicationContext());
mLocationClient.registerLocationListener(myListener);
}
2、配置定位SDK需要的参数
通过参数的配置,我们可以去选择定位[24]的模式、设定返回的经纬度坐标类型、可设定是单次定位还是连续定位。定位的SDK所提供定位模式包括三种:高精度,低功耗和仅用设备定位,我们需要根据自己的需要来选择。此外,定位SDK能够返回三种坐标类型的经纬度,分别是:gcj02(国测局坐标)、bd09(百度墨卡托坐标)、bd09ll(百度经纬度坐标)。
这里需要注意的一点是,我们通过gps获得自行车的经纬度的坐标系是wgs84,而我们百度地图里面需要的坐标系是bd09,所以我们如果想在百度地图里面显示自行车的位置,就需要进行坐标系的转化。国内的主流的坐标系可见如图:
百度地图的SDK也提供了工具可以进行不同的坐标系的转换,转换方式如下:
CoordinateConverter converter = new CoordinateConverter();
converter.from(CoordType.GPS);
LatLng sourceLatLng=new LatLng(sourceLatLng);
converter.coord(sourceLatLng);
LatLng desLatLng = converter.convert();
3、实现BDAbstractLocationListener接口
百度地图SDK对外提供了Abstract类型的监听接口BDAbstractLocationListener,用于实现定位监听。原有BDLocationListener暂时保留,推荐开发者升级到Abstract类型的新监听接口使用,该接口会异步获取定位结果,比如经度、纬度和经度等等,核心代码如下:
public class MyLocationListener implements BDAbstractLocationListener{
@Override
public void onReceiveLocation(BDLocation location){
double latitude = location.getLatitude(); //获取纬度信息
double longitude = location.getLongitude(); //获取经度信息
float radius = location.getRadius(); //获取定位精度,默认值为0.0f
String coorType = location.getCoorType();
int errorCode = location.getLocType();
}
4、获取定位经纬度
最后,只需发起定位,便能够从BDAbstractLocationListener监听接口中获取定位结果信息。核心代码如下:
mLocationClient.start();
注意:start():这个函数用于启动定位的SDK;stop():这个函数用于关闭定位SDK。当我们在使用start()之后我们只需要等待定位结果,然后程序会自动去回调监听函数。如果开发者定位场景是单次定位的场景,那么在收到定位结果之后我们直接调用stop()函数即可。另外如果在stop()之后想继续进行定位,可以再次使用start()函数,然后等待定位结果回调。
5、添加覆盖物来显示位置
首先我们需要找到一个图标用于显示自己的位置和自行车的位置,这个图标保存为png的格式,放置在这个项目的drawable-hdpi文件夹里面,然后利用百度地图SDK提供的工具来为特定的点添加覆盖物,关键代码如下:
bitmapEnd = BitmapDescriptorFactory.fromResource(R.drawable.icon_markb);
OverlayOptions option = new
MarkerOptions().position(desLatLng).icon(bitmapEnd);
mBaiduMap.addOverlay(option);
这里的R.drawable.icon_markb就是我们刚才添加进drawable里面的图片资源的ID,而上面的desLatLng指的就是需要添加覆盖物的点,比如我们需要的显示自己的位置和自行车的位置的点。
初次之外,我们还可以添加文字覆盖物用于提示当前显示的是什么位置,百度地图SDK也提供了相应的工具——TextOptions(文字覆盖物),在设置文字覆盖物的时候,我们需要注意文字的颜色,字体大小,位置等属性,关键代码如下:
LatLng latLng = new LatLng(latitude, longitude);
TextOptions textOptions = new TextOptions();
textOptions.bgColor(0xAAFFFF00) //設置文字覆蓋物背景顏色
.fontSize(28) //设置字体大小
.fontColor(0xFFFF00FF)// 设置字体颜色
.text("我的位置!") //文字内容
.rotate(-30) //设置文字的旋转角度
.position(latLng);// 设置位置
bdMap.addOverlay(textOptions);
6、地理编码与反地理编码
所谓的地理编码指的就是,将地理位置信息转化为一个坐标位置关系的过程,比如:南京市江宁区南京工程学院——>经度**纬度**。而反地理编码则与之相反,即将一个坐标位置关系转换为地理位置信息,比如:经度**纬度**——>南京市江宁区南京工程学院。所以我们在使用百度地图的SDK获得的经纬度就需要进行反地理编码,然后才能获得相对应的地理位置信息。
此外,除了百度地图部分,还有扫描二维码部分,具体的设计原理我会在后面的博客里面继续。