本文详细讲解了如何配置环境,如何实现定位,以及公布了定位代码。
-----------------------------------------------------------------------
下载 jar 包之后,在开发工程中新建“libs”文件夹,将定位包拷贝到 libs 的根目录下。拷贝完成后的工程目录(以 V1.0.4 为例)如图所示:
注意:若您在 Eclipse 上使用 adt22 版本插件,则需要在 Eclipse 上进行如下配置:
选中 Eclipse 的工程,右键选择 “Properties > Java Build Path > Order and Export”,勾选 “Android Private Libraries”。
工程的“AndroidManifest.xml”文件如下代码中添加您的用户 Key。
<application android:icon="@drawable/icon" android:label="@string/app_name" > <meta-data android:name="com.amap.api.v2.apikey" android:value="请输入您的用户 Key" /> <activity android:name="com.amap.demo.LocationManager" > <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> </application>
新建工程如图所示:
在工程的 app/libs 目录下放入已经下载的开发包,这里以 3D 地图为例,将开发包中的 jar 包加到 libs 目录下,如图所示:
选择放到 libs 下的 jar 包,右击选择 Add As Library
因为 3D 地图 SDK 和导航 SDK 需要引入 so 库文件,所有需要再 app/src/main/目录下新建 jniLibs 目录,将 so 放到此目录下,如图所 示:
在 app/src/main 目录下的 AndroidMainfest.xml 配置申请的 key 和相关权限
在生成 apk 进行代码混淆时进行如下配置(如果爆出 warning,在报出 warning 的包加入类似的语句:-dontwarn 包名)
定位 -keep class com.amap.api.location.**{*;} -keep class com.aps.**{*;}
使用定位SDK即可实现定位。下载链接 http://lbs.amap.com/api/android-location-sdk/down/
Android 定位 SDK 是一套简单的 LBS 服务定位接口,您可以使用这套定位 API 获取定位结果(包括全球定位、辅助 H5 页面定位功能)、逆 地理编码(地址的文字描述)、以及地理围栏功能。
支持 Android 4.0 及以上系统。
为保证服务可以正常使用,您需要注册成为开发者并申请 Key。注册地址: http://lbs.amap.com/console/
首先,请在在 application 标签中声明 service 组件,每个 app 拥有自己单独的定位 service。
<service android:name="com.amap.api.location.APSService"></service>
声明使用权限
<!--用于进行网络定位--> <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> <!--用于访问 GPS 定位--> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> <!-- 获取运营商信息,用于支持提供运营商信息相关的接口--> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <!-- 用于访问 wifi 网络信息,wifi 信息会用于进行网络定位--> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> <!-- 这个权限用于获取 wifi 的获取权限,wifi 信息会用来进行网络定位--> <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" /> <!--用于访问网络,网络定位需要上网--> <uses-permission android:name="android.permission.INTERNET" /> <!-- 用于读取手机当前的状态--> <uses-permission android:name="android.permission.READ_PHONE_STATE" /> <!-- 写入扩展存储,向扩展卡写入数据,用于写入缓存定位数据--> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
设置 Key,在 application 标签中加入
<meta-data android:name="com.amap.api.v2.apikey" android:value="key" /> //开发者申请的 key
高德定位服务包含 GPS 和网络定位(Wi-Fi 和基站定位)两种能力。定位 SDK 将 GPS、网络定位能力进行了封装,以三种定位模式对外开放。
高精度定位模式:会同时使用网络定位和 GPS 定位,优先返回最高精度的定位结果;
低功耗定位模式:不会使用 GPS,只会使用网络定位(Wi-Fi 和基站定位);
仅用设备定位模式:不需要连接网络,只使用 GPS 进行定位,这种模式下不支持室内环境的定位。
注:请在主线程中声明 AMapLocationClient 类对象,需要传 Context 类型的参数。推荐用 getApplicationConext()方法获取全进程有效的 context。
//声明AMapLocationClient类对象 public AMapLocationClient mLocationClient = null; //声明定位回调监听器 public AMapLocationListener mLocationListener = new AMapLocationListener(); //初始化定位 mLocationClient = new AMapLocationClient(getApplicationContext()); //设置定位回调监听 mlocationClient.setLocationListener(mLocationListener);
设置定位参数包括:定位模式(高精度定位模式,低功耗定位模式和仅设备定位模式),是否返回地址信息等。
//声明mLocationOption对象 public AMapLocationOption mLocationOption = null; //初始化定位参数 mLocationOption = new AMapLocationClientOption(); //设置定位模式为高精度模式,Battery_Saving为低功耗模式,Device_Sensors是仅设备模 式 mLocationOption.setLocationMode(AMapLocationMode.Hight_Accuracy); //设置是否返回地址信息(默认返回地址信息) mLocationOption.setNeedAddress(true); //设置是否只定位一次,默认为false mLocationOption.setOnceLocation(false); //设置是否强制刷新WIFI,默认为强制刷新 mLocationOption.setWifiActiveScan(true); //设置是否允许模拟位置,默认为false,不允许模拟位置 mLocationOption.setMockEnable(false); //设置定位间隔,单位毫秒,默认为2000ms mLocationOption.setInterval(2000); //给定位客户端对象设置定位参数 mlocationClient.setLocationOption(mLocationOption); //启动定位 mlocationClient.startLocation();
接口只有 onLocationChanged 方法可以实现,用于接收异步返回的定位结果,参数是 AMapLocation 类型。
public void onLocationChanged(AMapLocation amapLocation) { if (amapLocation != null) { if (amapLocation.getErrorCode() == 0) { //定位成功回调信息,设置相关消息 amapLocation.getLocationType();//获取当前定位结果来源,如网络定位结果, 详见定位类型表 amapLocation.getLatitude();//获取经度 amapLocation.getLongitude();//获取纬度 amapLocation.getAccuracy();//获取精度信息 SimpleDateFormat df = new SimpleDateFormat( "yyyy-MM-dd HH:mm:ss"); Date date = new Date(amapLocation.getTime()); df.format(date);//定位时间 amapLocation.getAddress();//地址,如果option中设置isNeedAddress为 false,则没有此结果 amapLocation.getCountry();//国家信息 amapLocation.getProvince();//省信息 amapLocation.getCity();//城市信息 amapLocation.getDistrict();//城区信息 amapLocation.getRoad();//街道信息 amapLocation.getCityCode();//城市编码 amapLocation.getAdCode();//地区编码 } else { //显示错误信息ErrCode是错误码,errInfo是错误信息,详见错误码表。 Log.e("AmapError", "location Error, ErrCode:" + amapLocation.getErrorCode() + ", errInfo:" + amapLocation.getErrorInfo()); } } }
停止定位:
mlocationClient.stopLocation();//停止定位
销毁定位客户端:
mlocationClient. onDestroy();//销毁定位客户端
下面介绍结合高德地图 Android SDK,介绍如何显示定位小蓝点(详细信息,请参考com.location.apis.demo.MyLocationActivity.java):
/** * AMap地图中简单介绍显示定位小蓝点 */ 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(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; } }
目前手机设备在长时间黑屏或锁屏时 CPU 会休眠,这导致定位 SDK 不能正常进行位置更新。若您有锁屏状态下获取位置的需求,您可以应 用 alarmManager 实现 1 个可叫醒 CPU 的 Timer,定时请求定位。
使用定位 SDK 务必要注册 GPS 和网络的使用权限。
在使用定位 SDK 时,请尽量保证网络畅通,如获取网络定位,地址信息等都需要设备可以正常接入网络。
定位 SDK 在国内返回 gcj02 类型坐标,海外定位将返回原始坐标。
因为仅设备定位(通过 GPS 定位)是设备本地定位行为,是不返回地址信息的。