高德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 List getFromLocationName(String locationName, int maxResults) throws IOException 根据给定的地理名称和最大结果数，返回地理编码的结果的列表 参数：  locationName 要进行地理编码的地理名称  maxResults 返回的最大结果数。