Módulos

MapConductor está dividido en varios módulos de Gradle para que solo tengas que depender de lo que realmente necesitas. En esta página se resume cada módulo mapconductor-xxx en la versión v1.1.2.

Núcleo y BOM

`mapconductor-bom`

Bill of Materials para todos los artefactos de MapConductor.

Alinea las versiones entre todos los módulos
Recomendado para todos los proyectos

implementation(platform("com.mapconductor:mapconductor-bom:1.1.2"))

`mapconductor-core`

Runtime central y abstracciones compartidas:

Tipos de geometría: GeoPoint, GeoRectBounds
Tipos de cámara: MapCameraPosition, VisibleRegion
Abstracciones de mapa: MapViewState, MapViewController, MapViewBase
Primitivas de overlay: MarkerState, PolylineState, PolygonState, CircleState, GroundImageState

Todos los demás módulos se construyen sobre mapconductor-core.

Integraciones de proveedores de mapas

Los módulos específicos de cada SDK implementan la API unificada:

`mapconductor-for-googlemaps`

Composable GoogleMapView
GoogleMapViewStateImpl
Controladores de overlays específicos de Google Maps

`mapconductor-for-mapbox`

Composable MapboxMapView
MapboxViewStateImpl

`mapconductor-for-here`

Composable HereMapView
HereViewStateImpl

`mapconductor-for-arcgis`

Composable ArcGISMapView
ArcGISMapViewStateImpl

`mapconductor-for-maplibre`

Composable MapLibreMapView
MapLibreViewStateImpl

Cada módulo de proveedor:

Implementa MapViewState y los bindings del controlador
Mapea la cámara y región visible específicas del proveedor a MapCameraPosition
Expone controladores de overlays (marcador, polilínea, polígono, círculo y ground image cuando se soporta)

Módulos experimentales / utilitarios

`mapconductor-icons`

Iconos de marcador implementados en Compose puro:

CircleIcon, FlagIcon
Estilos de burbuja de información (redonda, con cola, etc.)

Útiles cuando necesitas una apariencia de marcadores consistente entre proveedores sin depender de drawables específicos del SDK.

`mapconductor-marker-strategy`

Estrategias de renderizado de marcadores de alto nivel:

Estrategias espaciales / similares a clustering
Abstracciones para conjuntos de marcadores controlados de forma remota

Diseñado para funcionar con cualquier módulo de proveedor a través de interfaces compartidas.

`mapconductor-marker-native-strategy`

Estrategias aceleradas de forma nativa para conjuntos muy grandes de marcadores:

Enfocadas en el rendimiento a gran escala
Normalmente se usan junto con mapconductor-marker-strategy

Aplicaciones de ejemplo

`example-app`

Aplicación de demostración que muestra:

Uso básico del mapa y cambio de proveedor
Manejo de cámara y región visible (VisibleRegionPage, ZoomCalibrationPage)
Polilíneas, polígonos, círculos y ground images
Burbujas de información e iconos de marcador personalizados

`simple-map-app`

Ejemplo mínimo para pruebas rápidas de integración y depuración.

Cómo elegir módulos

Configuraciones típicas:

// Mínimo: solo Google Maps
implementation(platform("com.mapconductor:mapconductor-bom:1.1.2"))
implementation("com.mapconductor:core")
implementation("com.mapconductor:for-googlemaps")

// Varios proveedores con iconos y estrategias
implementation(platform("com.mapconductor:mapconductor-bom:1.1.2"))
implementation("com.mapconductor:core")
implementation("com.mapconductor:for-googlemaps")
implementation("com.mapconductor:for-mapbox")
implementation("com.mapconductor:icons")
implementation("com.mapconductor:marker-strategy")

Utiliza esta página como mapa de alto nivel. La información detallada de la API para cada área (núcleo, componentes, estados, módulos experimentales) puede migrarse desde las secciones existentes de mdBook (docs/src/core, docs/src/components, etc.).