android百度地图 overlayitem,Android应用中使用百度地图API并添加标注（一）

网上一些资料这种的内容已经过时了，这里是最新的内容，如果哪里不对，请吐槽。。。

1)下载百度地图移动版API(Android)开发包

要在Android应用中使用百度地图API，就需要在工程中引用百度地图API开发包，这个开发包包含两个文件：

2)申请API Key

//包名

格式：例如：B7:6C:CF:E2:47:50:9B:3E:34:F7:08:72:F3:AC:F1:BE:55:D3:77:FB;com.majianjie.baidumap

申请地址：http://lbsyun.baidu.com/apiconsole/key

3)创建一个Android工程  目录结构如下：

4)在布局文件中添加地图控件(res/layout/activity_main.xml)

android:layout_width="fill_parent"

android:layout_height="fill_parent"

android:orientation="vertical" >

android:id="@+id/bmapView"

android:layout_width="fill_parent"

android:layout_height="fill_parent"

android:clickable="true" />

5)创建Activity

package com.majianjie.baidumap;

import android.app.Activity;

import android.graphics.Bitmap;

import android.graphics.drawable.Drawable;

import android.os.Bundle;

import android.widget.Toast;

import com.baidu.mapapi.BMapManager;

import com.baidu.mapapi.MKGeneralListener;

import com.baidu.mapapi.map.MKEvent;

import com.baidu.mapapi.map.MKMapViewListener;

import com.baidu.mapapi.map.MapController;

import com.baidu.mapapi.map.MapPoi;

import com.baidu.mapapi.map.MapView;

import com.baidu.mapapi.map.OverlayItem;

import com.baidu.platform.comapi.basestruct.GeoPoint;

import com.example.baidumap.R;

public class MainActivity extends Activity {

private Toast mToast;

private BMapManager mBMapManager;

public MapView mMapView = null;//MapView 是地图主控件

private MapController mMapController = null;//用MapController完成地图控制

MKMapViewListener mMapListener = null; //MKMapViewListener 用于处理地图事件回调

// 显示交通地图

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

/**

* 使用地图sdk前需先初始化BMapManager，这个必须在setContentView()先初始化

*/

mBMapManager = new BMapManager(this);

//第一个参数是API key, 第二个参数是常用事件监听，用来处理通常的网络错误，授权验证错误等，你也可以不添加这个回调接口

mBMapManager.init("LDtH1sVwr7kygaF0aTqaVwWU", new MKGeneralListener() {

//授权错误的时候调用的回调函数

@Override

public void onGetPermissionState(int iError) {

if (iError == MKEvent.ERROR_PERMISSION_DENIED) {

showToast("API KEY错误, 请检查！");

}

}

//一些网络状态的错误处理回调函数

@Override

public void onGetNetworkState(int iError) {

if (iError == MKEvent.ERROR_NETWORK_CONNECT) {

Toast.makeText(getApplication(), "您的网络出错啦！", Toast.LENGTH_LONG).show();

}

}

});

setContentView(R.layout.activity_main);

mMapView = (MapView) findViewById(R.id.bmapView);

mMapController = mMapView.getController(); // * 获取地图控制器

mMapController.enableClick(true); //* 设置地图是否响应点击事件 .

mMapController.setZoom(12);// * 设置地图缩放级别

mMapView.setBuiltInZoomControls(true); // * 显示内置缩放控件

mMapView.setSatellite(true);//设置显示为卫星地图：

//mMapView.setBuiltInZoomControls(true);

/**

* 在想要添加Overlay的地方使用以下代码，

* 比如Activity的onCreate()中

*/

//准备要添加的Overlay

double mLat1 = 39.904508;

double mLon1 = 119.53971899999999;

// 用给定的经纬度构造GeoPoint，单位是微度 (度 * 1E6)

GeoPoint p1 = new GeoPoint((int) (mLat1 * 1E6), (int) (mLon1 * 1E6));

//准备overlay图像数据，根据实情情况修复

Drawable mark= getResources().getDrawable(R.drawable.set);

//用OverlayItem准备Overlay数据

OverlayItem item1 = new OverlayItem(p1,"item1","item1");

//使用setMarker()方法设置overlay图片,如果不设置则使用构建ItemizedOverlay时的默认设置

//创建IteminizedOverlay

CustomItemizedOverlay itemOverlay = new CustomItemizedOverlay(mark, mMapView);

//将IteminizedOverlay添加到MapView中

mMapView.getOverlays().clear();

mMapView.getOverlays().add(itemOverlay);

//现在所有准备工作已准备好，使用以下方法管理overlay.

//添加overlay, 当批量添加Overlay时使用addItem(List)效率更高

itemOverlay.addItem(item1);

mMapView.refresh();

mMapController.setCenter(p1);//设置p地方为中心点

mMapView.regMapViewListener(mBMapManager, new MKMapViewListener() {

// * 地图移动完成时会回调此接口 方法

@Override

public void onMapMoveFinish() {

showToast("地图移动完毕！");

}

//* 地图加载完毕回调此接口方法

@Override

public void onMapLoadFinish() {

showToast("地图载入完毕！");

}

//* 地图完成带动画的操作(如: animationTo())后，此回调被触发

@Override

public void onMapAnimationFinish() {

}

//当调用过 mMapView.getCurrentMap()后，此回调会被触发 可在此保存截图至存储设备

@Override

public void onGetCurrentMap(Bitmap arg0) {

}

//* 点击地图上被标记的点回调此方法

@Override

public void onClickMapPoi(MapPoi arg0) {

if (arg0 != null){

showToast(arg0.strText);

}

}

});

}

@Override

protected void onResume() {

//MapView的生命周期与Activity同步，当activity挂起时需调用MapView.onPause()

mMapView.onResume();

super.onResume();

}

@Override

protected void onPause() {

//MapView的生命周期与Activity同步，当activity挂起时需调用MapView.onPause()

mMapView.onPause();

super.onPause();

}

@Override

protected void onDestroy() {

//MapView的生命周期与Activity同步，当activity销毁时需调用MapView.destroy()

mMapView.destroy();

//退出应用调用BMapManager的destroy()方法

if(mBMapManager != null){

mBMapManager.destroy();

mBMapManager = null;

}

super.onDestroy();

}

//* 显示Toast消息

private void showToast(String msg){

if(mToast == null){

mToast = Toast.makeText(this, msg, Toast.LENGTH_SHORT);

}else{

mToast.setText(msg);

mToast.setDuration(Toast.LENGTH_SHORT);

}

mToast.show();

}

}

6)在AndroidManifest.xml中配置  添加权限

7)还有一个文件是自定义的，继承自：ItemizedOverlay(百度地图中的，不是Android自己的)

Overlay简介

Overlay通常被译为“图层”或“覆盖物”。那么对于地图而言，什么称之为覆盖物？“所有叠加或覆盖到地图之上的内容，都被称之为地图覆盖物，如标注、矢量图形元素(包括：折线和多边形和圆)、定位图标等。覆盖物拥有自己的地理坐标，当您拖动或缩放地图时，它们会相应的移动。”

为了让大家能够对Overlay有更进一步的认识，我们再通过下面的图形来直观的认识它。 图中标记的那些红色的图标A,B,...,J正是Overlay的其中一种形式。如果你了解PhotoShop中图层的概念，这里应该不难理解。我们可以这样来理解地图、图层与图层上标记物三者的关系：

下图中的那些红色标记并不属于地图的一部分，这些所有的标记是附着在图层上的，然后将图层蒙在地图之上。

百度地图API提供的几种Overlay

百度地图API提供了以下几种Overlay(覆盖物)：

1)Overlay：它是所有覆盖物的抽象基类，所有的覆盖物均继承此类的方法，实现用户自定义图层显示；

2)MyLocationOverlay：一个负责显示用户当前位置的Overlay；

3)ItemizedOverlay：它包含了一个OverlayItem列表，相当于一组分条的Overlay，通过继承此类，将一组兴趣点显示在地图上；

4)PoiOverlay：本地搜索图层，提供某一特定地区的位置搜索服务，比如在北京市搜索“公园”，通过此图层将公园显示在地图上；

5)RouteOverlay：步行、驾车导航线路图层，将步行、驾车出行方案的路线及关键点显示在地图上；

6)TransitOverlay：公交换乘线路图层，将某一特定地区的公交出行方案的路线及换乘位置显示在地图上。

下面的文件是：CustomItemizedOverlay.java

网上有些内容是比较早的，百度地图API已经放弃使用了，这里是最新的，详细：http://developer.baidu.com/map/sdkandev-6.htm#.E7.AE.80.E4.BB.8B3

package com.majianjie.baidumap;

import android.graphics.drawable.Drawable;

import com.baidu.mapapi.map.ItemizedOverlay;

import com.baidu.mapapi.map.MapView;

import com.baidu.mapapi.map.OverlayItem;

import com.baidu.platform.comapi.basestruct.GeoPoint;

public class CustomItemizedOverlay extends ItemizedOverlay {

//用MapView构造ItemizedOverlay

public CustomItemizedOverlay(Drawable mark,MapView mapView){

super(mark,mapView);

}

protected boolean onTap(int index) {

//在此处理item点击事件

System.out.println("item onTap: "+index);

return true;

}

public boolean onTap(GeoPoint pt, MapView mapView){

//在此处理MapView的点击事件，当返回 true时

super.onTap(pt,mapView);

return false;

}

}

运行图：

基本就这些，百度地图API中的内容很丰富，之后会陆续添加，请继续关注！谢谢！如果哪里不对，请吐槽。。。

原文：http://blog.csdn.net/mjj123mjj123/article/details/27852747