百度地图开发之实现运动轨迹 <一>

近日想在android平台下进行一个基于地理位置的APP开发,于是想到了利用百度地图的API进行开发。于是参考了网上的一些代码以及相关知识的分享,现在记录一下在百度地图上描绘出运动轨迹的开发过程!
首先,百度地图定位功能的一个重要的类就是 LocationClient。
此处需要注意:LocationClient类必须在主线程中声明。需要Context类型的参数。
Context需要时全进程有效的context,推荐用getApplicationConext获取全进程有效的context

public LocationClient mLocationClient = null;
public BDLocationListener myListener = new MyLocationListener();

public void onCreate() {
    mLocationClient = new LocationClient(getApplicationContext());     //声明LocationClient类
    mLocationClient.registerLocationListener( myListener );    //注册监听函数
}

LocationClient类是定位SDK的核心类,具体方法如下: 构造类:

public LocationClient ( Context ) //须在主线程中声明

设置参数:
public void setLocOption ( LocationClientOption )
参数:配置定位SDK,详见LocationClientOption类。 说明:2.x版本以后的定位提供API接口,用以在API运行过程中,支持热切换配置参数。

注册监听函数:
public void registerLocationListener ( BDLocationListener )
参数:详见BDLocationListener类。 说明:当没有注册监听函数时,无法发起网络请求。

注册位置提醒监听事件:
public void registerNotify ( BDNotifyListener mNotify )
开启/关闭:
public void start();
public void stop();
start:启动定位SDK。
stop:关闭定位SDK。调用stop之后,设置的参数LocationClientOption仍然保留。
发起定位:
public int requestLocation()
发起定位,异步获取当前位置。因为是异步的,所以立即返回,不会引起阻塞。定位结果在ReceiveListener的方法OnReceive方法的参数中返回。
需要注意:当定位SDK从定位依据判定,位置和上一次没发生变化,而且上一次定位结果可用时,则不会发起网络请求,而是返回上一次的定位结果。 返回值:

0:正常发起了定位。

1:服务没有启动。

2:没有监听函数。

6:请求间隔过短。 前后两次请求定位时间间隔不能小于1000ms。

请求离线定位:

离线定位功能:用户请求过得基站定位结果会缓存在本地文件。离线定位结果为缓存结果,精度低于在线的定位结果。

离线定位结果没有地址信息。

public int requestOfflineLocation()

发起离线定位,异步获取当前位置。因为是异步的,所以立即返回,不会引起阻塞。定位结果在ReceiveListener的方法OnReceive方法的参数中返回。

返回值:

0:正常发起了定位。

1:服务没有启动。

2:没有监听函数。

取消监听函数:

public void unRegisterLocationListener(BDLocationListener listener)

取消监听函数。

位置提醒相关函数:

//注册位置提醒监听事件
public void registerNotify(BDNotifyListener mNotify)
//取消位置提醒监听事件
public void removeNotifyEvent(BDNotifyListener mNotify)

实现BDLocationListener接口

BDLocationListener接口有2个方法需要实现: 1.接收异步返回的定位结果,参数是BDLocation类型参数。

public class MyLocationListener implements BDLocationListener {
    @Override
    public void onReceiveLocation(BDLocation location) {
        if (location == null)
                return ;
        StringBuffer sb = new StringBuffer(256);
        sb.append("time : ");
        sb.append(location.getTime());
        sb.append("\nerror code : ");
        sb.append(location.getLocType());
        sb.append("\nlatitude : ");
        sb.append(location.getLatitude());
        sb.append("\nlontitude : ");
        sb.append(location.getLongitude());
        sb.append("\nradius : ");
        sb.append(location.getRadius());
        if (location.getLocType() == BDLocation.TypeGpsLocation){
            sb.append("\nspeed : ");
            sb.append(location.getSpeed());
            sb.append("\nsatellite : ");
            sb.append(location.getSatelliteNumber());
        } else if (location.getLocType() == BDLocation.TypeNetWorkLocation){
            sb.append("\naddr : ");
            sb.append(location.getAddrStr());
        } 

        logMsg(sb.toString());
    }
}

BDLocation类,封装了定位SDK的定位结果,在BDLocationListener的onReceive方法中获取。通过该类用户可以获取error code,位置的坐标,精度半径等信息。具体方法如下:

获取error code:

public int getLocType ( )

返回值:

61 : GPS定位结果

62 : 扫描整合定位依据失败。此时定位结果无效。

63 : 网络异常,没有成功向服务器发起请求。此时定位结果无效。

65 : 定位缓存的结果。

66 : 离线定位结果。通过requestOfflineLocaiton调用时对应的返回结果

67 : 离线定位失败。通过requestOfflineLocaiton调用时对应的返回结果

68 : 网络连接失败时,查找本地离线定位时对应的返回结果

161: 表示网络定位结果

162~167: 服务端定位失败

502:key参数错误

505:key不存在或者非法

601:key服务被开发者自己禁用

602:key mcode不匹配

501~700:key验证失败

如果不能定位,请记住这个返回值,并到我们的hi群或者贴吧中交流。若返回值是162~167,请发送邮件至[email protected]反馈。

获取经纬度坐标:

public double getLatitude ( ) //获取维度
public double getLongitude ( ) //获取经度

获取定位的坐标。坐标的类型在setLocationClientOption方法中设定。

获取定位精度:

public boolean hasRadius ( ) //判断是否有定位精度半径
public float getRadius ( ) //获取定位精度半径,单位是米

获取文字描述的地址(反地理编码):

public String getAddrStr ( ) //获取反地理编码

只有使用网络定位的情况下,才能获取当前位置的反地理编码描述。

自定位SDK2.6版本之后,支持获取省/市/区分级地理信息:

public String getProvince ( ) //获取省份信息
public String getCity ( ) //获取城市信息
public String getDistrict ( ) //获取区县信息

获取手机方向信息:

public float getDirection()
//获得手机方向,范围【0-360】,手机上部正朝向北的方向为0°方向

设置定位参数

设置定位参数包括:定位模式(高精度定位模式,低功耗定位模式和仅用设备定位模式),返回坐标类型,是否打开GPS等等。

高精度定位模式:这种定位模式下,会同时使用网络定位和GPS定位,优先返回最高精度的定位结果;

低功耗定位模式:这种定位模式下,不会使用GPS,只会使用网络定位(Wi-Fi和基站定位)

仅用设备定位模式:这种定位模式下,不需要连接网络,只使用GPS进行定位,这种模式下不支持室内环境的定位

eg:

LocationClientOption option = new LocationClientOption();
option.setLocationMode(LocationMode.Hight_Accuracy);//设置定位模式
option.setCoorType(“bd09ll”);//返回的定位结果是百度经纬度,默认值gcj02
option.setScanSpan(5000);//设置发起定位请求的间隔时间为5000ms
option.setIsNeedAddress(true);//返回的定位结果包含地址信息
option.setNeedDeviceDirect(true);//返回的定位结果包含手机机头的方向
mLocClient.setLocOption(option);

LocationClientOption类,该类用来设置定位SDK的定位方式,具体方法如下:

设置定位模式:

//Hight_Accuracy高精度、Battery_Saving低功耗、Device_Sensors仅设备(GPS)
public void setLocationMode(LocationMode mode)

设置打开GPS:

setOpenGps( boolean )

设置是否打开gps,使用gps前提是用户硬件打开gps。默认是不打开gps的。

设置是否需要设备方向信息:

//在网络定位中,获取手机机头所指的方向
public void setNeedDeviceDirect(boolean)

设置是否需要地址信息:

使用setIsNeedAddress(boolean)

设置是否要返回地址信息,默认为无地址信息。

public void setAddrType ( String )

String 值为 all时,表示返回地址信息,其他值都表示不返回地址信息。

设置坐标类型:

设置返回值的坐标类型。

public void setCoorType ( String )

我们支持返回若干种坐标系,包括国测局坐标系、百度坐标系,需要更多坐标系请联系我们,需要深度合作。目前这些参数的代码为。因此需要在请求时指定类型,如果不指定,默认返回百度坐标系。注意当仅输入IP时,不会返回坐标。目前这些参数的代码为

返回国测局经纬度坐标系 coor=gcj02

返回百度墨卡托坐标系 coor=bd09

返回百度经纬度坐标系 coor=bd09ll

百度手机地图对外接口中的坐标系默认是bd09ll,如果配合百度地图产品的话,需要注意坐标系对应问题。

有关坐标系的更多问题,请看常见问题

设置产品线名称:

public void setProdName ( String )

设置产品线名称。强烈建议您使用自定义的产品线名称,方便我们以后为您提供更高效准确的定位服务。

设置定位时间间隔:

public void setScanSpan ( int ) //设置定时定位的时间间隔。单位ms

说明:

当所设的整数值大于等于1000(ms)时,定位SDK内部使用定时定位模式。调用requestLocation( )后,每隔设定的时间,定位SDK就会进行一次定位。如果定位SDK根据定位依据发现位置没有发生变化,就不会发起网络请求,返回上一次定位的结果;如果发现位置改变,就进行网络请求进行定位,得到新的定位结果。定时定位时,调用一次requestLocation,会定时监听到定位结果。

当不设此项,或者所设的整数值小于1000(ms)时,采用一次定位模式。每调用一次requestLocation( ),定位SDK会发起一次定位。请求定位与监听结果一一对应。

设定了定时定位后,可以热切换成一次定位,需要重新设置时间间隔小于1000(ms)即可。locationClient对象stop后,将不再进行定位。如果设定了定时定位模式后,多次调用requestLocation(),则是每隔一段时间进行一次定位,同时额外的定位请求也会进行定位,但频率不会超过1秒一次。

设置位置提醒接口:

public void registerNotify( BDNotifyListener mNotify )
LocationClient注册位置提醒监听事件
public void removeNotifyEvent( BDNotifyListener mNotify )
LocationClient取消位置提醒监听事件

发起定位请求

发起定位请求。请求过程是异步的,定位结果在上面的监听函数onReceiveLocation中获取。

if (mLocClient != null && mLocClient.isStarted())
mLocClient.requestLocation();
else
Log.d(“LocSDK5”, “locClient is null or not started”);

发起离线定位请求

发起离线定位请求。请求过程是异步的,定位结果在上面的监听函数onReceiveLocation中获取。

getLocTypte = BDLocation.TypteOfflineLocation || BDLocation.TypeOfflineLocationFail

表示是离线定位请求返回的定位结果

if (mLocClient != null && mLocClient.isStarted())
mLocClient.requestOfflineLocation();

位置提醒使用

位置提醒最多提醒3次,3次过后将不再提醒。 假如需要再次提醒,或者要修改提醒点坐标,都可通过函数SetNotifyLocation()来实现。

//位置提醒相关代码
mNotifyer = new NotifyLister();
mNotifyer.SetNotifyLocation(42.03249652949337,113.3129895882556,3000,”gps”);//4个参数代表要位置提醒的点的坐标,具体含义依次为:纬度,经度,距离范围,坐标系类型(gcj02,gps,bd09,bd09ll)
mLocationClient.registerNotify(mNotifyer);
//注册位置提醒监听事件后,可以通过SetNotifyLocation 来修改位置提醒设置,修改后立刻生效。
//BDNotifyListner实现
public class NotifyLister extends BDNotifyListener{
public void onNotify(BDLocation mlocation, float distance){
mVibrator01.vibrate(1000);//振动提醒已到设定位置附近
}
}
//取消位置提醒
mLocationClient.removeNotifyEvent(mNotifyer);

使用地理围栏服务Beta

地理围栏服务提供的是基于位置的提醒服务,相对于SDK原来提供的位置提醒功能,地理围栏服务通过SDK本身的内部逻辑,大幅度降低位置提醒服务的功耗情况。通过使用地理围栏服务,第三方APP可以在低能耗的模式下轻松实现位置提醒服务。
初始化GeofecenClient类

此处需要注意:GeofenceClient类必须在主线程中声明。需要Context类型的参数。

Context需要时全进程有效的context,推荐用getApplicationConext获取全进程有效的context。
public GeofenceClient mGeofenceClient = null;
public void onCreate() {
mGeofenceClient = new GeofenceClient(getApplicationContext();
}

实现添加和删除围栏的回调接口

添加围栏回调:OnAddBDGeofencesResultListener

实现如下:

public class AddGeofenceListener implements OnAddBDGeofencesResultListener {
@Override
public void onAddBDGeofencesResult(int statusCode, String geofenceRequestId) {
if (statusCode == BDLocationStatusCodes.SUCCESS) {
//围栏创建成功
}}}

删除围栏回调:OnRemoveBDGeofencesResultListener

实现如下:

public class RemoveFenceListener implements OnRemoveBDGeofencesResultListener {
@Override
public void onRemoveBDGeofencesByRequestIdsResult(int statusCode, String[] geofenceRequestIds) {
if (statusCode == BDLocationStatusCodes.SUCCESS) {
//围栏删除成功
}}}

实现并注册OnGeofenceTriggerListener回调接口

public class GeofenceEnterLister implements OnGeofenceTriggerListener {
@Override
public void onGeofenceTrigger(String geofenceRequestId) {
//进入围栏,围栏Id = geofenceRequestId
}
@Override
public void onGeofenceExit(String geofenceRequestId) {
//退出围栏,围栏Id = geofenceRequestId
}
//注册并开启围栏扫描服务
mGeofenceClient .registerGeofenceTriggerListener(new GeofenceEnterLister());
mGeofenceClient.start();
}

设置围栏参数

围栏参数包括:id:围栏Id、x,y:围栏坐标点经纬度、name、半径类型(目前只支持半径在500m以内的围栏)、expir:围栏的有效时间,单位毫秒(最长可以设置1个月)、coordType:坐标类型(COORD_TYPE_BD09、COORD_TYPE_BD09LL、COORD_TYPE_GCJ)、

具体如下:

BDGeofence fence = new BDGeofence.Builder().setGeofenceId(id).
setCircularRegion(x, y, type)
. setExpirationDruation(expir)
. setCoordType(coordType)
.build();

发起围栏添加和删除请求

//添加一个围栏:
mGeofenceClient.addBDGeofence(fence, new AddGeofenceListener());
//删除,指定要删除围栏的名字列表
List fences = new ArrayList();
fences.add(fenceId);
mGeofenceClient. removeBDGeofences(fences, new RemoveFenceListener());

需要注意的问题

定位SDK必须注册GPS和网络的使用权限。

使用定位SDK请保证网络连接通畅(GPS定位方式不需要连网)。

我们强烈建议您设置自己的prodName,并保管好,这样方便我们为您提供更好的定位服务。

若需要返回的定位结果里包含地址信息,请保证网络连接。

定位SDK可以返回bd09、bd09ll、gcj02三种类型坐标,若需要将定位点的位置通过百度Android地图 SDK进行地图展示,请返回bd09ll,将无偏差的叠加在百度地图上。

有的移动设备锁屏后为了省电会自动关闭网络连接,此时网络定位模式的定位失效。此外,锁屏后移动设备若进入cpu休眠,定时定位功能也失效。若您需要实现在cpu休眠状态仍需定时定位,可以用alarmManager 实现1个cpu可叫醒的timer,定时请求定位。

你可能感兴趣的:(学习日志)