Android学习笔记——基于位置的服务

参考书籍：Android第一行代码（第二版）.郭霖著

只有移动设备上才能实现的技术——基于位置的服务（LBS）。定位通常有两种技术方式：GPS定位（精确度很高，只能室外使用）和网络定位（根据手机当前网络附近的三个基站测速，计算出手机和每个基站间距离，通过三角定位确定出大概位置，精确度一般，室内外都能使用）。

Android有相应API支持这两种定位方式，但网络定位API在中国用不了（Google网络服务在中国不可访问），而GPS在室内不能用，所以可采用国内第三方SDK（百度/高德）。

1、申请API Key

要在应用程序中使用百度LBS功能，需申请一个API Key（需有百度账号）。登录百度账号，打开http://developer.baidu.com/user/reg网址，填写注册信息，点击提交，然后去邮箱点击链接完成注册。接着访问http://lbsyun.baidu.com/apiconsole/key，同意百度开发者协议：

点击创建应用就可申请API Key.

SHA1指打包程序时所用签名文件的SHA1指纹，可通过Android Studio查看（打开任一项目，点击右侧工具栏的Gradle->项目名->:app->Tasks->android）:

找到signingReport任务并双击：
（Android Studio2.2版本）

执行结果中蓝色背景字符串即为所需的SHA1指纹，这里使用的时debug.keystore文件生成的指纹（Android自动生成用于厕纸的签名文件），当应用程序发布时还需创建正式的签名文件（在cmd中输入：keytool -list -v -keystore<签名文件路径>，然后输入正确密码即可）。
现在得到的SHA1指纹是开发版的，目前两个SHA1可都填成一样，包名可先预定下来（自己常用包名）。

点击提交：

中间的串码即为申请到的API Key。

2、使用百度定位

新建LBSTest项目，最好在手机上运行（真实位置数据）。

（1）准备LBS SDK

需先将百度LBS平台的SDK准备好，地址：http://lbsyun.baidu.com/sdk/download，将基础地图和定位功能SDK勾选，点击“开发包”下载按钮即可，解压缩后：

libs目录中，BaiduLBS_Android.jar文件是Java层使用到的，其他子目录下的so文件（C/C++编写，NDK编译出来的）是Native层要用的，百度已做好封装，只需放到正确位置即可。

将BaiduLBS_Android.jar复制到app模块下的libs目录下，在src/main->New->Directory名为jniLibs的目录，将压缩包中所有其他目录复制在此：

此时，由于是直接将Jar包复制到libs目录下，并没修改gradle文件，所以需手动点击一下Android Studio顶部工具栏中的Sync按钮，之后jar文件会多出向右的箭头：

表示项目已经能成功引用这些Jar包了。

（2）确定自己未知的经纬度

修改布局文件：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <TextView
        android:id="@+id/position_text_view"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />
</LinearLayout>

修改AndroidManifest.xml：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.jojo.lbstest">

    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/>
    <uses-permission android:name="android.permission.READ_PHONE_STATE"/>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
    <uses-permission android:name="android.permission.INTERNET"/>
    <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/>
    <uses-permission android:name="android.permission.WAKE_LOCK"/>
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <meta-data
            android:name="com.baidu.lbsapi.API_KEY"
            android:value="xK3jQUZCXDPxGBDyQqKTsX9UlWao4oh8"/>

        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

        <service android:name="com.baidu.location.f" android:enabled="true" android:process=":remote">

        </service>
    </application>

</manifest>

其中每个权限都是百度LBS SDK内部要用的，标签name部分是固定的value部分则是申请到的API Key.最后注册了LBS SDK中的服务（百度LBS SDK中的代码是混淆过的）。

修改MainActivity:

public class MainActivity extends AppCompatActivity {
    public LocationClient mlocationClient;
    private TextView positionText;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        mlocationClient = new LocationClient(getApplicationContext());//LocationClient构建方法接收Context参数，getApplicationContext获取一个全局Context参数
        mlocationClient.registerLocationListener(new MyLocationListener());//注册定位监听器，获取到位置信息时会回调
        setContentView(R.layout.activity_main);
        positionText = (TextView) findViewById(R.id.position_text_view);
        List<String> permissionList = new ArrayList<>();
        //ACCESS_COARSE_LOCATION、ACCESS_FINE_LOCATION、READ_PHONE_STATE、WRITE_EXTERNAL_STORAGE都是危险权限，而前两个属于同一个权限组（任取一个），所以只需申请三个权限
        //使用List集合一次性申请三个权限
        if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED){
            permissionList.add(Manifest.permission.ACCESS_FINE_LOCATION);
        }
        if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.READ_PHONE_STATE) != PackageManager.PERMISSION_GRANTED){
            permissionList.add(Manifest.permission.READ_PHONE_STATE);
        }
        if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED){
            permissionList.add(Manifest.permission.WRITE_EXTERNAL_STORAGE);
        }
        if (!permissionList.isEmpty()){
            String[] permissions = permissionList.toArray(new String[permissionList.size()]);//将List转换成数组
            ActivityCompat.requestPermissions(MainActivity.this, permissions,1);//使用此方法一次性申请
        }else {
            requestLocation();
        }
    }
    private void requestLocation(){
        initLocation();
        mlocationClient.start();//开始定位，定位的结果会回调到监听器中
    }
    private void initLocation(){
        LocationClientOption option = new LocationClientOption();
        option.setScanSpan(5000);//设置更新间隔，5s更新一下当前位置
        mlocationClient.setLocOption(option);
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        mlocationClient.stop();//停止定位
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        switch (requestCode){
            case 1:
                if (grantResults.length > 0){
                    for (int result : grantResults){//通过循环判断每一个申请权限
                        if (result != PackageManager.PERMISSION_GRANTED){
                            Toast.makeText(this, "必须同意所有权限才能使用本程序", Toast.LENGTH_SHORT).show();
                            finish();
                            return;
                        }
                    }
                    requestLocation();
                }else {
                    Toast.makeText(this, "发生未知错误", Toast.LENGTH_SHORT).show();
                }
                break;
            default:
        }
    }
    public class MyLocationListener extends BDAbstractLocationListener {

        @Override
        public void onReceiveLocation(BDLocation bdLocation) {
            StringBuilder currentPosition = new StringBuilder();
            currentPosition.append("纬度：").append(bdLocation.getLatitude()).append("\n");
            currentPosition.append("经度：").append(bdLocation.getLongitude()).append("\n");
            currentPosition.append("定位方式：");
            if (bdLocation.getLocType() == BDLocation.TypeGpsLocation){
                currentPosition.append("GPS");
            }else if (bdLocation.getLocType() == BDLocation.TypeNetWorkLocation){
                currentPosition.append("网络");
            }
            positionText.setText(currentPosition);
        }
    }
}

运行程序，允许权限，移动手机查看变化：

（3）选择定位模式

之前使用的一直是网络定位，要切换到GPS定位必须要用户主动启动。进入手机的设置->位置信息：

点击模式可选择具体定位模式（都有说明），想使用GPS则选择高精度模式或仅限设备模式：

这只表示同意让应用程序对手机进行GPS定位，只有当定位操作真正开始才会影响手机电量。

可在initLocation()方法中对百度LBS SDK定位模式进行指定，三种模式可选：Hight_Accuracy（默认模式，GPS信号正常时优先使用GPS，无法接收GPS信号时使用网络定位）、Battery_Saving（只使用网络定位）和Device_Sensors（只使用GPS定位）。即使不修改代码，将手机拿到室外会自动切换到GPS定位模式，也可强制指定只是用GPS定位，修改MainActivity:

private void initLocation(){
        LocationClientOption option = new LocationClientOption();
        option.setScanSpan(5000);//设置更新间隔，5s更新一下当前位置
        option.setLocationMode(LocationClientOption.LocationMode.Device_Sensors);
        mlocationClient.setLocOption(option);
    }

重新运行程序，将手机拿到室外才能看到位置信息。

（4）位置信息易懂

百度LBS SDK提供了很好的支持，只需调用一些简单接口聚能得到当前位置各种丰富信息。修改MainActivity:

public class MainActivity extends AppCompatActivity {
    ...
    private void initLocation(){
        LocationClientOption option = new LocationClientOption();
        option.setScanSpan(5000);//设置更新间隔，5s更新一下当前位置
        option.setIsNeedAddress(true);//表示要获取当前位置的详细信息，获取地址信息一定要用网络，所以即使时Device_Sensors模式也会自动开启网络定位功能
        mlocationClient.setLocOption(option);
    }

   ...

    public class MyLocationListener extends BDAbstractLocationListener {

        @Override
        public void onReceiveLocation(BDLocation bdLocation) {
            StringBuilder currentPosition = new StringBuilder();
            currentPosition.append("纬度：").append(bdLocation.getLatitude()).append("\n");
            currentPosition.append("经度：").append(bdLocation.getLongitude()).append("\n");
            currentPosition.append("国家：").append(bdLocation.getCountry()).append("\n");
            currentPosition.append("省：").append(bdLocation.getProvince()).append("\n");
            currentPosition.append("市：").append(bdLocation.getCity()).append("\n");
            currentPosition.append("区：").append(bdLocation.getDistrict()).append("\n");
            currentPosition.append("街道：").append(bdLocation.getStreet()).append("\n");
            currentPosition.append("定位方式：");
            if (bdLocation.getLocType() == BDLocation.TypeGpsLocation){
                currentPosition.append("GPS");
            }else if (bdLocation.getLocType() == BDLocation.TypeNetWorkLocation){
                currentPosition.append("网络");
            }
            positionText.setText(currentPosition);
        }
    }
}

重新运行程序：

3、使用百度地图

应用程序中也可加入地图功能。

（1）显示地图

之前下载的LBS SDK中就包括了地图功能，修改布局文件：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <TextView
        android:id="@+id/position_text_view"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" 
        android:visibility="gone"/>
    <com.baidu.mapapi.map.MapView
        android:id="@+id/bmapView"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:clickable="true"/>

</LinearLayout>

加上了百度提供的自定义控件。修改MainActivity:

public class MainActivity extends AppCompatActivity {
   ...
    private MapView mapView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        ...
        SDKInitializer.initialize(getApplicationContext());//初始化操作，一定要在setContentView之前调用，否则会出错
        setContentView(R.layout.activity_main);
        mapView = (MapView) findViewById(R.id.bmapView); 
       ...
    }

    @Override
    protected void onResume() {
        super.onResume();
        mapView.onResume();
    }

    @Override
    protected void onPause() {
        super.onPause();
        mapView.onPause();
    }

   ...
    @Override
    protected void onDestroy() {
        super.onDestroy();
        mlocationClient.stop();//停止定位
        mapView.onDestroy();
    }

重写了onResume、onPause和onDestroy，保证资源能及时得到释放。

重新运行程序：

（2）移动到自己的位置

目前看到的是一张默认地图（北京市中心位置）。

百度LBS SDK中的API提供了一个BaiduMap类（地图的总控制器，调用MapView的getMap()方法就能获取实例），得到实例后就能进行各种操作。

百度地图限定缩放级别的取值范围为3-19（小数点位置值可取，值越大越精细）。

让地图移动到某一经纬度上需借助LatLng类（没太多用法，主要用于存放经纬度值，构造方法接收两个参数：纬度值、经度值）。

修改MainActivity:

public class MainActivity extends AppCompatActivity {
    ...
    private BaiduMap baiduMap;
    private boolean isFirstLocation = true;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        ...
        baiduMap = mapView.getMap();
        ...
    }

    private void navigateTo(BDLocation bdLocation){
        if (isFirstLocation){//防止多次调用animateMapStatus，移动到当前位置只需程序第一次定位时调用一次即可
            LatLng latLng = new LatLng(bdLocation.getLatitude(),bdLocation.getLongitude());
            MapStatusUpdate update = MapStatusUpdateFactory.newLatLng(latLng);
            baiduMap.animateMapStatus(update);//将地图移动到指定经纬度上
            update = MapStatusUpdateFactory.zoomTo(16f);//zoomTo方法接收一个float型参数，设置缩放级别，返回一个MapStatusUpdate对象
            baiduMap.animateMapStatus(update);//完成缩放
            isFirstLocation = false;
        }
    }

    ...
    public class MyLocationListener extends BDAbstractLocationListener {

        @Override
        public void onReceiveLocation(BDLocation bdLocation) {
        //当定位到设备当前位置时把BDLocation对象传给navigateTo()方法
            if (bdLocation.getLocType() == BDLocation.TypeGpsLocation || bdLocation.getLocType() == BDLocation.TypeNetWorkLocation){
                navigateTo(bdLocation);
            }
        }
    }
}

重新运行程序：

（3）显示“我”

地图上一般会有小光标显示当前所在位置，随着设备移动而移动。百度LBS SDK中提供了MyLocationData.Builder类（封装设备当前所在位置，只需将经纬度信息传入相应方法中即可）。此类还提供了一个Build()方法（将要封装的信息设置完后调用，会生成MyLocationData实例，将此实例传入BaiduMap的setMyLocationData()中就可显示了）。
修改MainActivity:

protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        mlocationClient = new LocationClient(getApplicationContext());//LocationClient构建方法接收Context参数，getApplicationContext获取一个全局Context参数
        mlocationClient.registerLocationListener(new MyLocationListener());//注册定位监听器，获取到位置信息时会回调
        SDKInitializer.initialize(getApplicationContext());//初始化操作，一定要在setContentView之前调用，否则会出错
        setContentView(R.layout.activity_main);
        mapView = (MapView) findViewById(R.id.bmapView);
        baiduMap = mapView.getMap();
        baiduMap.setMyLocationEnabled(true);//开启显示位置功能
        ...
    }

    private void navigateTo(BDLocation bdLocation){
        if (isFirstLocation){//防止多次调用animateMapStatus，移动到当前位置只需程序第一次定位时调用一次即可
            LatLng latLng = new LatLng(bdLocation.getLatitude(),bdLocation.getLongitude());
            MapStatusUpdate update = MapStatusUpdateFactory.newLatLng(latLng);
            baiduMap.animateMapStatus(update);//将地图移动到指定经纬度上
            update = MapStatusUpdateFactory.zoomTo(16f);//zoomTo方法接收一个float型参数，设置缩放级别，返回一个MapStatusUpdate对象
            baiduMap.animateMapStatus(update);//完成缩放
            isFirstLocation = false;
        }
        MyLocationData.Builder locationBuilder = new MyLocationData.Builder();
        locationBuilder.latitude(bdLocation.getLatitude());
        locationBuilder.longitude(bdLocation.getLongitude());
        MyLocationData locationData = locationBuilder.build();
        baiduMap.setMyLocationData(locationData);
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        mlocationClient.stop();//停止定位
        mapView.onDestroy();
        baiduMap.setMyLocationEnabled(false);//关闭此功能
    }

根据百度地图限制，想要使用这一功能要事先调用BaiduMap的setMyLocationEnabled()开启此功能，在程序退出时记得关闭此功能。

运行程序：

由于百度LBS SDK版本随时可能更新，参考官网的开发指南学习。