V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
zhangying02
V2EX  ›  程序员

如何在安卓平台上实现定位?

  •  
  •   zhangying02 · 2016-09-23 19:52:10 +08:00 · 1422 次点击
    这是一个创建于 2939 天前的主题,其中的信息可能已经有所发展或是发生改变。

    本文详细讲解了如何配置环境,如何实现定位,以及公布了定位代码。

    一、如何配置环境?

    1 、 Eclipse 的配置

    下载 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>
    

    2 、 Android Studio 配置工程

    新建工程如图所示:

    在工程的 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 和相关权限

    3 、代码混淆

    在生成 apk 进行代码混淆时进行如下配置(如果爆出 warning ,在报出 warning 的包加入类似的语句:-dontwarn 包名)

    定位
     -keep class com.amap.api.location.**{*;}
     -keep class com.aps.**{*;}
    

    二、如何实现定位?

    使用定位 SDK 即可实现定位。下载链接 http://lbs.amap.com/api/android-location-sdk/down/

    1 、定位 SDK 简介

    Android 定位 SDK 是一套简单的 LBS 服务定位接口,您可以使用这套定位 API 获取定位结果(包括全球定位、辅助 H5 页面定位功能)、逆 地理编码(地址的文字描述)、以及地理围栏功能。

    支持 Android 4.0 及以上系统。

    为保证服务可以正常使用,您需要注册成为开发者并申请 Key 。注册地址: http://lbs.amap.com/console/

    2 、配置 AndroidManifest.xml

    首先,请在在 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
    

    3 、启动定位功能

    高德定位服务包含 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();
    

    第三步,实现 AMapLocationListener 接口,获取定位结果 AMapLocationListener 接口只有 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();//销毁定位客户端
    

    4 、实现"定位小蓝点"

    下面介绍结合高德地图 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 定位)是设备本地定位行为,是不返回地址信息的。


    即日起至 2016/10/31 止,凡注册成为高德开发者的新用户,即可获赠 1 张阿里云优惠券,可享受最低 6 折购买阿里云产品。数量有限,发完即止。详情点击: http://lbsbbs.amap.com/forum.php?mod=viewthread&tid=20143


    目前尚无回复
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   4028 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 23ms · UTC 05:19 · PVG 13:19 · LAX 22:19 · JFK 01:19
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.