本文主要是介绍Mapbox Android学习笔记(7)事件处理,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
Events
Maps SDK提供了监听map事件的各种方法。SDK提供的大多数侦听器如下所示。但是,您偶尔会在其他概述文档中发现特定于其对应API的其他侦听器。
Map click & long click events
可以通过MapboxMap对象设置Click (tap)事件,并在每次事件发生时调用回调。在这两种情况下,回调函数都提供了用户单击地图位置的 LatLng。要向地图添加onClick侦听器,请在应用程序的代码中插入以下代码片段:
mapboxMap.addOnMapClickListener(new MapboxMap.OnMapClickListener() {@Overridepublic void onMapClick(@NonNull LatLng point) {// 获取用户点击的位置point,并显示String string = String.format(Locale.US, "User clicked at: %s", point.toString())Toast.makeText(MainActivity.this, string, Toast.LENGTH_LONG).show();}
});
Convert from screen pixel
当需要知道屏幕上用户手势发生的对应位置时,可以将LatLng点转换为屏幕像素。MapboxMap对象提供了地图的投影,允许您使用 MapboxMap.getprojection(). toscreenlocation(<LatLng>);
将LatLng坐标转换为屏幕像素。当您拥有以像素为单位的屏幕位置并需要将其转换为相应的 LatLng 对象时,则可以使用相反的方法。
转换LatLng和像素坐标之间的值的一个常见用例是,当您想要查询地图的层或源时,例如,确定用户是否单击了POI。可以在Query map features文档中关于如何做到这一点的信息。(参考学习笔记第9部分)
Camera change events
地图的照相机是俯视地图平面的视图。在几乎所有的情况下,您都将与相机交互来调整地图的初始缩放和目标位置。用户还可以通过在地图上执行手势来操作相机,比如捏缩放、用两根手指移动来倾斜、用一根手指移动来调整位置。
Map SDK提供了一些摄像头更改监听器,可以告诉您任何或特定的摄像头动作。SDK提供了不同的摄像机监听器来确定摄像机的移动是由用户手势、内置API动画还是开发人员控制的移动引起的。下面的代码片段显示了各种可用的摄像机监听:
// 开始移动
mapboxMap.addOnCameraMoveStartedListener(new MapboxMap.OnCameraMoveStartedListener() {private final String[] REASONS = {"REASON_API_GESTURE", "REASON_DEVELOPER_ANIMATION", "REASON_API_ANIMATION"};@Override public void onCameraMoveStarted(int reason) {String string = String.format(Locale.US, "OnCameraMoveStarted: %s", REASONS[reason - 1])Toast.makeText(MainActivity.this, string, Toast.LENGTH_LONG).show();}
});// 移动中
mapboxMap.addOnCameraMoveListener(new MapboxMap.OnCameraMoveListener() {@Overridepublic void onCameraMove() {Toast.makeText(MainActivity.this, "onCameraMove", Toast.LENGTH_LONG).show();}
});// 停止移动
mapboxMap.addOnCameraMoveCancelListener(new MapboxMap.OnCameraMoveCanceledListener() {@Overridepublic void onCameraMoveCanceled() {Toast.makeText(MainActivity.this, "onCameraMoveCanceled", Toast.LENGTH_LONG).show();}
});// 相机闲置
mapboxMap.addOnCameraIdleListener(new MapboxMap.OnCameraIdleListener() {@Overridepublic void onCameraIdle() {Toast.makeText(MainActivity.this, "onCameraIdle", Toast.LENGTH_LONG).show();}
});
On fling & on move events
除了摄像头改变监听器外,MapboxMap对象还允许您在用户移动或抛出地图时监听。当用户在屏幕上拖动一根手指,导致相机位置发生变化时,就会发生移动事件。来自用户的类似操作将导致调用 onFling 回调,但是用户将以更大的动力执行该手势。当用户执行特定手势时,只会触发其中一个事件。
mapboxMap.addOnMoveListener(new MapboxMap.OnMoveListener() {@Overridepublic void onMoveBegin(MoveGestureDetector detector) {// user started moving the map}@Overridepublic void onMove(MoveGestureDetector detector) {// user is moving the map}@Overridepublic void onMoveEnd(MoveGestureDetector detector) {// user stopped moving the map}
});mapboxMap.addOnFlingListener(new MapboxMap.OnFlingListener() {@Overridepublic void onFling() {Toast.makeText(MainActivity.this, "onFling", Toast.LENGTH_LONG).show();}
});
Marker and info window events
Maps SDK提供了一个方便的侦听器,用于在用户点击标记时捕获。默认情况下,所有标记都带有一个 onMarkerClick 事件监听器,用于显示和隐藏信息窗口。您可以覆盖这个默认事件监听器,并使用 setOnMarkerClickListener 方法设置您自己的事件监听器。
要显示带有单击标记标题的toast消息,请使用 setOnMarkerClickListener
侦听单击事件,最后调用 toast.maketext()
。要避免同时显示toast消息和信息窗口,请在末尾返回true:
mapboxMap.setOnMarkerClickListener(new MapboxMap.OnMarkerClickListener() {@Overridepublic boolean onMarkerClick(@NonNull Marker marker) {Toast.makeText(MainActivity.this, marker.getTitle(), Toast.LENGTH_LONG).show();return true;}
});
在类似的情况下,info窗口提供了几个侦听器,用于在信息窗口单击、长时间单击或用户关闭窗口时收到通知。
// 长时间单击
mapboxMap.setOnInfoWindowLongClickListener(OnInfoWindowLongClickListener);// 关闭窗口
mapboxMap.setOnInfoWindowCloseListener(new MapboxMap.OnInfoWindowCloseListener() {@Overridepublic void onInfoWindowClose(@NonNull Marker marker) {}
});// 单击
mapboxMap.setOnInfoWindowClickListener(new MapboxMap.OnInfoWindowClickListener() {@Overridepublic boolean onInfoWindowClick(@NonNull Marker marker) {return false;}
});
Map change events
MapView在构建和更改地图时经历一系列生命周期事件。Maps SDK提供了许多不同的change listener接口,用于告诉您何时发生了特定的map事件。
不是将侦听器添加到MapboxMap对象,而是将每个侦听器添加到MapView对象。例如OnDidFinishRenderingMapListener和addOnDidFinishLoadingMapListener。
mapView.addOnDidFinishRenderingMapListener(new MapView.OnDidFinishRenderingMapListener() {@Overridepublic void onDidFinishRenderingMap(boolean fully) {// The map has finished rendering }
});
您还可以实现特定的变更事件接口并覆盖其方法。然后,当发生新的地图更改时调用接口回调。下面列出的监听器按事件在MapView生命周期中发生的顺序排列,详细参考。任何地图更改事件接口也可以从MapView对象中删除。
如果要使用运行时样式实时更改Mapbox地图样式,addOnDidFinishLoadingStyleListener()
非常有用。下面是如何使用这个常数:
mapView.addOnDidFinishLoadingStyleListener(new MapView.OnDidFinishLoadingStyleListener() {@Overridepublic void onDidFinishLoadingStyle() {// The map is now ready for other changes}
});
这篇关于Mapbox Android学习笔记(7)事件处理的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!