定位
进行定位之前,您需要在 AndroidManifest.xml 文件中进行权限设置,确保定位功能可以正常使用。具体操作参见配置工程。
注意:目前定位SDK在黑屏或锁屏时CPU休眠不进行位置更新。若您有此种场景的需求,可以用alarmManager 实现1个cpu可叫醒的timer,定时请求定位即可。
定位操作包含
发送定位请求
目前Android 定位 SDK可以实现混合定位、GPS 定位和网络定位(基站+ WiFi)。混合定位方式,定位 SDK 会自动根据用户的实际情况进行智能判断使用网络定位或 GPS 定位,以达到最佳的定位效果。
网络定位与混合定位方式的区别在于是否启用GPS定位,只需在发送定位请求前进行 LocationManagerProxy.setGpsEnable(false) 的设置。发送定位请求设置相同。
注意:由于建筑物遮挡影响 GPS 信号强度,您可能在室内无法获取位置信息。采用 GPS 定位,建议您在户外使用。
从V1.2.0版本,废弃 requestLocationUpdates(String provider, long minTime,float minDistance, AMapLocationListener listener) 方法。
注册监听的方法为 requestLocationData(String provider, long minTime, float minDistance, AMapLocationListener listener) 方法,其中参数:
- provider:有三种定位Provider供用户选择,分别是:LocationManagerProxy.GPS_PROVIDER,代表使用手机GPS定位;LocationManagerProxy.NETWORK_PROVIDER,代表使用手机网络定位;LocationProviderProxy.AMapNetwork,代表高德网络定位服务,混合定位。
- minTime:位置变化的通知时间,单位为毫秒。如果为-1,定位只定位一次。
- minDistance:位置变化通知距离,单位为米。
- listener:定位监听者。
说明:按照上述方法注册监听后,且 minTime 不为 -1 时,若 provider 为网络定位,则按照所设置的时间进行触发,若 provider 为 GPS 定位,则按照设定的距离和时间触发。为了减少电量消耗或网络流量消耗,注意定位时间的间隔和在合适时间调用removeUpdates()和destroy()方法。
注册监听,发送定位请求的示例代码如下所示:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
|
public
class
LocationActivity
extends
Activity
implements
AMapLocationListener {
private
LocationManagerProxy mLocationManagerProxy;
@Override
protected
void
onCreate(Bundle savedInstanceState) {
super
.onCreate(savedInstanceState);
setContentView(R.layout.activity_net_location);
init();
}
/**
* 初始化定位
*/
private
void
init() {
mLocationManagerProxy = LocationManagerProxy.getInstance(
this
);
//此方法为每隔固定时间会发起一次定位请求,为了减少电量消耗或网络流量消耗,
//注意设置合适的定位时间的间隔,并且在合适时间调用removeUpdates()方法来取消定位请求
//在定位结束后,在合适的生命周期调用destroy()方法
//其中如果间隔时间为-1,则定位只定一次
mLocationManagerProxy.requestLocationData(
LocationProviderProxy.AMapNetwork,
60
*
1000
,
15
,
this
);
mLocationManagerProxy.setGpsEnable(
false
);
}
……
}
|
回调定位信息
发送定位请求后,会进定位回调,返回位置信息对象 AMapLocation。
通过 AMapLocation.getAMapLocException()方法获取定位异常对象,再通过异常对象返回的错误码判断是或否定位成功。示例代码如下:
1
2
3
4
5
6
7
8
|
@Override
public
void
onLocationChanged(AMapLocation amapLocation) {
if
(amapLocation !=
null
&& amapLocation.getAMapException().getErrorCode() ==
0
){
//获取位置信息
Double geoLat = amapLocation.getLatitude();
Double geoLng = amapLocation.getLongitude();
}
}
|
显示定位信息
通过位置信息对象 AMapLocation 可获取定位点的坐标、定位精度半径、provider名称(网络定位时,返回 “lbs”;GPS定位时,返回“gps”)信息。除了上述信息,不同的定位方式,还返回其特有的位置信息。
- 使用GPS定位时,可获取定位速度(getSpeed()),定位方向(getBearing())。
- 使用网络定位时,返回省名称(如果是直辖市,省名称为null)(getProvince()),城市名称(getCity()),城市编码(getCityCode()),区(县)名称(getDistrict()),区域编码(getAdCode()),街道和门牌信息(getStreet()),详细地址(getAddress()),描述信息(getExtras())。
说明:通过 AMapLocation.getExtras() 方法获取位置的描述信息,包括省、市、区以及街道信息,并以空格分隔。示例代码如下:
1
2
3
4
5
|
String desc =
""
;
Bundle locBundle = location.getExtras();
if
(locBundle !=
null
) {
desc = locBundle.getString(
"desc"
);
}
|
- 使用混合定位时,需要判断是否为 GPS 定位使用类 AMapLocation 的 getProvider() 方法。GPS定位时,不能获取网络定位特有的信息。
停止定位,并销毁定位资源
停止定位时,调用 LocationManagerProxy 类的 removeUpdates(AMapLocationListener listener) 方法移除定位请求(单次定位时,无需调用该方法)。并对定位服务对象进行销毁,调用 LocationManagerProxy.destory() 方法。
示例代码如下:
1
2
3
4
5
6
7
|
private
void
stopLocation() {
if
(aMapLocManager !=
null
) {
aMapLocManager.removeUpdates(
this
);
aMapLocManager.destory();
}
aMapLocManager =
null
;
}
|
注意:建议在Activity的OnPause()方法中停止定位,并销毁定位资源。
下面介绍结合高德地图 Android SDK,介绍如何显示定位小蓝点(详细信息,请参考com.location.apis.demo.MultyLocationActivity.java):
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
|
/**
* AMapV2地图中简单介绍显示定位小蓝点
*/
public
class
MultyLocationActivity
extends
Activity
implements
LocationSource, AMapLocationListener {
private
AMap aMap;
private
MapView mapView;
private
OnLocationChangedListener mListener;
private
LocationManagerProxy mAMapLocationManager;
@Override
protected
void
onCreate(Bundle savedInstanceState) {
super
.onCreate(savedInstanceState);
setContentView(R.layout.locationsource_activity);
mapView = (MapView) findViewById(R.id.map);
mapView.onCreate(savedInstanceState);
init();
}
/**
* 初始化AMap对象
*/
private
void
init() {
if
(aMap ==
null
) {
aMap = mapView.getMap();
setUpMap();
}
}
private
void
setUpMap() {
aMap.setLocationSource(
this
);
// 设置定位监听
aMap.getUiSettings().setMyLocationButtonEnabled(
true
);
// 设置默认定位按钮是否显示
aMap.setMyLocationEnabled(
true
);
// 设置为true表示显示定位层并可触发定位,false表示隐藏定位层并不可触发定位,默认是false
// 设置定位的类型为定位模式:定位(AMap.LOCATION_TYPE_LOCATE)、跟随(AMap.LOCATION_TYPE_MAP_FOLLOW)
// 地图根据面向方向旋转(AMap.LOCATION_TYPE_MAP_ROTATE)三种模式
aMap.setMyLocationType(AMap.LOCATION_TYPE_LOCATE);
}
/**
* 此方法需存在
*/
@Override
protected
void
onResume() {
super
.onResume();
mapView.onResume();
}
/**
* 此方法需存在
*/
@Override
protected
void
onPause() {
super
.onPause();
mapView.onPause();
deactivate();
}
/**
* 此方法需存在
*/
@Override
protected
void
onDestroy() {
super
.onDestroy();
mapView.onDestroy();
}
/**
* 此方法已经废弃
*/
@Override
public
void
onLocationChanged(Location location) {
}
/**
* 定位成功后回调函数
*/
@Override
public
void
onLocationChanged(AMapLocation amapLocation) {
if
(mListener !=
null
&& amapLocation !=
null
) {
if
(amapLocation.getAMapException().getErrorCode() ==
0
) {
mListener.onLocationChanged(amapLocation);
// 显示系统小蓝点
}
}
}
/**
* 激活定位
*/
@Override
public
void
activate(OnLocationChangedListener listener) {
mListener = listener;
if
(mAMapLocationManager ==
null
) {
mAMapLocationManager = LocationManagerProxy.getInstance(
this
);
//此方法为每隔固定时间会发起一次定位请求,为了减少电量消耗或网络流量消耗,
//注意设置合适的定位时间的间隔,并且在合适时间调用removeUpdates()方法来取消定位请求
//在定位结束后,在合适的生命周期调用destroy()方法
//其中如果间隔时间为-1,则定位只定一次
mAMapLocationManager.requestLocationData(
LocationProviderProxy.AMapNetwork,
60
*
1000
,
10
,
this
);
}
}
/**
* 停止定位
*/
@Override
public
void
deactivate() {
mListener =
null
;
if
(mAMapLocationManager !=
null
) {
mAMapLocationManager.removeUpdates(
this
);
mAMapLocationManager.destroy();
}
mAMapLocationManager =
null
;
}
}
转载:
|