Android百度地图 - 在地图上标注已知GPS纬度经度值的一个或一组覆盖物
jopen
12年前
阐述一个概念，地图覆盖物：所有叠加或覆盖到地图的内容，我们统称为地图覆盖物。如标注、矢量图形元素(包括：折线和多边形和圆)、定位图标等。覆盖物拥有自己的地理坐标，当您拖动或缩放地图时，它们会相应的移动。
要实现的需求：假如我们知道北京天安门（建筑物）的GPS纬度经度值：39.915，116.404，想要把它在百度地图上标注出来。
实现上述需求的步骤：
一、准备工作：
1、创建android工程，并导入百度地图需要用到的jar包和so文件。
2、在AndroidManifest文件中添加使用百度地图SDK所需的权限及屏幕配置。
3、在布局文件layout中添加显示百度地图的MapView。
4、在继承了Activity类的子类中：
a. 创建并初始化地图引擎管理对象；
b. 通过组件ID获取代表地图显示View的MapView对象，并设置相应属性。
（比如：启用内置的缩放控件、设置允许的地图缩放级别等）
c. 重写Activity的生命周期回调方法onResume()、onPause()和onDestroy()，管理地图引擎管理类对象和显示对象生命周期。
二、在地图上标注出北京天安门：
1、想要在地图上标注一个建筑物，总得有一个标识吧？
获取在地图上标识建筑物的图标对象：
// 获取用于在地图上标注一个地理坐标点的图标 Drawable drawable = this.getResources().getDrawable(R.drawable.icon_marka);
2、在基础图上添加覆盖物（添加图层）
a. 编写覆盖物类，自己定义一个类，继承自ItemizedOverlay
注：从2.0.0开始，SDK不支持直接继承Overlay , 用户可通过继承ItemizedOverlay来添加覆盖物。
b. 在自定义的覆盖物类（继承自ItemizedOverlay
/**覆盖物列表集合*/ private ArrayListmOverlayList = new ArrayList ();
声明double类型的变量存储北京天安门的纬度、经度值：
// 声明double类型的变量存储北京天安门的纬度、经度值 private double mLat1 = 39.915; // point1纬度 private double mLon1 = 116.404; // point1经度
c. 在构造函数中，将GPS纬度经度值转换成以微度的整数形式存储的地理坐标点
/* 注：GeoPoint对象构造方法的参数列表：第一个是参数表示纬度，第二个是经度 （我们平时都是经纬度这么叫的，想着应该是经度在前的，呵呵。） 在网上查了下，GPS的值官方给的就是纬度经度，也就是说纬度是在前的，以前一直没太注意。*/ GeoPoint geoPoint1 = new GeoPoint((int) (mLat1 * 1E6), (int) (mLon1 * 1E6));
构造OverlayItem对象并添加到mOverlayList集合里
mOverlayList.add(new OverlayItem(geoPoint1, "point1", "point1"));
必须调用的方法：
/* * 官方的解释：在一个新ItemizedOverlay上执行所有操作的工具方法。 * 没搞明白啥意思，但是必须的调用这个方法，否则程序运行报错*/ populate();
d. 返回的是从指定List集合中，取出的一个OverlayItem对象。
/* * 返回的是从指定List集合中，取出的一个OverlayItem对象。 * mOverlayList集合里一旦有了数据，在调用其之前， * 一定的在MyOverlayItem的构造函数里调用这个方法populate(); */ @Override protected OverlayItem createItem(int index) { return mOverlayList.get(index); } e. 获取当前覆盖物列表的大小
@Override public int size() { return mOverlayList.size(); } 自定义的覆盖物类的完整代码：
/** * 包含了一个覆盖物列表的覆盖物类 * @author android_ls */ final class MyOverlayItem extends ItemizedOverlay{ /**覆盖物列表集合*/ private ArrayList mOverlayList = new ArrayList (); // 声明double类型的变量存储北京天安门的纬度、经度值 private double mLat1 = 39.915; // point1纬度 private double mLon1 = 116.404; // point1经度 // 传进来的Drawable对象用于在地图上标注一个地理坐标点 public MyOverlayItem(Drawable drawable) { super(drawable); // 将GPS纬度经度值转换成以微度的整数形式存储的地理坐标点 /* 注：GeoPoint对象构造方法的参数列表：第一个是参数表示纬度，第二个是经度 （我们平时都是经纬度这么叫的，想着应该是经度在前的，呵呵。） 在网上查了下，GPS的值官方给的就是纬度经度，也就是说纬度是在前的，以前一直没太注意。*/ GeoPoint geoPoint1 = new GeoPoint((int) (mLat1 * 1E6), (int) (mLon1 * 1E6)); // 构造OverlayItem对象并添加到mOverlayList集合里 mOverlayList.add(new OverlayItem(geoPoint1, "point1", "point1")); /* * 官方的解释：在一个新ItemizedOverlay上执行所有操作的工具方法。 * 没搞明白啥意思，但是必须的调用这个方法，否则程序运行报错*/ populate(); } /* * 返回的是从指定List集合中，取出的一个OverlayItem对象。 * mOverlayList集合里一旦有了数据，在调用其之前， * 一定的在MyOverlayItem的构造函数里调用这个方法populate(); */ @Override protected OverlayItem createItem(int index) { return mOverlayList.get(index); } @Override public int size() { return mOverlayList.size(); } }
创建覆盖物（MyOverlayItem）对象并添加到覆盖物列表中：
mMapView.getOverlays().add(new MyOverlayItem(drawable));
3、刷新地图
mMapView.refresh();
运行效果图如下：
完整代码：
package com.android.baidu.map; import java.util.ArrayList; import android.app.Activity; 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.ItemizedOverlay; import com.baidu.mapapi.map.MKEvent; import com.baidu.mapapi.map.MapController; import com.baidu.mapapi.map.MapView; import com.baidu.mapapi.map.OverlayItem; import com.baidu.platform.comapi.basestruct.GeoPoint; /** * 在地图上标注已知GPS纬度经度值的建筑物 * 场景：假如我们知道北京天安门（建筑物）的GPS纬度经度值：39.915，116.404，想要把它在地图上标注出来。 * @author android_ls * */ public class BaiduMapOverlayActivity extends Activity { /**地图引擎管理类*/ private BMapManager mBMapManager = null; /**显示地图的View*/ private MapView mMapView = null; /** * 经研究发现在申请KEY时：应用名称一定要写成my_app_应用名（也就是说"my_app_"是必须要有的）。 * 百度地图SDK提供的服务是免费的，接口无使用次数限制。您需先申请密钥（key)，才可使用该套SDK。 * */ public static final String BAIDU_MAP_KEY = "07418AEC69BAAB7104C6230A6120C580DFFAEEBB"; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); // 注意：请在调用setContentView前初始化BMapManager对象，否则会报错 mBMapManager = new BMapManager(this.getApplicationContext()); mBMapManager.init(BAIDU_MAP_KEY, new MKGeneralListener() { @Override public void onGetNetworkState(int iError) { if (iError == MKEvent.ERROR_NETWORK_CONNECT) { Toast.makeText(BaiduMapOverlayActivity.this.getApplicationContext(), "您的网络出错啦！", Toast.LENGTH_LONG).show(); } } @Override public void onGetPermissionState(int iError) { if (iError == MKEvent.ERROR_PERMISSION_DENIED) { // 授权Key错误： Toast.makeText(BaiduMapOverlayActivity.this.getApplicationContext(), "请在 DemoApplication.java文件输入正确的授权Key！", Toast.LENGTH_LONG).show(); } } }); setContentView(R.layout.main); mMapView = (MapView) this.findViewById(R.id.bmapsView); // 设置启用内置的缩放控件 mMapView.setBuiltInZoomControls(true); // 获取地图控制器，可以用它控制平移和缩放 MapController mMapController = mMapView.getController(); // 设置地图的缩放级别。 这个值的取值范围是[3,18]。 mMapController.setZoom(13); // 获取用于在地图上标注一个地理坐标点的图标 Drawable drawable = this.getResources().getDrawable(R.drawable.icon_marka); // 创建覆盖物（MyOverlayItem）对象并添加到覆盖物列表中 mMapView.getOverlays().add(new MyOverlayItem(drawable)); // 刷新地图 mMapView.refresh(); } /** * 包含了一个覆盖物列表的覆盖物类 * @author android_ls */ final class MyOverlayItem extends ItemizedOverlay { /**覆盖物列表集合*/ private ArrayList mOverlayList = new ArrayList(); // 声明double类型的变量存储北京天安门的纬度、经度值 private double mLat1 = 39.915; // point1纬度 private double mLon1 = 116.404; // point1经度 // 传进来的Drawable对象用于在地图上标注一个地理坐标点 public MyOverlayItem(Drawable drawable) { super(drawable); // 将GPS纬度经度值转换成以微度的整数形式存储的地理坐标点 /* 注：GeoPoint对象构造方法的参数列表：第一个是参数表示纬度， * 第二个是经度（我们平时都是经纬度这么叫的，想着应该是经度在前的，呵呵。） * 在网上查了下，GPS的值官方给的就是纬度经度，也就是说纬度是在前的，以前一直没太注意。*/ GeoPoint geoPoint1 = new GeoPoint( (int) (mLat1 * 1E6), (int) (mLon1 * 1E6)); // 构造OverlayItem对象并添加到mOverlayList集合里 mOverlayList.add(new OverlayItem(geoPoint1, "point1", "point1")); /* * 官方的解释：在一个新ItemizedOverlay上执行所有操作的工具方法。 * 没搞明白啥意思，但是必须的调用这个方法，否则程序运行报错*/ populate(); } /* * 返回的是从指定List集合中，取出的一个OverlayItem对象。 * mOverlayList集合里一旦有了数据，在调用其之前， * 一定的在MyOverlayItem的构造函数里调用这个方法populate(); */ @Override protected OverlayItem createItem(int index) { return mOverlayList.get(index); } @Override public int size() { return mOverlayList.size(); } } // 重写以下方法，管理API @Override protected void onResume() { mMapView.onResume(); if (mBMapManager != null) { mBMapManager.start(); } super.onResume(); } @Override protected void onPause() { mMapView.onPause(); if (mBMapManager != null) { mBMapManager.stop(); } super.onPause(); } @Override protected void onDestroy() { mMapView.destroy(); if (mBMapManager != null) { mBMapManager.destroy(); mBMapManager = null; } super.onDestroy(); } } 三、在地图上标注出北京天安门附近的几个点：
从2.0.0开始，SDK不支持直接继承Overlay 。 在地图上显示一个或一组覆盖物，都可以通过继承ItemizedOverlay来添加覆盖物。
在上面讲解的基础上，修改覆盖物类的部分代码就可以了。直接上代码：
class MyOverlayItem extends ItemizedOverlay{ /**覆盖物列表集合*/ private ArrayList mOverlayList = new ArrayList (); // 场景：假如我们有一组建筑物的GPS经纬度值，想要把这些建筑物在地图上标注出来。 private double mLat1 = 39.90923; // point1纬度 private double mLon1 = 116.397428; // point1经度 private double mLat2 = 39.9022;// point2纬度 private double mLon2 = 116.3922; // point2经度 private double mLat3 = 39.917723; // point3纬度 private double mLon3 = 116.3722; // point3纬度 private double mLat4 = 39.915; // point4纬度 private double mLon4 = 116.404; // point4经度 // 传进来的Drawable对象用于在地图上标注一个地理坐标点 public MyOverlayItem(Drawable drawable) { super(drawable); // 将GPS纬度经度值转换成以微度的整数形式存储的地理坐标点 /* 注：GeoPoint对象构造方法的参数列表：第一个是参数表示纬度，第二个是经度 （我们平时都是经纬度这么叫的，想着应该是经度在前的，呵呵。） 在网上查了下，GPS的值官方给的就是纬度经度，也就是说纬度是在前的，以前一直没太注意。*/ GeoPoint geoPoint1 = new GeoPoint((int) (mLat1 * 1E6), (int) (mLon1 * 1E6)); GeoPoint geoPoint2 = new GeoPoint((int) (mLat2 * 1E6), (int) (mLon2 * 1E6)); GeoPoint geoPoint3 = new GeoPoint((int) (mLat3 * 1E6), (int) (mLon3 * 1E6)); GeoPoint geoPoint4 = new GeoPoint((int) (mLat4 * 1E6), (int) (mLon4 * 1E6)); // 构造OverlayItem对象并添加到mOverlayList集合里 mOverlayList.add(new OverlayItem(geoPoint1, "point1", "point1")); mOverlayList.add(new OverlayItem(geoPoint2, "point2", "point2")); mOverlayList.add(new OverlayItem(geoPoint3, "point3", "point3")); mOverlayList.add(new OverlayItem(geoPoint4, "point4", "point4")); // 必须的调用这个方法，否则程序运行报错 populate(); } /* * 返回的是从指定List集合中，取出的一个OverlayItem对象。 * mOverlayList集合里一旦有了数据，在调用其之前， * 一定的在MyOverlayItem的构造函数里调用这个方法populate(); */ @Override protected OverlayItem createItem(int index) { return mOverlayList.get(index); } @Override public int size() { return mOverlayList.size(); } }
对代码进行优化：
GPSPonit 实体类：
package com.android.baidu.map.entity; /** * 类名: Ponit.java * 功能描述:存放GPS纬度、经度值 * @author android_ls * 创建日期: 2013-2-10 下午07:43:47 * @version V1.0 */ public class GPSPonit { private double mLat; // 纬度 private double mLon; // 经度 public double getmLat() { return mLat; } public void setmLat(double mLat) { this.mLat = mLat; } public double getmLon() { return mLon; } public void setmLon(double mLon) { this.mLon = mLon; } public GPSPonit(double mLat, double mLon) { this.mLat = mLat; this.mLon = mLon; } public GPSPonit() { } @Override public String toString() { return "Ponit [mLat=" + mLat + ", mLon=" + mLon + "]"; } } 优化后的Activity类：
package com.android.baidu.map; import java.util.ArrayList; import android.app.Activity; import android.graphics.drawable.Drawable; import android.os.Bundle; import android.widget.Toast; import com.android.baidu.map.entity.GPSPonit; import com.baidu.mapapi.BMapManager; import com.baidu.mapapi.MKGeneralListener; import com.baidu.mapapi.map.ItemizedOverlay; import com.baidu.mapapi.map.MKEvent; import com.baidu.mapapi.map.MapController; import com.baidu.mapapi.map.MapView; import com.baidu.mapapi.map.OverlayItem; import com.baidu.platform.comapi.basestruct.GeoPoint; /** * 在地图上标注已知GPS纬度经度值的一组建筑物 * @author android_ls * */ public class BaiduMapOverlayItemsActivity extends Activity { /**地图引擎管理类*/ private BMapManager mBMapManager = null; /**显示地图的View*/ private MapView mMapView = null; /** * 经研究发现在申请KEY时：应用名称一定要写成my_app_应用名（也就是说"my_app_"是必须要有的）。 * 百度地图SDK提供的服务是免费的，接口无使用次数限制。您需先申请密钥（key)，才可使用该套SDK。 * */ public static final String BAIDU_MAP_KEY = "07418AEC69BAAB7104C6230A6120C580DFFAEEBB"; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); // 注意：请在调用setContentView前初始化BMapManager对象，否则会报错 mBMapManager = new BMapManager(this.getApplicationContext()); mBMapManager.init(BAIDU_MAP_KEY, new MKGeneralListener() { @Override public void onGetNetworkState(int iError) { if (iError == MKEvent.ERROR_NETWORK_CONNECT) { Toast.makeText(BaiduMapOverlayItemsActivity.this.getApplicationContext(), "您的网络出错啦！", Toast.LENGTH_LONG).show(); } } @Override public void onGetPermissionState(int iError) { if (iError == MKEvent.ERROR_PERMISSION_DENIED) { // 授权Key错误： Toast.makeText(BaiduMapOverlayItemsActivity.this.getApplicationContext(), "请在 DemoApplication.java文件输入正确的授权Key！", Toast.LENGTH_LONG).show(); } } }); setContentView(R.layout.main); mMapView = (MapView) this.findViewById(R.id.bmapsView); // 设置启用内置的缩放控件 mMapView.setBuiltInZoomControls(true); // 获取地图控制器，可以用它控制平移和缩放 MapController mMapController = mMapView.getController(); // 设置地图的缩放级别。 这个值的取值范围是[3,18]。 mMapController.setZoom(13); //TODO 构建一组数据 GPSPonit gp1 = new GPSPonit(39.90923, 116.397428); GPSPonit gp2 = new GPSPonit(39.9022, 116.3922); GPSPonit gp3 = new GPSPonit(39.917723, 116.3722); GPSPonit gp4 = new GPSPonit(39.915, 116.404); /**存放GPS纬度、经度值的数组*/ GPSPonit[] mGPSPonit = new GPSPonit[4]; mGPSPonit[0] = gp1; mGPSPonit[1] = gp2; mGPSPonit[2] = gp3; mGPSPonit[3] = gp4; Drawable drawable = this.getResources().getDrawable(R.drawable.icon_marka); // 创建覆盖物（MyOverlayItem）对象并添加到覆盖物列表中 mMapView.getOverlays().add(new MyOverlayItem(drawable, mGPSPonit)); // 刷新地图 mMapView.refresh(); } final class MyOverlayItem extends ItemizedOverlay { /**覆盖物列表集合*/ private ArrayList mOverlayList = new ArrayList(); // 场景：假如我们有一组建筑物的GPS经纬度值，想要把这些建筑物在地图上标注出来。 // 传进来的Drawable对象用于在地图上标注一个地理坐标点 public MyOverlayItem(Drawable drawable, GPSPonit[] gPSPonit) { super(drawable); for(int i = 0; i < gPSPonit.length; i++){ GPSPonit gpp = gPSPonit[i]; GeoPoint geoPoint = new GeoPoint( (int) (gpp.getmLat() * 1E6), (int) (gpp.getmLon() * 1E6)); mOverlayList.add(new OverlayItem(geoPoint, "point"+i, "point1"+i)); } // 必须的调用这个方法，否则程序运行报错 populate(); } /* * 返回的是从指定List集合中，取出的一个OverlayItem对象。 * mOverlayList集合里一旦有了数据，在调用其之前， * 一定的在MyOverlayItem的构造函数里调用这个方法populate(); */ @Override protected OverlayItem createItem(int index) { return mOverlayList.get(index); } @Override public int size() { return mOverlayList.size(); } } // 重写以下方法，管理API @Override protected void onResume() { mMapView.onResume(); if (mBMapManager != null) { mBMapManager.start(); } super.onResume(); } @Override protected void onPause() { mMapView.onPause(); if (mBMapManager != null) { mBMapManager.stop(); } super.onPause(); } @Override protected void onDestroy() { mMapView.destroy(); if (mBMapManager != null) { mBMapManager.destroy(); mBMapManager = null; } super.onDestroy(); } } 运行效果图如下：
