高德MapABC API for Android地理编码.pdf

MapABC API for Android 地理编码 高德集团 北京图盟科技有限公司 2011 年 4 月 北京 AutoNaviCellID 定位 法律声明 版权所有 2011 高德集团 北京图盟科技有限公司 保留一切权利 本文档包含的所有内容除特别声明之外 均属于高德集团 北京图盟科技有限公司的财产 本手册中 的所有内容受 中华人民共和国著作权法 及相关法律法规和中国加入的所有知识产权方面的国际条约 的保护 未得到本公司的允许 任何单位和个人丌能以任何方式 电子的或机械的 包括影印 翻印或 转载本文档的任何部分 否则将视为侵权 高德集团 北京图盟科技有限公司保留依法追究其责任的权利 该文档的一切有关权利属于高德集团 北京图盟科技有限公司所有 本文档幵丌代表供应商或其代理的承诺 高德集团 北京图盟科技有限公司可在丌作任何申明的情况 下对本文档内容进行修改 本手册中所涉及的软件产品及其后续升级产品均由高德集团 北京图盟科技有限公司制作幵负责全 权销售 本文当中提到的其它公司及其产品的商标所有权属于该商标的所有者 MapABC 的联系方式 电话 010 59859999 010 59859820 Email ge support 地址 北京市海淀区苏州街 3 号大恒科技大厦南座 17 层 邮编 100080 网址 MapABC 欢迎您的任何建议或意见 前言 MapABC API for Android Geocoding 支持正反向地理编码 为了帮助用户更好的使用 Geocoding 地理编码 功能 特此提供此文档进行具体说明 本文档分为四部分进行介绍 第一部分 概述 第二部分 构造函数 第三部分 常量 第四部分 方法 I 目 录 1 概述 1 2 构造函数 3 3 常量 5 4 方法 7 1 1 概述 MapABC Geocoding 支持正反向 Geocoding 为了使应用程序移植简单 MapABC Geocoding 基 本 采 用 和android location Geocoder一 致 的 接 口 由 于 本API的 诧 义 和 android location Geocoder 一致 因此本文丌详述每个方法的诧义 而只讲解 MapABC API for Android Geocoding 不 android location Geocoder 丌一致的地方 所以请用户结合 android 平台文 档 其中最大的丌一致为 MapABC Geocoding 仅支持中国范围内的地理及逆地理编码 且只支持中文 的中国地图数据 丌支持英文的或汉诧拼音的中国地图数据 2 2 构造函数 public Geocoder MapActivitycnt 通过 MapActivity 实例 构造 Geocoder 注意 此 Activity 必须包含一个 MapView 因为需要得 到此 MapView 中的 API Key public Geocoder Context cnt String key 参数为一个 Context 和一个合法的 API Key 3 3 常量 String Street Road 字符串常量 使用见下 String Cross 字符串常量 使用见下 String POI 字符串常量 使用见下 4 4 方法 1 方法 public List getFromLocation double latitude double longitude int maxResults throws IOException 根据给定的经纬度和最大结果数 返回逆地理编码的结果列表 参数 Latitude 纬度 Longitude 经度 maxResults 要返回的最大结果数 注 latitude longitude 须在中国范围内 在此方法的本意是根据经纬度 返回该位置的地理描述 在结果的 address 列表中有 3 种类型的 地物 1 交叉路口 2 道路 3 POI 名称 通过 address 的方法 getPremises 可以区分具体地物类型 在 GeoCoder 类中定义了三个 String 常量 Street Road Cross POI 则判断类型的代码示例如 下 String addr Premises address getPremises if addr Premises equals GeoCoder Street Road 道路 else if addr Premises equals GeoCoder Cross 交叉路口 else POI 2 方法 public List getFromRawGpsLocation double latitude double longitude int maxResults throws IOException 根据给定的经纬度和最大结果数 返回逆地理编码的结果列表 MapABC Geocoding 新增方法 根据我国政府规定 GPS 数据需要偏转 才能匹配到电子地图上 如果应用程序从 GPS 上得到了经纬 度 则需通过此函数 进行逆地理编码的转换 参数 Latitude 纬度 Longitude 经度 maxResults 要返回的最大结果数 注 在此方法的本意是根据经纬度 返回该位置的地理描述 在结果的 address 列表中有 3 种类型的 地 4 方法 8 物 1 交叉路口 2 道路 3 POI 名称 通过 address 的方法 getPremises 可以区分具体地物类型 在 GeoCoder 类中定义了三个 String 常量 Street Road Cross POI 则判断类型的代码示例如 下 String addr Premises address getPremises if addr Premises equals GeoCoder Street Road 道路 else if addr Premises equals GeoCoder Cross 交叉路口 else POI 3 方法 public List getFromLocationName String locationName int maxResults double lowerLeftLatitude double lowerLeftLongitude double upperRightLatitude double upperRightLongitude throws IOException 根据给定的地理名称 范围和最大结果数 返回逆地理编码的结果列表 参数 locationName 要进行地理编码的地理名称 maxResults 返回的最大结果数 lowerLeftLatitude 左下角纬度 用来设定矩形范围 lowerLeftLongitude 左下角经度 用来设定矩形范围 upperRightLatitude 右上角纬度 用来设定矩形范围 upperRightLongitude 右上角经度 用来设定矩形范围 4 方法 public L