AutoNavi Map API功能规格说明书最后更新时间：2010年6月9日© 2010高德软件有限公司保留版权.目录简介 (3)API概述 (3)com.autonavi.mapapi包的描述信息 (3)AutoNavi Map API特点： (3)兼容android map 接口及功能 (4)Interface (5)Interface ItemizedOverlay.OnFocusChangeListener (5)Interface Overlay.Snappable (5)Interface Projection (6)Classes (8)Class GeoPoint (8)Class ItemizedOverlay<Item extends OverlayItem> (9)Class MapActivity (15)Class MapController (18)Class MapView (21)Class youtParams (29)Class MyLocationOverlay (33)Class Overlay (39)Class OverlayItem (42)Class TrackballGestureDetector (45)Enum (47)Enum MapView.ReticleDrawMode (47)简介简介API概述AutoNavi Map API是高德软件公司提供的调用地图的接口方法。
文档中定义了14个对象类及接口。
用户的应用程序可以通过AutoNavi Map API提供的接口方法操作地图数据，实现位置相关或地图相关应用。
例如，通过调用AutoNavi Map API，将地图数据整合到自己的应用中，可以将商户的地理位置信息在地图上进行标注，以很直观的形式展现给使用者。
com.autonavi.mapapi包的描述信息本地图包可支持第三方应用显示和控制高德的地图接口功能。
要创建一个地图，需要在一个页面布局中扩展MapActivity及实现MapView类。
您必须设置"android:apiKey"才能在您的应用中使用MapView获取地图数据。
在模拟器环境中，您可以通过申请调试API秘钥，进行程序开发。
但在发布时，您必须申请签名证书的API秘钥，并替换MapView中的调试API秘钥。
AutoNavi Map API特点：1.简单：用户场景-- 新手也能做出功能强大的地图应用：小李是大学在校生，一直酷爱编写程序。
在使用android平台手机后一直想自己试做一个应用程序。
在的网站上下载了api程序包和样例代码后，很容易的就开发出了简单实用的地图应用，这让小李一直兴奋不已。
2．移植性强：用户场景--原有基于Android Map API的应用程序移植方便:如某知名跨国公司开发的一款基于Android Map的应用服务软件，在国外非常受欢迎，用户普及率很高。
想将此应用移植到中国市场进行推广，但Android Map在中国市场的不被支持。
该公司用AutoNavi Map API提供的数据包直接替换Android Map API，没有进行很复杂的代码修改，所有的接口调用甚至函数名都不需要变动，直接就可以使应用正常工作，方便移植性广受好评。
3．强大的标记点：用户场景--在地图上任意指定位置进行标记：某知名的点评网站通过调用AutoNavi Map API地图数据开发了一款提供位置服务的应用软件。
并将商户的地理信息在地图上进行标注，绘制相应的位置信息描述后，网站信息的展现更加直观了，实用功能性更强。
用户可以便捷的查询到商户所在的地理位置。
使网站的用户访问量明显提升了。
4．准确高效的定位功能：用户场景--随时随地查询定位：某知名的搜索房屋信息的网站开发了一款基于AutoNavi Map API的提供了定位功能的手机应用软件。
小李是房地产的销售，他经常要带客户去转楼盘。
在这款有定位功能应用的帮助下，他可以清晰辨别自己所处的方位，以及周边楼盘环境情况。
他总能高效的完成工作，得到客户的肯定。
兼容android map 接口及功能用户在阅读下面的文档时，可以通过各个相似功能对象的对比加深对API类方法、属性、用途的理解，从而更好地应用API类服务于自己的领域。
PART IInterfaceCHAPTER 1Interface ItemizedOverlay.OnFocusChangeListener Overview这个接口用于对item焦点变化感兴趣的监听器。
MethodonFocusChangedvoid onFocusChanged(ItemizedOverlay overlay, OverlayItem newFocus)在绘制方法中调用，所以这里除了发送消息之类的动作，不要做任何其它的动作。
Parameters:overlay - 执行这个调用的OverlaynewFocus - 新焦点选中的item, 如果没有则为nullCHAPTER 2Interface Overlay.SnappableOverviewpublic static interface Overlay.SnappableOverlay的接口定义，这个overlay包含的项目可被对齐（例如，当用户触发一个缩放时，这函数可被调用允许用户把缩放框和一个兴趣点对齐）。
MethodonSnapToItemboolean onSnapToItem(int x, int y, android.graphics.Point snapPoint, MapView mapView)检查给定的（x,y）是否和引起当前行为（如缩放）的item足够靠近。
参数:x - 屏幕的x坐标y - 屏幕的y坐标snapPoint - 存放对于给定（x,y）最近的兴趣点（屏幕坐标）。
如果没有对齐则不可触摸。
mapView - 申请对齐的MapView。
使用MapView.getProjection()在屏幕像素和经纬度之间做转换。
返回值:是否去对齐兴趣点。
CHAPTER 3Interface ProjectionOverviewpublic interface ProjectionProjection接口用于屏幕像素点坐标系统和地球表面经纬度点坐标系统之间的变换。
方法MapView.getProjection().返回一个Projection。
MethodtoPixelsandroid.graphics.Point toPixels(GeoPoint in, android.graphics.Point out)把给定的GeoPoint变换到相对于MapView左上角的屏幕像素坐标。
MapView提供了这种投影变换。
参数：in –待变换的一对经纬度out –一个用于输出预先存在的对象；如果为空，将返回一个新分配的像素点。
fromPixelsGeoPoint fromPixels(int x, int y)该方法用给定的像素坐标创建一个新的GeoPoint。
给定的像素点是以MapView的左上角为原点的坐标系统，MapView提供了这个像素转换器(PixelConverter)。
metersToEquatorPixelsfloat metersToEquatorPixels(float meters)该方法把以米为计量单位的距离（沿赤道）在当前缩放水平下转换到一个以像素（水平）为计量单位的距离。
在默认的Mercator投影变换下，对于给定的距离，当远离赤道时，变换后确切的像素数量会增加。
参数:meter –以米为单位的距离返回值:相对给定距离的像素数量。
在当前的缩放水平，如果沿赤道测量，返回值可能是个近似值。
PART IIClassesCHAPTER 1Class GeoPointOverviewpublic class GeoPoint extends ng.Object不可变类，表示一对经度和纬度值，以微度的整数形式存储.ConstructorGeoPointpublic GeoPoint(int latitudeE6, int longitudeE6)用给定的经度和纬度构造一个GeoPoint，单位微度(度* 1E6).参数:latitudeE6 - 该点的纬度. 为保持Mercator投影精确度，其取值范围是[-80,80]。
longitudeE6 - 该点的经度. 可被规范化到(-180, 180]。
GeoPoint (坐标位置偏转)public GeoPoint(double lat, double lon, MapActivity cnt)说明：用给定的屏幕的坐标值和当前创建MapView的MapActivity进行坐标位置偏转，构造一个GeoPoint.参数:lat - 该点的屏幕横坐标x.lon - 该点的屏幕纵坐标y.cnt- 当前创建MapView的MapActivity.MethodgetLatitudeE6public int getLatitudeE6()返回GeoPoint对象的纬度，单位微度(度* 1E6).返回值:纬度.getLongitudeE6public int getLongitudeE6()返回GeoPoint对象的经度，单位微度(度* 1E6).返回值:经度.toStringpublic ng.String toString()覆盖:类ng.Object中的toString方法equalspublic boolean equals(ng.Object object)覆盖:类ng.Object中equals 方法hashCodepublic int hashCode()覆盖:类ng.Object中hashCode方法CHAPTER 2Class ItemizedOverlay<Item extends OverlayItem> Overviewpublic abstract class ItemizedOverlay<Item extends OverlayItem> extends Overlay implements Overlay.SnappableItemizedOverlay是Overlay的一个基类，它包含了一个OverlayItems列表。
它处理从南到北的排序，用于绘制、创建平移边界、为每个点绘制标记点，和维护一个焦点选中的item，同时也负责把一个屏幕点击匹配到item上去，分发焦点改变事件给备选的监听器。
ConstructorItemizedOverlaypublic ItemizedOverlay(android.graphics.drawable.Drawable defaultMarker)说明：创建一个新的ItemizedOverlay。