1.Key验证事件监听
在工程Manifest中添加相应的开发密钥,SDK会自动去调用这个开发密钥,相应的鉴权状态将已广播的形式反馈给开发者。具体使用方法如下所示:
开发密钥位置:
<application
android:name="baidumapsdk.demo.DemoApplication"
<meta-data
android:name="com.baidu.lbsapi.API_KEY"
android:value="开发密钥" />
</application>
广播监听方法:
第一步、定义广播监听者
public class SDKReceiver extends BroadcastReceiver {
public void onReceive(Context context, Intent intent) {
String action = intent.getAction();
if(action.equals(SDKInitializer.SDK_BROADTCAST_ACTION_STRING_PERMISSION_CHECK_ERROR))
{
// key 验证失败,相应处理
}
}
}
第二步、注册广播监听者
IntentFilter iFilter = new IntentFilter();
iFilter.addAction(SDKInitializer.SDK_BROADTCAST_ACTION_STRING_PERMISSION_CHECK_ERROR);
iFilter.addAction(SDKInitializer.SDK_BROADCAST_ACTION_STRING_NETWORK_ERROR);
mReceiver = new SDKReceiver();
registerReceiver(mReceiver, iFilter);
第三步、不使用地图 SDK 时,取消广播监听
unregisterReceiver(mReceiver);
2.一般事件监听
自v3.0.0版本起,取消了BMapManager方法,即初始化工程不再需要开发者自己完成,而是由SDK内部自行实现。相应的事件监听,采用了广播机制,具体使用方法如下所示:
第一步、定义广播监听者;
public class SDKReceiver extends BroadcastReceiver {
public void onReceive(Context context, Intent intent) {
String action = intent.getAction();
if(action.equals(SDKInitializer.SDK_BROADCAST_ACTION_STRING_NETWORK_ERROR)) {
// 网络出错,相应处理
}
}
}
第二步、注册广播监听者;
IntentFilter iFilter = new IntentFilter();
iFilter.addAction(SDKInitializer.SDK_BROADTCAST_ACTION_STRING_PERMISSION_CHECK_ERROR);
iFilter.addAction(SDKInitializer.SDK_BROADCAST_ACTION_STRING_NETWORK_ERROR);
mReceiver = new SDKReceiver();
registerReceiver(mReceiver, iFilter);
第三步、不使用地图SDK时,取消广播监听;
unregisterReceiver(mReceiver);
3.地图事件监听
百度地图支持各种事件监听,、提供了相应的事件监听方法,具体监听接口如下:
地图状态改变相关接口:
OnMapStatusChangeListener listener = new OnMapStatusChangeListener() {
/**
* 手势操作地图,设置地图状态等操作导致地图状态开始改变。
* @param status 地图状态改变开始时的地图状态
*/
public void onMapStatusChangeStart(MapStatus status){
}
/**
* 地图状态变化中
* @param status 当前地图状态
*/
public void onMapStatusChange(MapStatus status){
}
/**
* 地图状态改变结束
* @param status 地图状态改变结束后的地图状态
*/
public void onMapStatusChangeFinish(MapStatus status){
}
};
地图单击事件监听接口:
OnMapClickListener listener = new OnMapClickListener() {
/**
* 地图单击事件回调函数
* @param point 点击的地理坐标
*/
public void onMapClick(LatLng point){
}
/**
* 地图内 Poi 单击事件回调函数
* @param poi 点击的 poi 信息
*/
public boolean onMapPoiClick(MapPoi poi){
}
};
地图加载完成回调接口:
OnMapLoadedCallback callback = new OnMapLoadedCallback() {
/**
* 地图加载完成回调函数
*/
public void onMapLoaded(){
}
};
地图双击事件监听接口:
OnMapDoubleClickListener listener = new OnMapDoubleClickListener() {
/**
* 地图双击事件监听回调函数
* @param point 双击的地理坐标
*/
public void onMapDoubleClick(LatLng point){
}
};
地图长按事件监听接口:
OnMapLongClickListener listener = new OnMapLongClickListener() {
/**
* 地图长按事件监听回调函数
* @param point 长按的地理坐标
*/
public void onMapLongClick(LatLng point){
}
};
地图 Marker 覆盖物点击事件监听接口:
OnMarkerClickListener listener = new OnMarkerClickListener() {
/**
* 地图 Marker 覆盖物点击事件监听函数
* @param marker 被点击的 marker
*/
public boolean onMarkerClick(Marker marker){
}
};
地图定位图标点击事件监听接口:
OnMyLocationClickListener listener = new OnMyLocationClickListener() {
/**
* 地图定位图标点击事件监听函数
*/
public boolean onMyLocationClick(){
}
};
地图截屏回调接口:
SnapshotReadyCallback callback = new SnapshotReadyCallback() {
/**
* 地图截屏回调接口
* @param snapshot 截屏返回的 bitmap 数据
*/
public void onSnapshotReady(Bitmap snapshot){
}
};
4.检索事件监听
获取检索结果,采用的是异步回调形式,具体使用方法请参考“检索功能”章节的相关介绍。