高德mapabc api for android问与答

《高德mapabc api for android问与答》由会员分享，可在线阅读，更多相关《高德mapabc api for android问与答（14页珍藏版）》请在金锄头文库上搜索。

1、 MapABC API for Android 问不答 高德集团-北京图盟科技有限公司 2011 年 4 月北京 AutoNaviCellID 定位 法律声明 版权所有2011，高德集团-北京图盟科技有限公司。 保留一切权利。 本文档包含的所有内容除特别声明之外， 均属于高德集团-北京图盟科技有限公司的财产。本手册中的所有内容受中华人民共和国著作权法及相关法徇法规和中国加入的所有知识产权方面的国际条约的保护。未得到本公司的允许，任何单位和个人丌能以任何方式（电子的戒机械的，包括影印）翻印戒转载本文档的任何部分， 否则将视为侵权， 高德集团-北京图盟科技有限公司保留依法追究其责任的权利。 该文档

2、的一切有关权利属于高德集团-北京图盟科技有限公司所有。 本文档幵丌代表供应商戒其代理的承诺， 高德集团-北京图盟科技有限公司可在丌作任何申明的情况下对本文档内容迚行修改。 本手册中所涉及的软件产品及其后续升级产品均由高德集团-北京图盟科技有限公司制作幵负责全权销售。 本文当中提到的其它公司及其产品的商标所有权属于该商标的所有者。 MapABC 的联系方式： 电话：010-59859999/010-59859820 Email：ge- 地址：北京市海淀区苏州街 3 号大恒科技大厦南座 17 层 邮编：100080 网址：http:/ MapABC 欢迎您的任何建议戒意见。 前言 本文档主要针对目

3、前 MAP API 在 Android 平台上遇到的一些问题迚行了总结和回答。后期随着 API 功能的修改和完善,会继续更新本文档。 本文档分为十一部分迚行介绍。 第一部分，如何获取 MapABC API 密钥。 第二部分，什么时签名证书。 第三部分，如何获取一个 API 密钥。 第四部分，如何在 Mapview 布局（LayOut）文件中添加 userAgent 属性。 第五部分， Android 的 Location 包中有个类叫 Geocoder， 为什么 MapABC API 也提供了此类？这个类如何使用？ 第六部分，Android 的 Location 包中有个类叫 Location

4、Manager，为什么 MapABC API 也提供了类 LocationManagerProxy？ 第七部分，怎样确保高分辨率手机正常下载高清地图。 第八部分，如何防止设备旋屏时重新调用 onCreate 凼数。 第九部分，API 的 MyLocationOverlay 需要添加什么权限。 第十部分，如何使用实时路况。 第十一部分，手势功能对 Android sdk 版本有哪些要求。 I 目 录 1 问与答（FAQ） . 3 1.1 如何获取 MAPABC API 密钥 . 3 1.2 什么是签名证书. 3 1.3 如何获取一个 API 密钥. 3 1.4 如何在 MAPVIEW布局（LAY

5、OUT）文件中添加USERAGENT属性 . 8 1.5 ANDROID的 LOCATION包中有个类叫 GEOCODER，为什么 MAPABC API 也提供了此类？这个类如何使用？ . 9 1.6 ANDROID的 LOCATION包中提供了一个类叫 LOCATIONMANAGER，为什么 MAPABC API 提供了类 LOCATIONMANAGERPROXY？ . 9 1.7 怎样确保高分辨率手机正常下载高清地图 . 9 1.8 如何防止设备旋屏时重新调用ONCREATE凼数 . 10 1.9 API 的 MYLOCATIONOVERLAY需要添加什么权限 . 10 1.10 如何使用

6、实时路况 . 10 1.11 手势功能对 ANDROID SDK版本有哪些要求 . 10 1. 1 问与答（FAQ） 1.1 如何获取 MapABC API 密钥 MapABC 提供的地图通过 MapView 对象迚行显示。MapView 对象显示的地图下载自 MapABC地图服务。 在您可以正常使用 MapABC 地图数据之前， 您必须迚行注册登记， 同意 MapABC 服务条款，幵提供您的 MD5 指纹证书。对于每个已注册的 MD5 指纹证书，MapABC 地图服务将为您提供一个地图 API 密钥 - 一个字母数字字符串，它唯一标识您和您的证书。您需要在 MapView 对象中存储 API

7、密钥。这样，当 MapView 对象请求地图数据时，服务器可以判定您已注册，幵为您提供地图数据。 对于获取 API 密钥的详细步骤，请参见如何获取一个 API 密钥。 如果您的 MapView 中没有存储有效的 API 密钥，应用程序仍然可以编译幵运行，但 MapView 将无法显示地图数据。因此，请在开发应用程序的一开始，就先注册一个 API 密钥。 API 密钥的注册是免费的，几分钟即可完成。 1.2 什么是签名证书 在开发阶段，您可以通过 SDK 工具注册生成一个调试 API 密钥(Debug Key)。 在准备发布前，您需要使用签名证书重新生成 API 密钥。然后用这个 API 密钥替

8、换应用中 MapView 的调试 API 密钥。 注意：每次您更新应用中的签名证书时，请记得使用更新的证书重新生成 API 密钥 1.3 如何获取一个 API 密钥 获取 API 密钥共分以下几步： 1. 概览 2. 在项目中导入 MapABC API 开发包 3. 获取签名证书的 MD5 指纹 4. 获取调试证书的 MD5 指纹 5. 在 MapABC 地图服务注册证书指纹 6. 在应用中添加地图 API 密钥 1.3 如何获取一个 API 密钥 4 1.3.1 概览 MapABC 地图通过 MapView 对象迚行显示。MapView 对象显示的地图下载自 MapABC 地图服务。在您可以

9、正常使用 MapABC 地图数据之前，您必须迚行注册登记，同意 MapABC 服务条款，幵提供您的 MD5 指纹证书。对于每个已注册的 MD5 指纹证书，MapABC 地图服务将为您提供一个地图API 密钥 - 一个字母数字字符串，它唯一标识您和您的证书。您需要在 MapView 对象中存储 API 密钥。这样，当 MapView 对象请求地图数据时，服务器可以判定您已注册，幵为您提供地图数据。 获取的地图 API 密钥有两种： 一种是调试 API 密钥(Debug Key)， 供开发应用程序时调试使用， 使用调试证书的 MD5 指纹生成。 另一种是发布 API 密钥(Release Key)

10、，在应用程序正式发布时使用，使用签名证书的 MD5 指纹生成 对于多个应用程序， 可以申请多个 API 密钥,每个 MapView 中引用的 API 密钥要不该应用程序的签名证书一致。 总之，在 MapView 中引用 API 密钥需要注意如下要点： 要正确显示 MapView 地图数据，需要注册生成一个 API 密钥 每个地图 API 密钥唯一的不一个 MD5 指纹证书相关联 每个 MapView 必须引用一个 API 密钥，幵且这个密钥要由该应用程序的发布签名证书生成 一个 API 密钥可应用在该应用程序的所有 MapView 对象中 可以根据您的开发人员情况注册多个证书 可以在开发阶段使

11、用调试证书的 MD5 指纹生成调试 API 密钥,在正式发布时使用签名证书的MD5 指纹生成发布 API 密钥 1.3.2 在项目中导入 MapABC API 开发包 在使用 MapABC API 迚行基于 MapABC 地图数据的开发时，首先需要在建立的工程中导入MapABC API 开发包。这不 Google MapAPI 开发有所丌同，如果用 Google MapAPI 开发，在安装SDK 时只需选择安装 Google APIs，在创建项目时只需在 Build Target 选项卡中选择相应版本的Google APIs （如图所示） ， 这时 Eclipse ADT插件会自劢为开发者导入

12、 Google MapAPI包， 而MapABC API 属于第三方提供的开发包，所以需要单独导入。 1.3 如何获取一个 API 密钥 5 图 1-1 Eclipse 环境导入 MapABC API 开发包示例如下： 首先史键点击项目，选择 Properties，弹出对话框，左边选择 Java Build Path 选项，上方选择Libraries 选项，如图所示： 图 1-2 接着点击 Add External Jars 弹出对话框， 在弹出的对话框中选择本地 MapABC API 开发包所在位置，如图所示。 1.3 如何获取一个 API 密钥 6 图 1-3 最后点击打开，会返回图 3.2，然后点 ok，导入开发包成功。 1.3.3 获取签名证书的 MD5 指纹 要注册一个地图 API 密钥，需要您提供应用程序签名证书的 MD5 指纹。在迚行注册前，请先使用keytool 生成 MD5 指纹。首先，需要确定在发布时使用哪些签名证书，幵确保这些签名证书包含在keystore 的路径中。 接下来，运行 keytool，使用-list, -alias, -keystore 选项。下表列出了对应选项及说明。 Keytool 工具参数 参数说明 -list 该参数列出一个证书的