Configurar Open Mobile Maps
Pasos para usar Open Mobile Maps (io.openmobilemaps:mapscore) desde MapConductor. No se requiere clave de API.
Antes de empezar
Agregar dependencias
Open Mobile Maps está disponible en Maven Central. No es necesario agregar orígenes.
dependencies {
// Open Mobile Maps
implementation("io.openmobilemaps:mapscore:4.0.0")
// MapConductor BOM pins every module below
implementation(platform("com.mapconductor:mapconductor-bom:1.3.1"))
implementation("com.mapconductor:core")
implementation("com.mapconductor:compose")
implementation("com.mapconductor:for-openmobilemaps")
}Agregar permisos
Se requiere una red para obtener mosaicos. Si no usa la ubicación, solo basta con INTERNET.
<uses-permission android:name="android.permission.INTERNET" />
Definir el origen de los mosaicos
Dado que no hay clave, deberá decidir de dónde obtener los mosaicos. El servidor de mosaicos oficial de OpenStreetMap no está pensado para el uso continuo desde aplicaciones debido a su política de uso. En producción, use su propia distribución o una fuente comercial.
VERIFICAR
Lo que deberías ver
Muestra el mapa centrado en Tokio. Si se cargan los mosaicos, ha terminado.
@Composable
fun TestOpenMobileMaps(modifier: Modifier = Modifier) {
val mapState = rememberOpenMobileMapsMapViewState(
mapDesign = OpenMobileMapsDesign.OpenStreetMap,
cameraPosition = MapCameraPosition(
position = GeoPoint(latitude = 35.6812, longitude = 139.7671),
zoom = 11.0,
),
)
OpenMobileMapsMapView(state = mapState, modifier = modifier.fillMaxSize())
}Diseños de mapa
Solución de problemas
El mapa está completamente blanco y no se carga ningún mosaico
- Este proveedor no tiene clave de API. Primero se verifica si se puede alcanzar la URL de estilo especificada.
- Verifique que el dispositivo tenga acceso a la red.
El origen de los mosaicos devuelve 429 o 403
- El servidor de mosaicos oficial de OpenStreetMap tiene una política de uso y no está previsto para el uso continuo desde aplicaciones. En producción, use su propia distribución de mosaicos o una fuente comercial.
Siguiente
Los marcadores, polilíneas, polígonos, círculos, imágenes de suelo, capas ráster e InfoBubble se pueden seguir usando con la API común. El código de la aplicación no cambia si se cambia el proveedor.