《第一行代码Android》学习总结第十一章 基于位置的服务

        基于位置的服务，简称LBS。它的工作原理就是利用无线电通讯网络或GPS等定位方式来确定出移动设备所在的位置。

通常有两种技术方式可以实现：

        1、通过GPS定位，主要工作原理是基于手机内置的GPS硬件直接和卫星交互来获取当前经纬度信息，这种定位方式精确度非常高，但缺点是只能在室外使用，室内基本无法接收到卫星信号。

        2、通过网络定位，主要工作原理是根据手机当前网络附近的三个基站进行测速，以此计算出手机和每个基站之间的距离，再通过三角定位确定出一个大概的位置，这种定位方式精确度一般，但优点是室内室外都可以使用。

 

一、使用百度定位

（一）准备LBS SDK

1、从百度LBS开放平台下载SDK，如图点击“开发包”下载按钮下载基础定位与基础地图开放包。

2、解压压缩包，其中存在一个libs目录，其中BaiduLBS_Android.jar文件是Java层要使用到的，其他子目录下的so文件是Native层要用到的。

3、将BaiduLBS_Android.jar复制到app模块下的libs目录。

4、在src/main目录下右击→New→Directory,创建一个jniLibs目录专门存放so文件，将压缩包内其他所有目录直接复制到jniLibs目录。

5、点击Sync按钮同步项目。

（二）确定自己位置的经纬度

1、修改activity_main.xml中代码，添加一个TextView用于显示经纬度信息。

2、修改AndroidManifest中代码，添加权限声明，注册LBS SDK中的服务，添加标签，其中android:name为固定值，android:value为申请到的API Key。

3、修改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());
//获取到位置信息时会回调该定位监听器
        mLocationClient.registerLocationListener(new MyLocationListener());
        setContentView(R.layout.activity_main);
        positionText = (TextView) findViewById(R.id.position_text_view);
//动态申请权限
        List permissionList = new ArrayList<>();
        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()]);
            ActivityCompat.requestPermissions(MainActivity.this, permissions, 1);
        }
        else{
            requestLocation();
        }

    }

private void requestLocation() {
//开始定位，定位结果会回调到前面注册的监听器中
        mLocationClient.start();
    }

    @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, "You must allow all the permissions", Toast.LENGTH_SHORT).show();
                            finish();
                            return;
                        }
                    }
                    requestLocation();
                }else {
                    Toast.makeText(this, "Error", Toast.LENGTH_SHORT).show();
                    finish();
                }
                break;
            default:
        }
    }
    public class MyLocationListener implements BDLocationListener{
        @Override
        public void onReceiveLocation(final BDLocation bdLocation) {
            runOnUiThread(new Runnable() {
                @Override
                public void run() {
                    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);
                }
            });
        }
    }
}

        因为存在多个权限申请，在申请权限时采用了一种新的用法，首先创建一个空的集合，然后依次判断这三个权限有没有被授权，如果没有则添加到List集合中，最后将List集合转换为数组，在调用ActivityCompat.requestPermissions()方法一次性申请。

        同样在回调方法onRequestPermissionsResult()中，我们通过一个循环将每个权限申请进行判断，如果有一个权限申请被拒绝那么直接调用finish()方法关闭当前程序。只有当所有权限都被用户同意了才会调用requestLocation()方法开始定位。

（三）实时更新当前位置

public class MainActivity extends AppCompatActivity {
   ……
  private void requestLocation() {
        initLocation();
        mLocationClient.start();
}
  private void initLocation() {
        LocationClientOption option = new LocationClientOption();
//设置时间间隔 3000代表每三秒更新一次当前位置。
        option.setScanSpan(3000);
        mLocationClient.setLocOption(option);
}
@Override
    protected void onDestroy() {
        super.onDestroy();
//活动销毁时停止定位
        mLocationClient.stop();
}
……
}

（四）选择定位模式

1）Hight_Accuracy表示高精度模式，会在GPS信号正常的情况下优先使用GPS定位，在无法接收GPS信号时使用网络定位，

2）Battery_Saving表示节电模式，只会使用网络进行定位。

3）Device_Sensors表示传感器模式，只会使用GPS定位。

public class MainActivity extends AppCompatActivity {
   ……
  private void initLocation() {
        LocationClientOption option = new LocationClientOption();
        option.setScanSpan(3000);
//设置定位模式为传感器模式
        option.setLocationMode(LocationClientOption.LocationMode.Device_Sensors);
        mLocationClient.setLocOption(option);
  }
    ……
}

（五）获取看得懂的位置信息——国家，省，市，区，街道

public class MainActivity extends AppCompatActivity {
   ……
  private void initLocation() {
        LocationClientOption option = new LocationClientOption();
        option.setScanSpan(3000);
//获取当前位置的详细地址信息
        option.setIsNeedAddress(true);
        mLocationClient.setLocOption(option);
}
……
    public class MyLocationListener implements BDLocationListener{
        @Override
        public void onReceiveLocation(final BDLocation bdLocation) {
            runOnUiThread(new Runnable() {
                @Override
                public void run() {
                    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);

                }
            });
        }
    }
       ……
}

二、使用百度地图

（一）显示地图

1、修改activity_main.xml中代码，添加com.baidu.mapapi.map.MapView地图控件，将TextView的visibility指定为gone。

2、修改MainActivity中代码。

public class MainActivity extends AppCompatActivity {
   ……
   private MapView mapView;
@Override
 protected void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
       mLocationClient = new LocationClient(getApplicationContext());
       mLocationClient.registerLocationListener(new MyLocationListener());
//初始化操作，在setContentView()方法之前操作。
       SDKInitializer.initialize(getApplicationContext());
       setContentView(R.layout.activity_main);
       mapView = (MapView) findViewById(R.id.bmapView);
         ……
}
  ……
//重写onResume()、onPause()、onDestroy()方法，对MapView进行管理以保证资源能够及时释放。
@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();
    }
    ……
}

（二）使地图移动到自己的位置。

1）百度LBS SDK 中API提供的BaiduMap类是一个地图的总控制器，调用BaiduMap类的getMap()方法获取BaiduMap实例。

BaiduMap baiduMap = mapView.getMap();

2）设置地图的缩放级别，取值范围为3到19之间，可以去小数点，值越大越精确。

MapStatusUpdate update = MapStatusUpdateFactory.zoomTo(16f);//设置缩放级别
baiduMap.animateMapStatus(update);  //将MapStatusUpdate传入BaiduMap完成缩放功能

3）移动地图到某一经纬度，需要借助LatLng类，其构造方法接受两个参数：纬度值和经度值。

LatLng ll = new LatLng(bdLocation.getLatitude(), bdLocation.getLongitude());
MapStatusUpdate update = MapStatusUpdateFactory.newLatLng(ll);//传入LatLng对象
baiduMap.animateMapStatus(update); //将MapStatusUpdate传入BaiduMap完成移动功能

 

1、修改MainActivity中的代码。

public class MainActivity extends AppCompatActivity {
   ……
private BaiduMap baiduMap;
private boolean isFirstLocate = true;
@Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        mLocationClient = new LocationClient(getApplicationContext());
        mLocationClient.registerLocationListener(new MyLocationListener());
        SDKInitializer.initialize(getApplicationContext());
        setContentView(R.layout.activity_main);
        mapView = (MapView) findViewById(R.id.bmapView);
//获取BaiduMap实例
        baiduMap = mapView.getMap();
        ……
}
private void navigateTo(BDLocation bdLocation) {
// isFirstLocate变量为了防止多次调用animateMapStatus()方法，因为将地图移动到当前位置只需要在程序第一次定位时调用即可
        if(isFirstLocate){
//设置地图缩放级别和将地图移动到当前经纬度
           LatLng ll = new LatLng(bdLocation.getLatitude(), bdLocation.getLongitude());
           MapStatusUpdate update = MapStatusUpdateFactory.newLatLng(ll);
           baiduMap.animateMapStatus(update);
           update = MapStatusUpdateFactory.zoomTo(16f);
           baiduMap.animateMapStatus(update);
           isFirstLocate = false;
        }
}
public class MyLocationListener implements BDLocationListener{
        @Override
        public void onReceiveLocation(final BDLocation bdLocation) {
            if(bdLocation.getLocType() == BDLocation.TypeGpsLocation || bdLocation.getLocType() == BDLocation.TypeNetWorkLocation){
                navigateTo(bdLocation);
            }
        }
    }
}

（三）在地图上显示用户位置

1）百度LBS SDK 中API提供的MyLocationData.Builder类，是用来封装设备当前所在位置的，只需将经纬度信息传入该类的相应方法即可。

MyLocationData.Builder locationBuilder = new MyLocationData.Builder();
locationBuilder.latitude(39.915);
locationBuilder.longitude(116.404);

2）当封装的信息设置完成之后，调用MyLocationData.Builder的build()方法会生成一个MyLocationData实例，再将这个实例传入BaiduMap的setMyLocationData()方法，即可让当前设备的位置显示在地图上了。

MyLocationData locationData = locationBuilder.build();
baiduMap.setMyLocationData(locationData);

 

1、修改MainActivity中的代码。

public class MainActivity extends AppCompatActivity {
    ……
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        mLocationClient = new LocationClient(getApplicationContext());
        mLocationClient.registerLocationListener(new MyLocationListener());
        SDKInitializer.initialize(getApplicationContext());
        setContentView(R.layout.activity_main);
        mapView = (MapView) findViewById(R.id.bmapView);
        baiduMap = mapView.getMap();
//开启显示当前设备位置功能
        baiduMap.setMyLocationEnabled(true);
        ……
    }
private void navigateTo(BDLocation bdLocation) {
       if(isFirstLocate){
//让地图移动到当前位置只需要在第一次定位时执行，执行一次
           LatLng ll = new LatLng(bdLocation.getLatitude(), bdLocation.getLongitude());
           MapStatusUpdate update = MapStatusUpdateFactory.newLatLng(ll);
           baiduMap.animateMapStatus(update);
           update = MapStatusUpdateFactory.zoomTo(16f);
           baiduMap.animateMapStatus(update);
           isFirstLocate = false;
       }
//设备在地图上显示的位置应随着设备的移动而实时改变，执行多次
        MyLocationData.Builder locationBuilder = new MyLocationData.Builder();
        locationBuilder.latitude(bdLocation.getLatitude());
        locationBuilder.longitude(bdLocation.getLongitude());
        MyLocationData myLocationData = locationBuilder.build();
        baiduMap.setMyLocationData(myLocationData);
}
    @Override
    protected void onDestroy() {
        super.onDestroy();
        mLocationClient.stop();
        mapView.onDestroy();
//关闭显示当前设备位置功能
        baiduMap.setMyLocationEnabled(false);
    }
}