下载文档

百度地图插件接入指引
更新时间:2016-09-02

百度地图插件是基于百度地图API封装的AppCan平台的插件模块。此文档适用于百度地图和百度导航2个插件模块。开发者集成及使用此插件,需要到百度开放平台为应用申请相应的APIKey, 并将APIKey配置到应用中。以下是具体步骤。

使用须知:配置的百度地图KEY与打包证书必须一致匹配,配合打包

1.申请成为开发者

访问。http://developer.baidu.com/map/index.php

2.进入API控制台

访问http://lbsyun.baidu.com/apiconsole/key

3.点击”创建应用”

系统将为您弹出创建APIKey页面,输入应用名称,将应用类型改为:“for mobile”,需要配置应用的安全码。

4.Android平台安全码

安全码的组成规则为:Android应用的签名证书的sha1值+“;”+应用包名(即:数字签名信息的sha1值+分号+包名),例如:

  1. 75:AC:5D:A2:BC:06:88:74:E5:51:DF:80:33:85:F1:40:E2:DC:4D:75;org.zywx.wbpalmstar.widgetone.uexbaidumap

注意:此签名和包名,必须和应用打包时的签名及包名一致。安卓安全码生成 详见 第6步

5.iOS平台安全码为应用的Bundle Identifier

ios安全码生成 详见 第7步

6.Android打包集成百度插件使用

1) 打包服务器中Android应用使用签名证书的SHA1

  1. 默认使用Appcan证书打包为:49:3E:52:87:09:E1:B4:D2:B8:FF:12:6E:2C:C8:40:6D:3B:5E:4D:BB

sha1值获取请参考 签名信息获取工具使用文档 ,也可 查看此配置方法

2) 自己定义Android包名必填项
例如: org.zywx.wbpalmstar.widgetone.uexbaidumap

3) 按照上述步骤,在百度开放平台上申请对应的APIKey。

4) 通过config配置APIKey。
在工程的config.xml文件中加入如下配置:

  1. <config desc="uexBaiduMap" type="KEY" >
  2. <param platform="Android" name="$uexBaiduMap_APIKey$" value="申请的APIKey"/>
  3. </config>

其中value属性值即为步骤3中申请的APIKey(百度地图中的AK)。

5) 在线打包

uexBaiduMap.onSDKReceiverError回调方法主要用于APIKey是否合法的检测,若APIKey不合法该方法被回调,也即应用的包名、签名和APIKey不匹配。

7.iOS打包集成百度插件使用

1) 使用发布版或企业版证书在打包服务器生成一个应用安装包(例如:testBaiduMap.ipa)

2) 将testBaiduMap.ipa重命名为testBaiduMap.zip,解压后找到info.plist文件,使用《plist Editor》plist文件编辑器打开,找到CFBundleIdentifier这个key对应的值(即Bundle Identifier),例如com.zywx.testBaiduMap。这个值就是申请百度地图APIKey所需要的安全码。(plist Editor下载地址: http://www.pc6.com/softview/SoftView_54561.html#download

3) 按照上述步骤,在百度开放平台上申请对应的APIKey

4) 通过config配置APIKey
在工程的config.xml文件中加入如下配置:

  1. <config desc="uexBaiduMap" type="KEY" >
  2. <param platform="iOS" name="$uexBaiduMap_APIKey$" value="申请的APIKey"/>
  3. </config>

其中value属性值即为步骤3中申请的APIKey(百度地图中的AK)。
5) 上传第一步的iOS打包证书,然后生成安装包

8.百度插件打包使用常见问题

  • 按照文档操作在百度开放平台申请的key后打开地图还是弹出报错信息。
    • 可能原因
    • 1、你在config.xml里面的key还是与百度申请的百度key不一致,请再次check
    • 2、打包时没有填写自定义包名/证书的bundleId和百度Key不匹配,请确认