地理定位服务对于我们的开发来说具有重要的作用,目前是市场上的很多App会选择获取你的地理位置信息,尤其是一些旅游类,生活类的信息服务App。例如:飞猪,美团,去哪儿旅行,饿了么等。万维网的实现,我们所在的世界就小了,不管你在哪里,都是一个个二维或者三维的坐标。
基于地理定位服务的核心就是确定用户所在的位置。通常有两种技术方式来实现:第一种是通过GPS定位,第二种是网络定位。GPS定位的工作原理是手机内置的GPS硬件与卫星交互来获取经纬度,这种定位方式精度准确,但是只能在室外进行,室内无法接收卫星信号。网络定位的工作原理是根据手机当前网络附近的三个基站来进行测速,计算手机之间的距离,然后通过三角定位得到大概的位置,这种定位方式一般,室内室外都可用。
因为特殊的原因,Google虽然提供了相应的API,但是国内不可用。所以我们一般借助第三方定位SDK来进行定位:百度地图,高德地图。
1. 申请API Key
在申请API Key之前,必须得注册成为百度开发者的账号,这里就按照它的提示去做就好了,不描述了。在申请完成之后,访问这个http://lbsyun.baidu.com/apiconsole/key 地址。
因为这里没有创建项目,所以空的。然后点击创建应用。应用名称,类型。然后按照自己的实际需要选择服务。
下面这里有个SHA1,我们需要打开Android Studio 的项目,点击右边的Gradle->项目包名->Tasks->android->signingReport(双击)
双击signingReport后,就可以查看你的MD5和SHA1了,如果没有出现,点一下这个/ab键。
这个就是我们需要的SHA1指纹,每个Android Studio 的指纹都不一样,我们使用debug.keystore文件生成的指纹,这个是Android Studio自动生成的用于测试的签名文件。如果你需要正式发布的时候需要创建一个签名文件。要得到它的指纹可以这样做: 在cmd中输入:
keytool -list -v -keystore <签名文件的路径名>
使用Android Studio 生成签名文件Build -> Generate signed APK文件。有的第一次可能会需要输入操作系统的密码,输完了之后点击OK就好了。进入这个界面
- 选择创建jks文件,并填写信息。填写信息的时候不要忘记密码了,最好将上下两个密码设置一样的,免得忘记。
- 创建完成之后,会自动保存你的key 和 value ,然后可能会需要输入设置的密码。
可以打包apk了。
接下来,我们可以输入之前的 keytool -list -v -keystore <签名文件的路径名>
-
最后回到百度地图页面,填上你想要的信息,点击提交
最后你就可以回到http://lbsyun.baidu.com/apiconsole/key,刷新就可以出现你创建的应用了。
这个udAn51qiTQY2XvxgDkBIR9ihq9hfKGj7就是你申请到的API Key。然后你就可以看是你的百度定位工作了。
2. 使用百度定位的准备
- 在你申请好了API Key的时候,现在可以下载LBS的SDK包,下载地址:http: //lbsyun.baidu.com/sdk/download。选择基础定位和基础地图就可以了。
-
在你选择好了之后,下载压缩包,解压效果如下图所示,然后将BaiduLBS_Android.jar包添加到Android Studio 中的libs中,然后右键单击Add as Library,将其他的文件新建一个包放在src/main/jniLibs ,用于存放so文件。
3. 确定经纬度
- 修改actiivty_main.xml,布局只有一个TextView控件,用于显示当前位置的经纬度。
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:layout_width="match_parent"
android:layout_height="match_parent">
<TextView
android:id="@+id/tv_postion"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Hello World!"
/>
</LinearLayout>
- 修改AndroidManifest.xml文件,添加权限,配置API Key。
主要是<meta-data>和<service>这两个不能忽视。<meta-data>的name不用改,value改成你申请的API Key,service不用改动。
<meta-data
android:name="com.baidu.lbsapi.API_KEY"
android:value="AK" />
<service android:name="com.baidu.location.f"
android:enabled="true"
android:process=":remote">
完整代码:
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.demo.bddemo">
<!-- 这个权限用于进行网络定位-->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"></uses-permission>
<!-- 这个权限用于访问GPS定位-->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"></uses-permission>
<!-- 用于访问wifi网络信息,wifi信息会用于进行网络定位-->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"></uses-permission>
<!-- 获取运营商信息,用于支持提供运营商信息相关的接口-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission>
<!-- 这个权限用于获取wifi的获取权限,wifi信息会用来进行网络定位-->
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE"></uses-permission>
<!-- 用于读取手机当前的状态-->
<uses-permission android:name="android.permission.READ_PHONE_STATE"></uses-permission>
<!-- 写入扩展存储,向扩展卡写入数据,用于写入离线定位数据-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission>
<!-- 访问网络,网络定位需要上网-->
<uses-permission android:name="android.permission.INTERNET" />
<!-- SD卡读取权限,用户写入离线定位数据-->
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"></uses-permission>
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:roundIcon="@mipmap/ic_launcher_round"
android:supportsRtl="true"
android:theme="@style/AppTheme">
<meta-data
android:name="com.baidu.lbsapi.API_KEY"
android:value="udAn51qiTQY2XvxgDkBIR9ihq9hfKGj7" />
<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>
- 在MainActiivty文件中完成对地理定位的操作,因为Android 6.0开始,对权限要求的提高,所以这里给了个删减版的。方便好看。首先我们创建一个LocationClient实例,然后调用registerLocationListener()方法注册定位监听器。获得地理位置信息之后,会返回一个BDLocation 对象。根据这个对象来获取定位的信息。
public class MainActivity extends AppCompatActivity {
private TextView tv_postion;
private LocationClient mLocationClient;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
tv_postion = (TextView) findViewById(R.id.tv_postion);
initLocation();
}
private void initLocation() {
mLocationClient = new LocationClient(getApplicationContext());
mLocationClient.registerLocationListener(new BDLocationListener() {
@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("定位方式:");
Log.e("tag","当前的定位方式="+bdLocation.getLocType());
if(bdLocation.getLocType() == BDLocation.TypeGpsLocation){
currentPosition.append("GPS");
}else if(bdLocation.getLocType() == BDLocation.TypeNetWorkLocation){
currentPosition.append("网络");
}
tv_postion.setText(currentPosition);
}
});
}
mLocationClient.start();
}
添加权限版本的:
public class MainActivity extends AppCompatActivity {
private TextView tv_postion;
private LocationClient mLocationClient;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
tv_postion = (TextView) findViewById(R.id.tv_postion);
initLocation();
List<String> 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(this,Manifest.permission.READ_PHONE_STATE)!=PackageManager.PERMISSION_GRANTED){
permissionList.add(Manifest.permission.READ_PHONE_STATE);
}
if(ContextCompat.checkSelfPermission(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, "必须同意所有的权限才能使用本程序", Toast.LENGTH_SHORT).show();
finish();
return;
}
}
requestLocation();
}else{
Toast.makeText(this, "发生了错误", Toast.LENGTH_SHORT).show();
}
break;
}
}
private void initLocation() {
mLocationClient = new LocationClient(getApplicationContext());
mLocationClient.registerLocationListener(new BDLocationListener() {
@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("定位方式:");
Log.e("tag","当前的定位方式="+bdLocation.getLocType());
if(bdLocation.getLocType() == BDLocation.TypeGpsLocation){
currentPosition.append("GPS");
}else if(bdLocation.getLocType() == BDLocation.TypeNetWorkLocation){
currentPosition.append("网络");
}
tv_postion.setText(currentPosition);
}
});
// mLocationClient.start();
}
获取error code:
public int getLocType ( )
返回值:
61 : GPS定位结果,GPS定位成功。
62 : 无法获取有效定位依据,定位失败,请检查运营商网络或者wifi网络是否正常开启,尝试重新请求定位。
63 : 网络异常,没有成功向服务器发起请求,请确认当前测试手机网络是否通畅,尝试重新请求定位。
65 : 定位缓存的结果。
66 : 离线定位结果。通过requestOfflineLocaiton调用时对应的返回结果。
67 : 离线定位失败。通过requestOfflineLocaiton调用时对应的返回结果。
68 : 网络连接失败时,查找本地离线定位时对应的返回结果。
161: 网络定位结果,网络定位定位成功。
162: 请求串密文解析失败。
167: 服务端定位失败,请您检查是否禁用获取位置信息权限,尝试重新请求定位。
502: key参数错误,请按照说明文档重新申请KEY。
505: key不存在或者非法,请按照说明文档重新申请KEY。
601: key服务被开发者自己禁用,请按照说明文档重新申请KEY。
602: key mcode不匹配,您的ak配置过程中安全码设置有问题,请确保:sha1正确,“;”分号是英文状态;且包名是您当前运行应用的包名,请按照说明文档重新申请KEY。
501~700:key验证失败,请按照说明文档重新申请KEY。
建议使用真机测试,模拟器测试容易出问题。
- 但是我们在实际中的位置不可能会一直没有变化的,而在默认的情况下mLocationClient 的start()方法只会定位一次啊。我们需要的是实时更新当前的位置。所以修改代码MainActivity.
public class MainActivity extends AppCompatActivity {
···
private void requestLocation() {
LocationClientOption option = new LocationClientOption();
option.setScanSpan(5000);
mLocationClient.setLocOption(option);
mLocationClient.start();
}
···
@Override
protected void onDestroy() {
super.onDestroy();
mLocationClient.stop();
}
}
增加LocationClientOption 对象,然后调用setScanSpan()的方法来更新,这里设置5000,每5秒更新一次。这样当你的位置移动的时候,就可以实时更新经纬度了。
5.但是只给你一个经纬度,你哪里知道你在哪里呢,你需要的是具体的地址
public class MainActivity extends AppCompatActivity {
···
private void requestLocation() {
LocationClientOption option = new LocationClientOption();
option.setScanSpan(5000);
option.setIsNeedAddress(true);
mLocationClient.setLocOption(option);
mLocationClient.start();
}
···
private void initLocation() {
mLocationClient = new LocationClient(getApplicationContext());
mLocationClient.registerLocationListener(new BDLocationListener() {
@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("定位方式:");
Log.e("tag","当前的定位方式="+bdLocation.getLocType());
if(bdLocation.getLocType() == BDLocation.TypeGpsLocation){
currentPosition.append("GPS");
}else if(bdLocation.getLocType() == BDLocation.TypeNetWorkLocation){
currentPosition.append("网络");
}
tv_postion.setText(currentPosition);
}
});
// mLocationClient.start();
}
}
定位结果选择的方法
//获取定位结果
location.getTime(); //获取定位时间
location.getLocationID(); //获取定位唯一ID,v7.2版本新增,用于排查定位问题
location.getLocType(); //获取定位类型
location.getLatitude(); //获取纬度信息
location.getLongitude(); //获取经度信息
location.getRadius(); //获取定位精准度
location.getAddrStr(); //获取地址信息
location.getCountry(); //获取国家信息
location.getCountryCode(); //获取国家码
location.getCity(); //获取城市信息
location.getCityCode(); //获取城市码
location.getDistrict(); //获取区县信息
location.getStreet(); //获取街道信息
location.getStreetNumber(); //获取街道码(门牌号)
location.getLocationDescribe(); //获取当前位置描述信息
location.getPoiList(); //获取当前位置周边POI信息
location.getBuildingID(); //室内精准定位下,获取楼宇ID
location.getBuildingName(); //室内精准定位下,获取楼宇名称
location.getFloor(); //室内精准定位下,获取当前位置所处的楼层信息
4. 使用百度Map
在使用百度地图之后,我们需要做的基本的功能就是在地图上定位到自己当前的位置。
- 修改activity_main.xml 文件
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical"
>
<TextView
android:id="@+id/tv_postion"
android:layout_width="match_parent"
android:layout_height="150dp"
android:text="Hello World!"
android:visibility="gone"
/>
<com.baidu.mapapi.map.MapView
android:id="@+id/map_bd"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:clickable="true"
/>
</LinearLayout>
- 修改MainActivity 文件,很简单的,首先调用SDKInitializer.initialize(getApplicationContext());来进行初始化操作,记得一定要在setContentView()之前,不然会出错。然后添加一个MapView,重写onResume() ,onPauser()和onDestory()三个方法对MapView进行管理。
public class MainActivity extends AppCompatActivity {
private LocationClient mLocationClient;
private MapView mapView;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
SDKInitializer.initialize(getApplicationContext());
setContentView(R.layout.activity_main);
mapView = (MapView) findViewById(R.id.map_bd);
```
}
@Override
protected void onResume() {
super.onResume();
mapView.onResume();
}
@Override
protected void onPause() {
super.onPause();
mapView.onPause();
}
@Override
protected void onDestroy() {
super.onDestroy();
···
mapView.onDestroy();
}
}
但是这样的地图显然不是我们想要的,我们需要的是可以直接定位到自己的当前的位置,并在地图上显示我的位置。
修改代码MainActivity文件,然后根据百度SDK中提供的BaiduMap类(地图总控制器),调用MapView的getMap()方法来获取BaiduMap的实例。得到了BaiduMap的实例之后,我们就可以对地图进行各种各样的操作。
因为默认显示的地图的位置是北京,所以我们想移动到自己的当前的位置并缩放大小怎么办?百度SDK中提供了LatLng 类来获取经纬度。它的构造方法接收两个参数,一个纬度,一个经度。再得到纬度和经度之后、我们想设置地图的经纬度和地图,需要用到MapStatus 类通过MapStatus.Builder的方法设置经纬度和地图。最后将设置好的属性装载到BaiduMap里面
LatLng ll = new LatLng(bdLocation.getLatitude(),bdLocation.getLongitude());
MapStatus.Builder builder = new MapStatus.Builder();
builder.target(ll).zoom(18.0f);
baiduMap.animateMapStatus(MapStatusUpdateFactory.newMapStatus(builder.build()));
为了防止对此调用animateMapStatus这个变量,我们添加一个布尔值。
if(isFirstLocate){
LatLng ll = new LatLng(bdLocation.getLatitude(),bdLocation.getLongitude());
MapStatus.Builder builder = new MapStatus.Builder();
builder.target(ll).zoom(18.0f);
baiduMap.animateMapStatus(MapStatusUpdateFactory.newMapStatus(builder.build()));
isFirstLocate = false;
}
这只是完成了移动到当前的位置,还没有显示我在地图的位置呢。百度SDK中有个MyLocationData的类,这个类封装了设备当前的地理位置。调用它的Build()方法,生成一个实例。
MyLocationData.Builder locationBuilder = new MyLocationData.Builder();
locationBuilder.latitude(bdLocation.getLatitude());
locationBuilder.longitude(bdLocation.getLongitude());
MyLocationData locationData = locationBuilder.build();
baiduMap.setMyLocationData(locationData);
完整的代码:
public class MainActivity extends AppCompatActivity {
private TextView tv_postion;
private LocationClient mLocationClient;
private MapView mapView;
private BaiduMap baiduMap;
private boolean isFirstLocate = true;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
SDKInitializer.initialize(getApplicationContext());
setContentView(R.layout.activity_main);
tv_postion = (TextView) findViewById(R.id.tv_postion);
mapView = (MapView) findViewById(R.id.map_bd);
baiduMap = mapView.getMap();
baiduMap.setMyLocationEnabled(true);
initLocation();
initBaiDuMap();
List<String> 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(this,Manifest.permission.READ_PHONE_STATE)!=PackageManager.PERMISSION_GRANTED){
permissionList.add(Manifest.permission.READ_PHONE_STATE);
}
if(ContextCompat.checkSelfPermission(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 initBaiDuMap() {
}
private void requestLocation() {
LocationClientOption option = new LocationClientOption();
option.setScanSpan(5000);
option.setIsNeedAddress(true);
mLocationClient.setLocOption(option);
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, "必须同意所有的权限才能使用本程序", Toast.LENGTH_SHORT).show();
finish();
return;
}
}
requestLocation();
}else{
Toast.makeText(this, "发生了错误", Toast.LENGTH_SHORT).show();
}
break;
}
}
private void initLocation() {
mLocationClient = new LocationClient(getApplicationContext());
mLocationClient.registerLocationListener(new BDLocationListener() {
@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("门牌号:").append(bdLocation.getStreetNumber()).append("\n");
currentPosition.append("定位方式:");
if(bdLocation.getLocType() == BDLocation.TypeGpsLocation ||bdLocation.getLocType() == BDLocation.TypeNetWorkLocation){
if(isFirstLocate){
LatLng ll = new LatLng(bdLocation.getLatitude(),bdLocation.getLongitude());
MapStatus.Builder builder = new MapStatus.Builder();
builder.target(ll).zoom(18.0f);
baiduMap.animateMapStatus(MapStatusUpdateFactory.newMapStatus(builder.build()));
isFirstLocate = false;
}
MyLocationData.Builder locationBuilder = new MyLocationData.Builder();
locationBuilder.latitude(bdLocation.getLatitude());
locationBuilder.longitude(bdLocation.getLongitude());
MyLocationData locationData = locationBuilder.build();
baiduMap.setMyLocationData(locationData);
}
// tv_postion.setText(currentPosition);
}
});
// mLocationClient.start();
}
@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();
baiduMap.setMyLocationEnabled(false);
}
}
这样就可以完成想要的效果了,写这一章的目的是为了方便讲解一下百度地图的基本用法,具体的内容还要看百度地图的开发文档。