您当前的位置: Android SDK > 开发指南 > 事件监听
事件监听

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);

一般事件监听

自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);