Document Android API for instant click handlers

[louwers]

Had a discussion with @sargunv on Slack.

It's pretty hard to register a click handler you want to register immediately (without disambiguating double clicks).

Should this be we add some new API for this?

Screen.Recording.2024-11-16.at.02.21.12.mov

Here I copy pasted the implementation of onSingleTap to onSingleTapConfirmed to and commented out the body of onSingleTap.

[sargunv]

Minimal Kotlin example of how to do this today without a new API

// map is a MapLibreMap
val gestureManager = map.gesturesManager
gestureManager.detectors.add(SingleTapUpDetector(context, gestureManager))

where SingleTapUpDetector is:

class SingleTapUpDetector(context: Context, gestureManager: AndroidGesturesManager) :
  BaseGesture<StandardOnGestureListener>(context, gestureManager) {
  private val detector = GestureDetector(context, Listener())

  override fun analyzeEvent(event: MotionEvent): Boolean {
    return detector.onTouchEvent(event)
  }

  private class Listener : SimpleStandardOnGestureListener() {
    override fun onSingleTapUp(event: MotionEvent): Boolean {
      println(event)
      return true
    }
  }
}

[louwers]

Thanks for sharing. I'll make sure this is added to the documentation.