版权声明：本文为博主原创文章，未经博主允许不得转载。
http://lbsyun.baidu.com/index.php?title=androidsdk（百度地图官网地址），大家可以在官网上下载demon程序，申请自己的key后进行测试
我们要清楚自己使用自己要用的离线地图功能，分为两种：一种是直接使用无具体位置信息的地图，这种情况不需要申请key；第二种情况是下载离线地图包，正常显示一个城市的地图信息。
对于第一种情况，我们只需要利用百度地图提供的sdk，根据gps或者其他方式获取的经纬度信息将物体显示在地图上，这个时候百度地图起到的作用仅仅是为我们提供了一种经纬度信息与其在地图上显示的关系的转换，比如我们玩的有些游戏需要显示相对位置和绝对位置。
<com.baidu.mapapi.map.MapView
android:id="@+id/mapView"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:clickable="true" />
SDKInitializer.initialize(Context context);//使用百度地图必须加
MapView mMapView = (MapView) findViewById(R.id.mapView);
BaiduMap mBaiduMap = mMapView.getMap();
mMapView.getChildAt(1).setVisibility(View.GONE);//隐藏logo
mMapView.getChildAt(2).setVisibility(View.GONE);//隐藏放大缩小按钮
mMapView.getChildAt(3).setVisibility(View.GONE);//隐藏比例尺图标
//设置比例尺大小
MapStatusUpdate msu = MapStatusUpdateFactory.zoomTo(5.0f);
mBaiduMap.setMapStatus(msu);
//定位到中心位置
LatLng latLng；
MapStatusUpdate u = MapStatusUpdateFactory.newLatLng(latLng);
mBaiduMap.setMapStatus(u);
//添加覆盖物
OverlayOptions overlayOptions = new MarkerOptions().position(latLng)
.icon(BitmapDescriptorFactory.fromView(view))
.zIndex(5);
Marker marker = mBaiduMap.addOverlay(overlayOptions);
Marker提供显示、隐藏、位置......
//管理覆盖物
HashMap hashMap;
hashMap.put(value, marker);
//覆盖物点击事件
Bundle bundle = new Bundle();
bundle.putSerializable("key", value);
marker.setExtraInfo(bundle);
mBaiduMap.setOnMarkerClickListener(new OnMarkerClickListener()
{
@Override
public boolean onMarkerClick(final Marker marker)
{
//
marker.getExtraInfo().get("key");
return true;
}
});
//GPS转百度地图坐标
CoordinateConverter converter = new CoordinateConverter();
converter.from(CoordType.GPS); converter.coord(latlng);
LatLng desLatLng = converter.convert();
对于第二种情况，我们需要利用百度地图提供的sdk以及在百度地图官网上申请对应的应用程序的key才可以下载离线地图包。
使用离线地图，可满足在无网络环境下查看地图信息的需求，此外，在有离线地图的情况下，SDK会优先加载离线地图使用（也就是说我们下载了离线地图，在不需要在程序中加其他的代码，就可以优先加载离线地图），减少用户流量方面的开销，为用户提供更流畅的地图服务体验。
离线地图资源可通过SDK“在线下载离线包接口”下载获取。 自v3.6.0起，官网不再支持地图离线包下载，所以SDK去掉“手动导入离线包接口”，SDK在线下载离线包接口仍维持不变。
以下代码为百度地图官网提供的Android平台下载离线地图的方法：
package baidumapsdk.demo.map;
import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.view.View.OnClickListener;
import android.view.ViewGroup;
import android.widget.ArrayAdapter;
import android.widget.BaseAdapter;
import android.widget.Button;
import android.widget.EditText;
import android.widget.LinearLayout;
import android.widget.ListAdapter;
import android.widget.ListView;
import android.widget.TextView;
import android.widget.Toast;
import com.baidu.mapapi.map.offline.MKOLSearchRecord;
import com.baidu.mapapi.map.offline.MKOLUpdateElement;
import com.baidu.mapapi.map.offline.MKOfflineMap;
import com.baidu.mapapi.map.offline.MKOfflineMapListener;
import java.util.ArrayList;
import baidumapsdk.demo.R;
/* 此Demo用来演示离线地图的下载和显示 */
public class OfflineDemo extends Activity implements MKOfflineMapListener {
private MKOfflineMap mOffline = null;
private TextView cidView;
private TextView stateView;
private EditText cityNameView;
/**
* 已下载的离线地图信息列表
*/
private ArrayList<MKOLUpdateElement> localMapList = null;
private LocalMapAdapter lAdapter = null;
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_offline);
mOffline = new MKOfflineMap();
mOffline.init(this);
initView();
}
private void initView() {
cidView = (TextView) findViewById(R.id.cityid);
cityNameView = (EditText) findViewById(R.id.city);
stateView = (TextView) findViewById(R.id.state);
ListView hotCityList = (ListView) findViewById(R.id.hotcitylist);
ArrayList<String> hotCities = new ArrayList<String>();
// 获取热闹城市列表
ArrayList<MKOLSearchRecord> records1 = mOffline.getHotCityList();
if (records1 != null) {
for (MKOLSearchRecord r : records1) {
hotCities.add(r.cityName + "(" + r.cityID + ")" + " --"
+ this.formatDataSize(r.size));
}
}
ListAdapter hAdapter = (ListAdapter) new ArrayAdapter<String>(this,
android.R.layout.simple_list_item_1, hotCities);
hotCityList.setAdapter(hAdapter);
ListView allCityList = (ListView) findViewById(R.id.allcitylist);
// 获取所有支持离线地图的城市
ArrayList<String> allCities = new ArrayList<String>();
ArrayList<MKOLSearchRecord> records2 = mOffline.getOfflineCityList();
if (records1 != null) {
for (MKOLSearchRecord r : records2) {
allCities.add(r.cityName + "(" + r.cityID + ")" + " --"
+ this.formatDataSize(r.size));
}
}
ListAdapter aAdapter = (ListAdapter) new ArrayAdapter<String>(this,
android.R.layout.simple_list_item_1, allCities);
allCityList.setAdapter(aAdapter);
LinearLayout cl = (LinearLayout) findViewById(R.id.citylist_layout);
LinearLayout lm = (LinearLayout) findViewById(R.id.localmap_layout);
lm.setVisibility(View.GONE);
cl.setVisibility(View.VISIBLE);
// 获取已下过的离线地图信息
localMapList = mOffline.getAllUpdateInfo();
if (localMapList == null) {
localMapList = new ArrayList<MKOLUpdateElement>();
}
ListView localMapListView = (ListView) findViewById(R.id.localmaplist);
lAdapter = new LocalMapAdapter();
localMapListView.setAdapter(lAdapter);
}
/**
* 切换至城市列表
*
* @param view
*/
public void clickCityListButton(View view) {
LinearLayout cl = (LinearLayout) findViewById(R.id.citylist_layout);
LinearLayout lm = (LinearLayout) findViewById(R.id.localmap_layout);
lm.setVisibility(View.GONE);
cl.setVisibility(View.VISIBLE);
}
/**
* 切换至下载管理列表
*
* @param view
*/
public void clickLocalMapListButton(View view) {
LinearLayout cl = (LinearLayout) findViewById(R.id.citylist_layout);
LinearLayout lm = (LinearLayout) findViewById(R.id.localmap_layout);
lm.setVisibility(View.VISIBLE);
cl.setVisibility(View.GONE);
}
/**
* 搜索离线需市
*
* @param view
*/
public void search(View view) {
ArrayList<MKOLSearchRecord> records = mOffline.searchCity(cityNameView
.getText().toString());
if (records == null || records.size() != 1) {
return;
}
cidView.setText(String.valueOf(records.get(0).cityID));
}
/**
* 开始下载
*
* @param view
*/
public void start(View view) {
int cityid = Integer.parseInt(cidView.getText().toString());
mOffline.start(cityid);
clickLocalMapListButton(null);
Toast.makeText(this, "开始下载离线地图. cityid: " + cityid, Toast.LENGTH_SHORT)
.show();
updateView();
}
/**
* 暂停下载
*
* @param view
*/
public void stop(View view) {
int cityid = Integer.parseInt(cidView.getText().toString());
mOffline.pause(cityid);
Toast.makeText(this, "暂停下载离线地图. cityid: " + cityid, Toast.LENGTH_SHORT)
.show();
updateView();
}
/**
* 删除离线地图
*
* @param view
*/
public void remove(View view) {
int cityid = Integer.parseInt(cidView.getText().toString());
mOffline.remove(cityid);
Toast.makeText(this, "删除离线地图. cityid: " + cityid, Toast.LENGTH_SHORT)
.show();
updateView();
}
/**
* 更新状态显示
*/
public void updateView() {
localMapList = mOffline.getAllUpdateInfo();
if (localMapList == null) {
localMapList = new ArrayList<MKOLUpdateElement>();
}
lAdapter.notifyDataSetChanged();
}
@Override
protected void onPause() {
int cityid = Integer.parseInt(cidView.getText().toString());
MKOLUpdateElement temp = mOffline.getUpdateInfo(cityid);
if (temp != null && temp.status == MKOLUpdateElement.DOWNLOADING) {
mOffline.pause(cityid);
}
super.onPause();
}
@Override
protected void onResume() {
super.onResume();
}
public String formatDataSize(int size) {
String ret = "";
if (size < (1024 * 1024)) {
ret = String.format("%dK", size / 1024);
} else {
ret = String.format("%.1fM", size / (1024 * 1024.0));
}
return ret;
}
@Override
protected void onDestroy() {
/**
* 退出时，销毁离线地图模块
*/
mOffline.destroy();
super.onDestroy();
}
@Override
public void onGetOfflineMapState(int type, int state) {
switch (type) {
case MKOfflineMap.TYPE_DOWNLOAD_UPDATE: {
MKOLUpdateElement update = mOffline.getUpdateInfo(state);
// 处理下载进度更新提示
if (update != null) {
stateView.setText(String.format("%s : %d%%", update.cityName,
update.ratio));
updateView();
}
}
break;
case MKOfflineMap.TYPE_NEW_OFFLINE:
// 有新离线地图安装
Log.d("OfflineDemo", String.format("add offlinemap num:%d", state));
break;
case MKOfflineMap.TYPE_VER_UPDATE:
// 版本更新提示
// MKOLUpdateElement e = mOffline.getUpdateInfo(state);
break;
default:
break;
}
}
/**
* 离线地图管理列表适配器
*/
public class LocalMapAdapter extends BaseAdapter {
@Override
public int getCount() {
return localMapList.size();
}
@Override
public Object getItem(int index) {
return localMapList.get(index);
}
@Override
public long getItemId(int index) {
return index;
}
@Override
public View getView(int index, View view, ViewGroup arg2) {
MKOLUpdateElement e = (MKOLUpdateElement) getItem(index);
view = View.inflate(OfflineDemo.this,
R.layout.offline_localmap_list, null);
initViewItem(view, e);
return view;
}
void initViewItem(View view, final MKOLUpdateElement e) {
Button remove = (Button) view.findViewById(R.id.remove);
TextView title = (TextView) view.findViewById(R.id.title);
TextView update = (TextView) view.findViewById(R.id.update);
TextView ratio = (TextView) view.findViewById(R.id.ratio);
ratio.setText(e.ratio + "%");
title.setText(e.cityName);
if (e.update) {
update.setText("可更新");
} else {
update.setText("最新");
}
remove.setOnClickListener(new OnClickListener() {
@Override
public void onClick(View arg0) {
mOffline.remove(e.cityID);
updateView();
}
});
}
}
}
如何测试我们的代码在关掉网络后调用的是离线地图：
关掉网络，在加载地图定位中心点时指定一个地图上存在的经纬度信息，同时将比例尺尽量设置在可视范围内
LatLng ll = new LatLng(30.479176, 114.423742);
MapStatusUpdate u = MapStatusUpdateFactory.newLatLng(ll);
mBaiduMap.animateMapStatus(u);
