Add Circle Annotations
There are several ways to add markers, annotations, and other shapes to the map using the Maps SDK. To choose the appropriate approach for your application, read the Markers and annotations guide.
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.
CircleAnnotationActivity.kt
package com.mapbox.maps.compose.testapp.examples.annotation
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.ui.Modifier
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.graphics.toArgb
import com.mapbox.geojson.Point
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.extension.compose.MapboxMap
import com.mapbox.maps.extension.compose.animation.viewport.MapViewportState
import com.mapbox.maps.extension.compose.annotation.generated.CircleAnnotation
import com.mapbox.maps.extension.compose.annotation.generated.CircleAnnotationGroup
import com.mapbox.maps.extension.compose.annotation.generated.withCircleColor
import com.mapbox.maps.extension.style.expressions.dsl.generated.literal
import com.mapbox.maps.extension.style.expressions.generated.Expression
import com.mapbox.maps.plugin.annotation.AnnotationConfig
import com.mapbox.maps.plugin.annotation.AnnotationSourceOptions
import com.mapbox.maps.plugin.annotation.ClusterOptions
import com.mapbox.maps.plugin.annotation.generated.CircleAnnotationOptions
/**
* Example to showcase usage of CircleAnnotation with Jetpack Compose.
*/
public class CircleAnnotationActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContent {
MapboxMapComposeTheme {
ExampleScaffold {
MapboxMap(
Modifier.fillMaxSize(),
mapViewportState = MapViewportState().apply {
setCameraOptions {
zoom(ZOOM)
center(CityLocations.HELSINKI)
}
}
) {
CircleAnnotation(
point = SINGLE_POINT,
onClick = {
Toast.makeText(
this@CircleAnnotationActivity,
"Clicked on Circle Annotation: $it",
Toast.LENGTH_SHORT
).show()
true
}
) {
circleRadius = 20.0
circleColor = Color.Blue
}
CircleAnnotationGroup(
annotations = CLUSTER_POINTS.map {
CircleAnnotationOptions()
.withPoint(it)
.withCircleRadius(10.0)
.withCircleColor(Color.Red)
},
annotationConfig = AnnotationConfig(
annotationSourceOptions = AnnotationSourceOptions(
clusterOptions = ClusterOptions(
textColorExpression = Expression.color(Color.Yellow.toArgb()),
textColor = Color.Black.toArgb(), // Will not be applied as textColorExpression has been set
textSize = 20.0,
circleRadiusExpression = literal(25.0),
colorLevels = listOf(
Pair(100, Color.Red.toArgb()),
Pair(50, Color.Blue.toArgb()),
Pair(0, Color.Green.toArgb())
)
)
)
),
onClick = {
Toast.makeText(
this@CircleAnnotationActivity,
"Clicked on Circle Annotation Cluster item: $it",
Toast.LENGTH_SHORT
).show()
true
}
)
}
}
}
}
}
private companion object {
const val ZOOM: Double = 10.0
const val INTERVAL = 0.01
val CLUSTER_POINTS: List<Point> by lazy {
mutableListOf<Point>().apply {
repeat(10) { x ->
repeat(10) { y ->
add(
Point.fromLngLat(
CityLocations.HELSINKI.longitude() + INTERVAL * x,
CityLocations.HELSINKI.latitude() + INTERVAL * y
)
)
}
}
}
}
val SINGLE_POINT: Point = Point.fromLngLat(
CityLocations.HELSINKI.longitude() - INTERVAL,
CityLocations.HELSINKI.latitude() - INTERVAL
)
}
}
Was this example helpful?