浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。

Android 定位SDK

开发者在自己的Android移动应用中集成定位SDK,可轻松实现获取当前位置信息的功能。获取当前位置信息,即我们常说的定位。其中位置信息主要包括经纬度、地址、位置描述、周边POI等

使用Android定位SDK为什么需要申请AK?

定位SDK自v4.0版本之后,引入了百度地图开放平台的统一AK验证体系。

通过AK验证机制,开发者可以更方便、更安全地配置自身使用的百度地图资源(如服务配额等)。

随着百度地图开放平台的发展,未来您还可以通过AK获得更多服务(如提升服务次数、定制化服务等)。

注意:

1. 当您选择使用v4.0及之后版本的定位SDK时,需要先申请且配置AK,并在程序相应位置填写您的AK。(选择使用v3.3及之前版本SDK的开发者,不需要使用AK)

2. 每个AK仅且唯一对于1个应用验证有效,即对该AK配置环节中使用的包名匹配的应用有效。因此,多个应用(包括多个包名)需申请多个AK,或者对1个AK进行多次配置。

3. 若您需要在同一个工程中同时使用Android定位SDK和Android地图SDK,可以使用同一个AK。

获取AK的流程

获取AK的流程大致可分为如下四个步骤:(1)登录API控制台;(2)创建应用;(3)配置SHA1和包名;(4)提交生成AK。

接下来向各位开发者做详细介绍:

1登录API控制台
API控制台的地址为:http://lbsyun.baidu.com/apiconsole/key

输入网址,进入API控制台。如果您还未登录,会显示如下页面,输入帐号及密码,点击登录,即可正常进入API控制台;

如果您还不是我们百度地图开放平台的开发者用户,请点击立即注册,按照流程指引,一步一步完成开发者注册工作,然后再进入API控制台获取AK。

在注册、登录等环节中,如遇问题,请及时通过官方论坛向我们反馈。

login.png
2创建应用
进入API控制台后,您将看到如下界面,点击创建应用,开始填写相关信息,并最终获得AK。此外,在API控制台您还可以查看、修改、删除之前所创建的AK。 apicontrol.png
3配置SHA1和包名
点击创建应用,将会进入如下页面,在这个页面中,开发者需要填写应用名称、选择应用类型和配置SHA1及包名。

apicontrol1.png

a. 应用名称:开发者请自行定义,建议与应用名称一致,便于管理;

b. 应用类型:开发者请注意选择为Android SDK,选择其他类型,将导致所生成的AK不可用;(启用服务默认全部启用即可)

c. 填写SHA1和包名:这两个信息请开发者注意准确填写,它们是AK验证合法性的唯一依据。SHA1和包名的获取方式,请参考如下介绍:

(一)SHA1的获取方法:

SHA1分为发布版和开发版,便于开发者开发调试和最终上线使用。

获取方式一:通过Eclipse获取

使用 adt 22 以上版本,可以在 Eclipse 中直接查看,具体位置如下:

Windows:依次在 Eclipse 中打开 Window -> Preferances -> Android -> Build。

Mac:依次在 Eclipse 中打开 Eclipse/ADT->Preferances -> Android -> Build。

在弹出的对话框中SHA1 fingerprint中的值即为 Android 签名证书的 SHA1 值,如下图所示:

eclipsegetsha1.png

获取方式二:通过Android Studio获取

1. 打开Android Studio,进入Terminal工具,如下图所示:

asgetsha1.png

2. 输入命令行和密码,即可获取SHA1等信息。

命令行:keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey (注意目录选择、开发版本、发布版本等问题);

密码:原始密码一般为android,开发者根据实际情况填写。

asgetsha11.png

获取方式三:使用 keytool(jdk自带工具)获取

1. 运行进入控制台。

Windows:运行 -> 输入cmd -> 确定。

Mac:直接打开 终端。

2. 在控制台内,定位到.android文件夹,输入cd .android。

Windows与Mac操作一致,如下截图为Mac效果。

jdkgetsha1.png

3. 输入命令行和密码,获取SHA1等信息。

命令行:keytool -list -v -keystore debug.keystore;

密码:原始密码一般为android,开发者根据实际情况填写。

注意:

调试版本使用 debug.keystore,命令为:keytool -list -v -keystore debug.keystore。 发布版本使用 apk 对应的 keystore,命令为:keytool -list -v -keystore apk 的 keystore。

jdkgetsha11.png

(二)包名的获取方法:

获取方式一:在Eclipse中获取

适用于使用Eclipse开发工具的开发者。

打开 Android 项目的 AndroidManifest.xml 配置文件,package 属性所对应的内容为应用包名,如下图所示:

eclipsegetpcn.png

获取方式二:在Android Studio中获取

适用于使用Android Studio开发工具的开发者。

Android Studio可以通过applicationId配置包名,如果配置了build.gradle文件,包名应该以applicaionId为准,防止build.gradle中的applicationId与 AndroidMainfest.xml中的包名不同,导致AK鉴权失败。

asgetpcn.png
4提交生成AK
以上各项信息确认填写无误后,点击提交,系统自动生成AK。

获取AK过程中,如遇问题,请及时通过官方论坛与我们取得联系。

请开发者妥善保管生成的AK。

getkey.png