Android使用第三方SDK——百度地图

本文介绍了如何在Android项目中快速集成并使用百度地图SDK,包括注册开发者账号、下载SDK、添加库文件、配置权限、申请及使用API Key、实现地图与定位功能的详细步骤,适合初学者参考。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

Android使用第三方SDK——百度地图

第一次用百度地图是在去年的8月中旬吧,当时是参加一个比赛,老师要求使用地图,然后就是百度,各种视频网站一顿搜啊(当时Android还没入门,就知道CV),最终效果实现了,但是到底是怎么实现的还是不太懂(当时用的是百度的),后来是因为百度的获取路径规划有点儿困难(毕竟还没入门,当时接触Android才一个月左右),后来换高德了,最终实现了,从开始知道百度地图,到现在已经用了好几次了,但大都是帮别人的,前几天在群里又发现有人问了,然后我自己写了一个可以实现地图+定位的给他,从开始创建项目,到功能实现没有10分钟,然后就想把这篇文章写出来了。哈哈,开车,开车~


  • 注册百度开发者账号+下载相关的SDK

相信大家都有百度网盘,然后登陆就用网盘账号就好啦~
接下来就是去下载相关的SDK包了,这里给出链接,当然大家可以去官网哈!
百度地图SDK相关下载
然后大家就会看到如下界面:

我们选择我们需要的功能进行下载,这里只演示:地图+定位,所以就只下载基础定位+基础地图选中后,点击开发包下载就好了,然后把压缩包解压,如下:


  • 将下载的jar和so文件集成到项目中

将jar文件copy到——ApplicationName/app/libs目录下如下:

在该jar右键点击Add As Library如下图所示:

将百度地图的jar添加到项目的闭包中。


添加so文件:
ApplicationName/app/src/main目录下新建jniLibs文件夹,并将所有的so文件都copy到该目录下,完成后如下:

将jniLibs添加到本地仓库中

打开ApplicationName/app/build.gradle并添加如下内容:

//添加本地仓库
repositories {
    flatDir {
        dirs 'libs'
    }
}

注意位置哈,最后的完成效果应该这样的,如下:

也就是说,添加本地仓库代码并不是在android中的,而是属于单独的一个。


  • 添加地图控件、添加开发者key、清单文件中申请权限、添加定位服务

既然添加key,那么必须要有key,我们先来申请key吧,先看下申请key的界面如下:

可以看到有两个挂*号,那么意思就是要必须填咯,包名简单,在清单文件中就有,相信大家都能找到的,那么SHA1在哪儿呢,简单的我们可以这样获取,如下图:

运行后如下图:

那里我标了一个箭头,意思就是有的Android Studio显示的若不是这个界面就去点击一下就好了(若是再不可以,那就去按照官方给的文档去获取就好了),然后就获取到正确的SHA1值啦!然后我们那个界面就能获取到key了。(额…那个获取key的界面,就在登陆账号右边有个api控制台,点进去就有创建应用按钮,点击就好了,然后选项为Android,再输入包名,SHA1,应用的名字就好啦~)。


添加开发者key,在清单文件中的Application中写如下代码(官方也有的):

 <meta-data  
        android:name="com.baidu.lbsapi.API_KEY"  
        android:value="开发者 key" />  

添加定位服务代码如下(官方也有…):

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

最终效果如下:

上面那个代码中的开发者key写自己申请的哈。


添加相关权限:
这个没什么说的了,直接去官方copy权限就好了,但是若是6.0系统的话,要注意处理下运行时权限哈,要不然会出错的,所有需要的权限如下:

    <uses-permission android:name="com.android.launcher.permission.READ_SETTINGS" />
    <uses-permission android:name="android.permission.WAKE_LOCK" />
    <uses-permission android:name="android.permission.GET_TASKS" />
    <uses-permission android:name="android.permission.WRITE_SETTINGS" />
    <!-- 这个权限用于进行网络定位-->
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <!-- 这个权限用于访问GPS定位-->
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <!-- 用于访问wifi网络信息,wifi信息会用于进行网络定位-->
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <!-- 获取运营商信息,用于支持提供运营商信息相关的接口-->
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <!-- 这个权限用于获取wifi的获取权限,wifi信息会用来进行网络定位-->
    <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" />
    <!-- SD卡读取权限,用户写入离线定位数据-->
    <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" />

添加地图控件:
这个……也没啥,直接去官方copy就好了,如下:

    <com.baidu.mapapi.map.MapView
        android:id="@+id/bmapView"
        android:layout_width="fill_parent"
        android:layout_height="fill_parent"
        android:clickable="true" />

这里要注意的是,根布局下就必须是该控件,不能有其他的,要不然会报错的。

  • 显示地图+定位

这个,就不再说了,直接上代码吧,所有的都在代码中注释好了,如下:
声明的变量:

    private static final String TAG = "MainActivity";
    private MapView mMapView;
    private BaiduMap mBaiduMap;
    //定位
    public LocationClient mLocationClient = null;
    public BDLocationListener myListener = new MyLocationListener();

onCreate方法:

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        //不能放在加载布局后
        SDKInitializer.initialize(getApplicationContext());
        setContentView(R.layout.activity_main);
        //初始化控件
        initView();
    }

initView方法:

    private void initView() {
        mMapView = (MapView) findViewById(R.id.bmapView);
        mBaiduMap = mMapView.getMap();
        //声明LocationClient类
        mLocationClient = new LocationClient(getApplicationContext());
        //注册监听函数
        mLocationClient.registerLocationListener(myListener);
        //初始化定位
        initLocation();
        //开启定位
        mLocationClient.start();
    }

initLocation方法:

    private void initLocation() {
        LocationClientOption option = new LocationClientOption();
        ////可选,默认高精度,设置定位模式,高精度,低功耗,仅设备
        option.setLocationMode(LocationClientOption.LocationMode.Hight_Accuracy);
        //可选,默认gcj02,设置返回的定位结果坐标系
        option.setCoorType("bd09ll");
        int span = 0;
        //可选,默认0,即仅定位一次,设置发起定位请求的间隔需要大于等于1000ms才是有效的
        option.setScanSpan(span);
        //可选,设置是否需要地址信息,默认不需要
        option.setIsNeedAddress(true);
        //可选,默认false,设置是否使用gps
        option.setOpenGps(true);
        //可选,默认false,设置是否当GPS有效时按照1S/1次频率输出GPS结果
        option.setLocationNotify(true);
        //可选,默认false,设置是否需要位置语义化结果,可以在BDLocation.getLocationDescribe里得到,结果类似于“在北京天安门附近”
        option.setIsNeedLocationDescribe(true);
        //可选,默认false,设置是否需要POI结果,可以在BDLocation.getPoiList里得到
        option.setIsNeedLocationPoiList(true);
        //可选,默认true,定位SDK内部是一个SERVICE,并放到了独立进程,设置是否在stop的时候杀死这个进程,默认不杀死
        option.setIgnoreKillProcess(false);
        //可选,默认false,设置是否收集CRASH信息,默认收集
        option.SetIgnoreCacheException(false);
        //可选,默认false,设置是否需要过滤GPS仿真结果,默认需要
        option.setEnableSimulateGps(false);
        mLocationClient.setLocOption(option);
    }

MyLocationListener(定位回调):

    //定位的回调
    public class MyLocationListener implements BDLocationListener {
        @Override
        public void onReceiveLocation(BDLocation location) {
            //Receive Location
            StringBuffer sb = new StringBuffer(256);
            sb.append("time : ");
            sb.append(location.getTime());
            sb.append("\nerror code : ");
            sb.append(location.getLocType());
            sb.append("\nlatitude : ");
            sb.append(location.getLatitude());
            sb.append("\nlontitude : ");
            sb.append(location.getLongitude());
            sb.append("\nradius : ");
            sb.append(location.getRadius());
            // GPS定位结果
            if (location.getLocType() == BDLocation.TypeGpsLocation) {
                sb.append("\nspeed : ");
                sb.append(location.getSpeed());// 单位:公里每小时
                sb.append("\nsatellite : ");
                sb.append(location.getSatelliteNumber());
                sb.append("\nheight : ");
                sb.append(location.getAltitude());// 单位:米
                sb.append("\ndirection : ");
                sb.append(location.getDirection());// 单位度
                sb.append("\naddr : ");
                sb.append(location.getAddrStr());
                sb.append("\ndescribe : ");
                sb.append("gps定位成功");
                // 网络定位结果
            } else if (location.getLocType() == BDLocation.TypeNetWorkLocation) {
                sb.append("\naddr : ");
                sb.append(location.getAddrStr());
                //运营商信息
                sb.append("\noperationers : ");
                sb.append(location.getOperators());
                sb.append("\ndescribe : ");
                sb.append("网络定位成功");
                // 离线定位结果
            } else if (location.getLocType() == BDLocation.TypeOffLineLocation) {
                sb.append("\ndescribe : ");
                sb.append("离线定位成功,离线定位结果也是有效的");
            } else if (location.getLocType() == BDLocation.TypeServerError) {
                sb.append("\ndescribe : ");
                sb.append("服务端网络定位失败,可以反馈IMEI号和大体定位时间到loc-bugs@baidu.com,会有人追查原因");
            } else if (location.getLocType() == BDLocation.TypeNetWorkException) {
                sb.append("\ndescribe : ");
                sb.append("网络不同导致定位失败,请检查网络是否通畅");
            } else if (location.getLocType() == BDLocation.TypeCriteriaException) {
                sb.append("\ndescribe : ");
                sb.append("无法获取有效定位依据导致定位失败,一般是由于手机的原因,处于飞行模式下一般会造成这种结果,可以试着重启手机");
            }
            sb.append("\nlocationdescribe : ");
            // 位置语义化信息
            sb.append(location.getLocationDescribe());
            // POI数据
            List<Poi> list = location.getPoiList();
            if (list != null) {
                sb.append("\npoilist size = : ");
                sb.append(list.size());
                for (Poi p : list) {
                    sb.append("\npoi= : ");
                    sb.append(p.getId() + " " + p.getName() + " " + p.getRank());
                }
            }
            //定位的结果
            Log.d(TAG, "定位结果 " + sb.toString());
            //移动到我的位置
            //设置缩放,确保屏幕内有我
            MapStatusUpdate mapUpdate = MapStatusUpdateFactory.zoomTo(18);
            mBaiduMap.setMapStatus(mapUpdate);
            //开始移动
            MapStatusUpdate mapLatlng = MapStatusUpdateFactory.
                    newLatLng(new LatLng(location.getLatitude(), location.getLongitude()));
            mBaiduMap.setMapStatus(mapLatlng);
            //绘制图层
            //定义Maker坐标点
            LatLng point = new LatLng(location.getLatitude(), location.getLongitude());
            //构建Marker图标
            BitmapDescriptor bitmap = BitmapDescriptorFactory.fromResource(R.drawable.ic_location);
            //构建MarkerOption,用于在地图上添加Marker
            OverlayOptions option = new MarkerOptions().position(point).icon(bitmap);
            //在地图上添加Marker,并显示
            mBaiduMap.addOverlay(option);
        }

        @Override
        public void onConnectHotSpotMessage(String s, int i) {

        }
    }

绑定生命周期:

    @Override
    protected void onDestroy() {
        super.onDestroy();
        mMapView.onDestroy();
    }

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

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

OK,这就是所有的代码了,相信大家可以看懂的,还有一个就是,这不只是copy官网的代码,只是实在是不得不copy了,但是官方的文档写的……额,说真的,不咋滴,哈哈,还是看下效果吧,如下:

手机定位显示:

打印log为:

哈哈,是可以成功运行的。



大家若是有什么不懂的,可以在下面评论区中留言哈,我看到后会回的,另外对android有兴趣的同学可以加我们程序员刘某人的群:555974449(若满则加后面的)、484167109,群里面有很多大神的,而且很热情,很热心的,大家不懂的可以问的。


代码已经上传的GitHub,链接如下:

Demo下载

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值