Skip to content

Latest commit

 

History

History
106 lines (87 loc) · 3.26 KB

how-do-i.md

File metadata and controls

106 lines (87 loc) · 3.26 KB
Raw

Animate rotation

You can use your own animator, like so:

private fun animateMapViewToNorth() {
    /* Wrapper class, necessary for the the animator to work (which uses reflection to infer
     * method names..) */
     @Suppress("unused")
     val wrapper = object {
         fun setAngle(angle: Float) {
             mapView?.setAngle(angle)
         }

         fun getAngle(): Float {
             return referentialData.angle
         }
     }
     ObjectAnimator.ofFloat(wrapper, "angle", if (referentialData.angle > 180f) 360f else 0f).apply {
         interpolator = DecelerateInterpolator()
         duration = 800
         start()
     }
}

Here, we assume that animateMapViewToNorth is part of a class which implements the ReferentialListener interface and has a referentialData property (with initial values).

Disable fade-in effect for tiles

Starting from MapView v.2.0.6, you can set a TileOptionsProvider to the MapView.

interface TileOptionsProvider {
    /* Must not be a blocking call - should return immediately */
    @JvmDefault
    fun getColorFilter(row: Int, col: Int, zoomLvl: Int): ColorFilter? = null

    /**
     * Controls the speed of fade in effect when rendering tiles. Higher values make alpha
     * value go to 255 faster. Should be in between (0.0f, 1.0f].
     */
    @JvmDefault
    val alphaTick : Float
        get() = 0.07f
}

To disable fade-in effect, you can configure your MapView like so:

val tileOptionsProvider = object : TileOptionsProvider {
      override val alphaTick: Float
           get() = 255f
}

val config = MapViewConfiguration(
    5, 8192, 8192, tileSize, tileStreamProvider)
.setMaxScale(2f).setTileOptionsProvider(tileOptionsProvider)

You might have to add this to your android{} section of your build.gradle:

compileOptions {
    sourceCompatibility JavaVersion.VERSION_1_8
    targetCompatibility JavaVersion.VERSION_1_8
}
kotlinOptions {
    jvmTarget = JavaVersion.VERSION_1_8
    freeCompilerArgs = ['-Xjvm-default=compatibility']
}

Reload tiles while keeping the same TileStreamProvider

Starting from MapView v.2.1.6, you can use MapView.reloadTiles().

Reload tiles using a different TileStreamProvider

By design, you can only provide a TileStreamProvider while configuring a MapView. This allows for a robust model and avoids side effects. However, you can still produce a similar visual effect by:

  1. Destroying the existing MapView while remembering current zoom and scroll,
  2. Create and add a new MapView using the same id,
  3. Restore the zoom and scroll from remembered values

Here's what such a code would look like:

/* Remove the existing the MapView, while remembering scale and scroll */
removeMapView()
val previousScale = mapView?.scale
val previousScrollX = mapView?.scrollX
val previousScrollY = mapView?.scrollY
mapView?.destroy()

/* Create and configure a new MapView */
setMapView(MapView(requireContext()))
checkThenConfigureMapView()

/* Restore the scale and scroll */
if (previousScale != null && previousScrollX != null && previousScrollY != null) {
   mapView?.scale = previousScale
   mapView?.scrollTo(previousScrollX, previousScrollY)
}

Do note that the above code should be called while the fragent is in RESUMED state.