Mapbox Android学习笔记（7）事件处理

Events

Maps SDK提供了监听map事件的各种方法。SDK提供的大多数侦听器如下所示。但是，您偶尔会在其他概述文档中发现特定于其对应API的其他侦听器。

Map click & long click events

可以通过MapboxMap对象设置Click (tap)事件，并在每次事件发生时调用回调。在这两种情况下，回调函数都提供了用户单击地图位置的 LatLng。要向地图添加onClick侦听器，请在应用程序的代码中插入以下代码片段：

mapboxMap.addOnMapClickListener(new MapboxMap.OnMapClickListener() {
  @Override
  public 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() {
  @Override
  public void onCameraMove() {
    Toast.makeText(MainActivity.this, "onCameraMove", Toast.LENGTH_LONG).show();
  }
});

// 停止移动
mapboxMap.addOnCameraMoveCancelListener(new MapboxMap.OnCameraMoveCanceledListener() {
  @Override
  public void onCameraMoveCanceled() {
    Toast.makeText(MainActivity.this, "onCameraMoveCanceled", Toast.LENGTH_LONG).show();
  }
});

// 相机闲置
mapboxMap.addOnCameraIdleListener(new MapboxMap.OnCameraIdleListener() {
  @Override
  public void onCameraIdle() {
    Toast.makeText(MainActivity.this, "onCameraIdle", Toast.LENGTH_LONG).show();
  }
});

On fling & on move events

除了摄像头改变监听器外，MapboxMap对象还允许您在用户移动或抛出地图时监听。当用户在屏幕上拖动一根手指，导致相机位置发生变化时，就会发生移动事件。来自用户的类似操作将导致调用 onFling 回调，但是用户将以更大的动力执行该手势。当用户执行特定手势时，只会触发其中一个事件。

mapboxMap.addOnMoveListener(new MapboxMap.OnMoveListener() {
  @Override
  public void onMoveBegin(MoveGestureDetector detector) {
    // user started moving the map
  }
  @Override
  public void onMove(MoveGestureDetector detector) {
    // user is moving the map
  }
  @Override
  public void onMoveEnd(MoveGestureDetector detector) {
    // user stopped moving the map
  }
});


mapboxMap.addOnFlingListener(new MapboxMap.OnFlingListener() {
  @Override
  public 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() {
  @Override
  public 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() {
	@Override
	public void onInfoWindowClose(@NonNull Marker marker) {

	}
});

// 单击
mapboxMap.setOnInfoWindowClickListener(new MapboxMap.OnInfoWindowClickListener() {
  @Override
  public 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() {
	@Override
	public void onDidFinishRenderingMap(boolean fully) {
		// The map has finished rendering	    
	}
});

您还可以实现特定的变更事件接口并覆盖其方法。然后，当发生新的地图更改时调用接口回调。下面列出的监听器按事件在MapView生命周期中发生的顺序排列，详细参考。任何地图更改事件接口也可以从MapView对象中删除。

如果要使用运行时样式实时更改Mapbox地图样式，addOnDidFinishLoadingStyleListener()非常有用。下面是如何使用这个常数：

mapView.addOnDidFinishLoadingStyleListener(new MapView.OnDidFinishLoadingStyleListener() {
	@Override
	public void onDidFinishLoadingStyle() {
		// The map is now ready for other changes
	}
});