Skip to main content

Add Circle Annotations

Show circle annotations on a map.

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.

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?