Android学习笔记之百度地图基础知识

<1>GeoPoint

表示一个地理坐标点,存放经度和纬度,以微度的整数形式存储。
方法
GeoPoint(int latitudeE6, int longitudeE6)
用给定的经纬度构造一个GeoPoint

方法介绍:

public int getLatitudeE6()

           返回GeoPoint的纬度,单位微度

public int getLongitudeE6()

          返回GeoPoint的经度,单位微度

public void setLatitudeE6(int latitudeE6)

         设置GeoPoint的纬度,单位微度

public void setLongitudeE6(int longitudeE6)

        设置GeoPoint的经度,单位微度


<2>接口 Projection

该接口用来在屏幕像素x/y坐标系和地球经纬度坐标系之间进行转换,通过  MapView.getProjection() 来取得映射类。

GeoPoint fromPixels(int x, int y)

该方法用给定的像素坐标创建一个新的GeoPoint。 给定的像素点是以MapView的左上角为原点的坐标系统,MapView提供了这个像素转换器(PixelConverter)。
参数:
result - 搜索结果
iError - 错误号,0表示正确返回

Point toPixels(GeoPoint in, Point out)

把给定的GeoPoint变换到相对于MapView左上角的屏幕像素坐标。MapView提供了这种投影变换。
参数:
in - 待变换的一对经纬度
out - 一个用于输出预先存在的对象;如果为空,将返回一个新分配的像素点。

  

 <3>MapController

处理地图移动和缩放的工具类。
返回类型 方法
void animateTo(GeoPoint point)
对以给定的点GeoPoint,开始动画显示地图。
void animateTo(GeoPoint point, Message message)
对以给定的GeoPoint,开始动画显示地图。
boolean onKey(View v, int keyCode, KeyEvent event)
处理按键事件,把事件变换为适度的地图平移。
void scrollBy(int x, int y)
按照给定的像素数据量滚动。
void setCenter(GeoPoint point)
在给定的中心点GeoPoint上设置地图视图。
int setZoom(int zoomLevel)
设置地图的缩放级别。
void stopAnimation(boolean jumpToFinish)
终止所有未完成的动画,有条件的把地图中心修正到已完成的特殊动画的偏移量上去。
void stopPanning()
重新设置平移状态,使地图静止。
boolean zoomIn()
放大一个级别。
boolean zoomInFixing(int xPixel, int yPixel)
放大一个级别。
boolean zoomOut()
缩小一个级别。
boolean zoomOutFixing(int xPixel, int yPixel)
缩小一个级别。
void zoomToSpan(int latSpanE6, int lonSpanE6)
尝试调整地图的缩放,以便显示给定的经纬度范围。

<4>MapView

一个显示地图的视图,当被焦点选中时,它能捕获按键事件和触摸手势去平移和缩放地图。

返回类型 方法
boolean canCoverCenter()
检查当前是否有地图贴片覆盖地图中心点。
protected boolean checkLayoutParams (android.view.ViewGroup.LayoutParams p)
仅检查p是否是的一个MapView.LayoutParams实例。
void computeScroll()
捕获滚动事件,用它们去平移地图。
void displayZoomControls(boolean takeFocus)
显示缩放控件,可以选择是否请求焦点选中以便通过按键访问。
protected android.view.ViewGroup.LayoutParams generateDefaultLayoutParams()
返回一个Layout参数的集合,其中参数带有ViewGroup.LayoutParams.WRAP_CONTENT的宽度,ViewGroup.LayoutParams.WRAP_CONTENT高度和坐标(0,0)。
protected android.view.ViewGroup.LayoutParams generateLayoutParams(android.view.ViewGroup.LayoutParams p)
android.view.ViewGroup.LayoutParams generateLayoutParams(AttributeSet attrs)
MapController getController()
返回地图的MapController,这个对象可用于控制和驱动平移和缩放。
int getLatitudeSpan()
当前纬线的跨度(从地图的上边缘到下边缘),十进制度×1,000,000。
int getLongitudeSpan()
当前经度的跨度(从地图的左边缘到地图的右边缘),单位:十进制的度×1,000,000。
GeoPoint getMapCenter()
返回当前地图中心点位置,做为一个GeoPoint(经度、纬度)的对象。
int getMaxZoomLevel()
返回当前视图中心点的最大缩放级别。
java.util.List<Overlay> getOverlays()
获取Overlay列表。
Projection getProjection()
获取屏幕像素坐标和经纬度对之间的转换。
View getZoomControls()
已过时
int getZoomLevel()
返回当前地图的缩放级别。
boolean isSatellite()
boolean isStreetView()
boolean isTraffic()
是否显示交通流量。
protected void onDetachedFromWindow()
当被分离调用,清除缩放控件。
protected void onDraw(Canvas canvas)
void onFocusChanged(boolean hasFocus, int direction, Rect previouslyFocusedRect)
当这个视图的焦点状态变化时被视图系统调用。
boolean onKeyDown(int keyCode, KeyEvent event)
把按键传送到overlay。
boolean onKeyUp(int keyCode, KeyEvent event)
把按键传送到overlay。
protected void onLayout(boolean flag, int l, int t, int r, int b)
protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec)
void onRestoreInstanceState(Bundle state)
把MapView的状态恢复到一个Bundle。
void onSaveInstanceState(Bundle state)
把MapView的状态存储到一个Bundle中。
protected void onSizeChanged(int w, int h, int oldw, int oldh)
重新调整地图对象的尺寸。
boolean onTouchEvent(MotionEvent event)
首先把touch事件传送到overlay,如果它不处理它们,就把事件再传送到手势探测器,然后分发探测到的手势。
boolean onTrackballEvent(MotionEvent event)
把trackball事件首先传送到overlay,如果它们不处理消息,尝试取平移和点击。
void onWindowFocusChanged(boolean hasFocus)
当包含这个视图的窗口得到或是去焦点时被调用。
void preLoad()
void setDrawOverlayWhenZooming(boolean bDraw)
设置在缩放动画过程中是否绘制overlay,默认为不绘制。 如果绘制,在覆盖物很多的情况下效率会有损失。 自1.1版本之后支持。
void setBuiltInZoomControls(boolean on)
设置是否启用内置的缩放控件。
void setReticleDrawMode(com.baidu.mapapi.MapView.ReticleDrawMode mode)
暂不支持。
void setSatellite(boolean on)
设置是否打开卫星图。
void setStreetView(boolean on)
暂不支持。
void setTraffic(boolean on)
设置是否打开交通流量图层。
void regMapViewListener(BMapManager bmapMan, MKMapViewListener listener)
注册地图显示事件监听器。

<5>MyLocationOverlay

一个负责显示用户当前位置的Overlay。 

Overlay是一个覆盖,它绘制用户当前在地图上的位置(精准度),和/或一个嵌入的指南针。子类能覆盖方法dispatchTap()去处理对当前位置的点击。 

为了开启这个overlay的功能,需要去调用enableMyLocation()和/或enableCompass(), 或调用Activity中的Activity.onResume()方法。记住,当在后台是,要在Activity中的Activity.onPause()方法中调用相应的disableMyLocation()和/或disableCompass()关闭这个功能。
返回类型 方法
void disableCompass()
关闭指南针的更新。
void disableMyLocation()
停止位置更新。
protected boolean dispatchTap()
在“我的位置”坐标上处理点击事件。
boolean draw(Canvas canvas, MapView mapView, boolean shadow, long when)
绘制方法。
protected void drawCompass(android.graphics.Canvas canvas, float bearing)
绘制指南针。
protected void drawMyLocation(Canvas canvas, MapView mapView, android.location.Location lastFix, GeoPoint myLocation, long when)
绘制“我的位置”点。
boolean enableCompass()
开启指南针更新功能。
boolean enableMyLocation()
尝试开启MyLocation功能,并向MKLocationManager.GPS_PROVIDER和MKLocationManager.NETWORK_PROVIDER注册更新。
Location getLastFix()
返回一个位置,对应于最近设定的用户位置。
GeoPoint getMyLocation()
返回一个GeoPoint,对应于一个最近设定的用户位置。
float getOrientation()
返回最近设定的的指南针朝向。
boolean isCompassEnabled()
检查指南针小部件是否被显示。
boolean isMyLocationEnabled()
void onAccuracyChanged(Sensor sensor, int accuracy)
void onLocationChanged(Location location)
监听并获取位置更新。
void onProviderDisabled(java.lang.String provider)
void onProviderEnabled(java.lang.String provider)
void onSensorChanged(SensorEvent event)
当指南针的值变换时,由SensorManager调用。
boolean onSnapToItem(int x, int y, android.graphics.Point snapPoint, MapView mapView)
检查给定的(x,y)是否和引起当前行为(如缩放)的item足够靠近。
boolean onTap(GeoPoint p, MapView mapView)
检查点击的位置是否非常接近于当前的位置(如果已知)。
boolean runOnFirstFix(java.lang.Runnable runnable)
把一个runnable加入队列,一旦收到一个位置信息,这个runnable就被执行。

<6>Overlay

Overlay是一个基类,它表示可以显示在地图上方的覆盖overlay。 添加一个overlay时,从这个基类派生出一个子类,创建一个实例,然后把它加入到一个列表中。这个列表通过调用MapView.getOverlays()得到。为了允许用户触摸去对齐一个点,子类应当实现Overlay.Snappable接口。
返回类型 方法
boolean draw(Canvas canvas, MapView mapView, boolean shadow)
在地图上绘制overlay。
boolean draw(Canvas canvas, MapView mapView, boolean shadow, long when)
专门绘制动画overlay的调用。
protected static void drawAt(Canvas canvas, Drawable drawable, int x, int y, boolean bShadow)
在某个偏移位置画一个Drawable的便捷方法。
boolean onKeyDown(int keyCode, KeyEvent event, MapView mapView)
处理一个按键被按下的事件。
boolean onKeyUp(int keyCode, KeyEvent event, MapView mapView)
处理一个按键放开事件。
boolean onTap(GeoPoint p, MapView mapView)
处理一个“点击”事件。
boolean onTouchEvent(MotionEvent e, MapView mapView)
处理一个触摸事件。
boolean onTrackballEvent(MotionEvent e, MapView mapView)
处理一个轨迹球事件。




你可能感兴趣的:(Android学习笔记之百度地图基础知识)