Debug mode | Maps SDK | Android Docs

Use variations of debug modes of the Map.

Android Examples App Available

This example code is part of the Maps SDK for Android Examples App, a working Android project available on GitHub. Android developers are encouraged to run the examples app locally to interact with this example in an emulator and explore other features of the Maps SDK.

See our Run the Maps SDK for Android Examples App tutorial for step-by-step instructions.

Kotlin

DebugModeActivity.kt

github View on GitHub


package com.mapbox.maps.compose.testapp.examples.basic

import android.os.Bundle
import android.widget.Toast
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.runtime.Composable
import androidx.compose.runtime.LaunchedEffect
import androidx.compose.ui.Modifier
import androidx.compose.ui.tooling.preview.Preview
import com.mapbox.maps.compose.testapp.ExampleScaffold
import com.mapbox.maps.compose.testapp.examples.utils.CityLocations
import com.mapbox.maps.compose.testapp.ui.theme.MapboxMapComposeTheme
import com.mapbox.maps.debugoptions.MapViewDebugOptions
import com.mapbox.maps.extension.compose.MapEffect
import com.mapbox.maps.extension.compose.MapboxMap
import com.mapbox.maps.extension.compose.animation.viewport.MapViewportState
import com.mapbox.maps.extension.compose.rememberMapState
import com.mapbox.maps.logI
import kotlinx.coroutines.launch

/**
 * Example to showcase usage of MapEffect to enable debug mode.
 */
public class DebugModeActivity : ComponentActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContent {
      MapboxMapComposeTheme {
        MapScreen()
      }
    }
  }

  @Preview(showBackground = true)
  @Composable
  private fun MapScreen() {
    val mapState = rememberMapState()
    LaunchedEffect(Unit) {
      mapState.apply {
        launch {
          mapLoadedEvents.collect {
            logI("map events", "on map loaded")
          }
        }
        launch {
          mapIdleEvents.collect {
            logI("map events", "on map idle")
          }
        }
        launch {
          mapLoadingErrorEvents.collect {
            logI("map events", "on map loading error")
          }
        }
        launch {
          styleLoadedEvents.collect {
            logI("map events", "on style loaded")
          }
        }
        launch {
          sourceDataLoadedEvents.collect {
            logI("map events", "on source data loaded ${it.tileId}")
          }
        }
      }
    }
    ExampleScaffold {
      MapboxMap(
        Modifier.fillMaxSize(),
        mapViewportState = MapViewportState().apply {
          setCameraOptions {
            center(CityLocations.BERLIN)
            zoom(ZOOM)
            pitch(0.0)
            this.bearing(0.0)
          }
        },
        onMapClickListener = {
          Toast.makeText(this@DebugModeActivity, "Clicked on $it", Toast.LENGTH_SHORT).show()
          false
        },
        onMapLongClickListener = {
          Toast.makeText(this@DebugModeActivity, "Long-clicked on $it", Toast.LENGTH_SHORT).show()
          false
        },
        mapState = mapState,
      ) {
        // Enable debug mode using MapEffect
        MapEffect(Unit) { mapView ->
          mapView.debugOptions = setOf(
            MapViewDebugOptions.TILE_BORDERS,
            MapViewDebugOptions.PARSE_STATUS,
            MapViewDebugOptions.TIMESTAMPS,
            MapViewDebugOptions.COLLISION,
            MapViewDebugOptions.STENCIL_CLIP,
            MapViewDebugOptions.DEPTH_BUFFER,
            MapViewDebugOptions.MODEL_BOUNDS,
            MapViewDebugOptions.TERRAIN_WIREFRAME,
            MapViewDebugOptions.LAYERS2_DWIREFRAME,
            MapViewDebugOptions.LAYERS3_DWIREFRAME,
          )
        }
      }
    }
  }

  private companion object {
    const val ZOOM: Double = 9.0
  }
}

追加の開発者リソース

この{Type}は役に立ちましたか？