Key验证事件监听
在工程Manifest中添加相应的开发密钥,SDK会自动去调用这个开发密钥,相应的鉴权状态将已广播的形式反馈给开发者。具体使用方法如下所示:
开发密钥位置:
android:name="baidumapsdk.demo.DemoApplication"
android:name="com.baidu.lbsapi.API_KEY"
android:value="开发密钥" />
广播监听方法:
第一步、定义广播监听者
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);
一般事件监听
自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);
地图事件监听
百度地图支持各种事件监听,提供了相应的事件监听方法,具体监听接口如下:
地图状态改变相关接口:
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(){
}
};
地图渲染完成的监听接口
自4.1.0起,增加地图渲染完成的监听接口
/**
* 地图渲染完成回调接口
*/
public interface OnMapRenderCallback {
/**
* 地图渲染完成回调函数
*/
public void onMapRenderFinished();
}
/**
* 设置地图渲染完成回调
* @param callback
*/
public void setOnMapRenderCallbadk(OnMapRenderCallback callback);
地图双击事件监听接口:
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){
}
};
触摸地图回调接口:
mBaiduMap.setOnMapTouchListener(new OnMapTouchListener() {
/**
* 当用户触摸地图时回调函数
* @param event 触摸事件
*/
public void onTouch(MotionEvent event) {
}
});
检索事件监听
获取检索结果,采用的是异步回调形式,具体使用方法请参考“检索功能”章节的相关介绍。
对线和标注引入事件分发机制
自4.1.0起,引入事件分发机制,对于线polyline和marker的点击事件,当用户不处理时,向下传递,等同于地图点击事件。
原有的polyline点击事件,当开发者不设置监听时,该点击也无法由地图捕获。
现修改为:如果开发者设置了polyline点击事件监听OnPolylineClickListener,则polyline点击事件由开发者实现,响应接口:
public boolean onPolylineClick(Polyline polyline);
若开发者未设置该监听,则polyline点击事件向下传递,等同于地图点击事件,可由OnMapClickListener捕获。Marker的点击事件同理。
MapView顺序设置
自4.1起,新增接口setZOrderMediaOverlay,设置MapView显示顺序,支持MapView显示在其他View上方,避免遮盖。
/**
* 设置多个MapView显示时, 当前SurfaceView在上面
* @param isMediaOverlay 当前View是否在SurfaceView最上面
*/
public final void setZOrderMediaOverlay(boolean isMediaOverlay);