Documentación / Básicos / Circle

Círculo (Circle)

Dibuja un círculo con un centro y un radio en metros. El radio se ajusta al zoom y tiene el mismo aspecto en cualquier proveedor.

ANDROID
com.mapconductor:core
iOS
MapConductorCore
REACT
@mapconductor/js-sdk-react
Plataforma

01 · Uso

Simplemente cree un objeto de estado y colóquelo en la vista del mapa. El radio y el color se aplican inmediatamente al cambiar las propiedades.

CircleScreen.kt · Jetpack Compose
val circleState = remember {
    CircleState(
        center = GeoPoint.fromLatLong(21.382314, -157.933097),
        radiusMeters = 1000.0,
        strokeWidth = 3.dp,
        fillColor = Color.Red.copy(alpha = 0.3f),
        onClick = { /* circle tapped */ },
    )
}

MapLibreMapView(state = mapState) {
    Circle(circleState)
}

02 · Opciones principales

Option
Type
Descripción
center
GeoPoint
El centro del círculo.
radiusMeters
Double
El radio en metros. No en píxeles de pantalla.
fillColor / strokeColor
Color
Colores de relleno y línea. La transparencia se especifica mediante el alfa del color.
strokeWidth
Dp · Double · number
Grosor de línea.
geodesic
Boolean · true
Si se dibuja un círculo correcto a lo largo de la línea geodésica. A diferencia del polígono y la polilínea, el valor predeterminado del círculo es true.
clickable
Boolean · true
Si se detecta el toque.
zIndex
Int? · null
Orden de superposición. Opcional.
extra
any?
Datos adjuntos arbitrarios. Se reciben al hacer clic.
onClick
handler
Recibe toques en el círculo.

03 · Ejemplo

Cambiar el radio arrastrando

En la aplicación de ejemplo, se colocan marcadores en el centro y en el perímetro, y el radio se recalcula arrastrando el marcador del perímetro. Hay una función auxiliar de cálculo de distancia incluida en core.

Video de ejemplo · Cómo difieren los círculos geodésicos en varios SDK de mapas

Páginas relacionadas