一、在AndroidStudio中新建一个Project
名字比如取为BaiduMapTest
二、 注册和获取密钥
什么是密钥
开发者在使用SDK之前需要获取百度地图移动版开发密钥(AK),该AK与您的百度账户相关联。请妥善保存您的AK,地图初始化时需要使用AK。
获取开发密钥(AK)
百度地图 SDK开发密钥的申请地址为:https://lbs.baidu.com/apiconsole/key
点击“创建应用”开始申请开发密钥,填写应用名称,注意应用类型选择“Android SDK”、正确填写SHA1 和 程序包名
1.获取SHA1
window资源管理器中
在此文件夹中打开cmd窗口
调试版本使用指令:keytool -list -v -keystore debug.keystore
发布版本请使用指令:keytool -list -v -keystore apk 的 keystore
调试版本默认密码是: android,发布模式的密码是apk的keystore设置的密码
2.获取包名
在app目录下的build.gradle文件中找到applicationId,并确保其值与AndroidManifest.xml中定义的package相同。
注意:使用Android Studio开发,如遇到applicationId 与package不一致的情况,以appclicationid为准。
三、下载开发包
普通的地图服务和包含步骑行导航的地图服务需要下载不同的开发包,点击下载开发包。
1、下载普通开发包
第二行选择基础地图服务
2、下载步骑行导航的开发包
第二行选择步骑行导航(含基础地图)
注: 其他的功能(如定位服务、检索功能、全景图功能等则根据您的开发需要下载)
四、将开发包拷贝至工程(截图以普通地图服务的开发包为例,步骑行导航的开发包同理)
1、添加jar文件
打开解压后的开发包文件夹,找到BaiduLBS_Android.jar文件将其拷贝至工程的app/libs目录下,如图:
2、添加so文件
在src/main/目录下新建jniLibs目录(如果您的项目中已经包含该目录不用重复创建),在下载的开发包中拷贝项目中需要的CPU架构对应的so文件文件夹到jniLibs目录,如图:
3往工程中添加jar文件
在工程配置中需要将前面添加的jar文件集成到我们的工程中。
在libs目录下,选中每一个jar文件(此处只有一个BaiduLbs_Android.jar)右键,选择Add As Library…,如图:
此时会发现在app目录的build.gradle的dependencies块中生成了工程所依赖的jar文件的对应说明,如下所示:
注意:最新版本的Android Studio中compile被替换为implementation,具体的写法与您的Android Studio版本有关。
五、显示地图
第一步 配置AndroidManifest.xml文件
1.在<application>中加入<meta-data>用来配置开发密钥(AK):
<meta-data android:name="com.baidu.lbsapi.API_KEY" android:value="开发者 key" />
其中"开发者 key"就是下图红框中的值
2. 在<application/>外部添加如下权限声明:
<!-- 访问网络,进行地图相关业务数据请求,包括地图数据,路线规划,POI检索等 --> <uses-permission android:name="android.permission.INTERNET" /> <!-- 获取网络状态,根据网络状态切换进行数据请求网络转换 --> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <!-- 读取外置存储。如果开发者使用了so动态加载功能并且把so文件放在了外置存储区域,则需要申请该权限,否则不需要 --> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> <!-- 写外置存储。如果开发者使用了离线地图,并且数据写在外置存储区域,则需要申请该权限 --> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
注:自Android6.0起部分权限的使用需要开发者在代码中动态申请。
3.在<application> 中添加<service>
<service android:name="com.baidu.location.f" android:enabled="true" android:process=":remote" > </service>
第二步 在布局文件中添加地图容器
MapView是View的一个子类,用于在Android View中放置地图。MapView的使用方法与Android提供的其他View一样。
<com.baidu.mapapi.map.MapView android:id="@+id/bmapView" android:layout_width="match_parent" android:layout_height="match_parent" android:clickable="true" />
第三步 地图初始化
注意:在SDK各功能组件使用之前都需要调用“SDKInitializer.initialize(getApplicationContext())”,因此建议在应用创建时初始化SDK引用的Context为全局变量。
新建一个自定义的Application,在其onCreate方法中完成SDK的初始化。示例代码如下:
在AndroidManifest.xml文件中声明该Application
第四步,创建地图Activity,管理MapView生命周期
注意:在项目中使用地图的时候要特别注意合理地管理地图生命周期,这非常重要。
构建程序并安装到手机上出问题
原因:
如果项目中存在多个module,那么在application模块中依赖library模块,并且library模块中有native代码的时候,假设你需要debug library模块中的这些native代码,正常情况下,这部分native代码是不能直接被debug的。导致这个问题的根本原因是因为即使在运行application模块的debug构建时,其依赖的library模块并不是以debug构建,而是以release构建。
解决方法:
打开app中的build.gradle文件
加上如下代码
完成以上工作即可在您的应用中显示地图: