Documentación / Configuración / Android / Open Mobile Maps

Configurar Open Mobile Maps

Pasos para usar Open Mobile Maps (io.openmobilemaps:mapscore) desde MapConductor. No se requiere clave de API.

MODULE
com.mapconductor:for-openmobilemaps
API KEY
No necesario
VIEW
OpenMobileMapsMapView
TIME
10 minutos
El mismo proveedor, otras plataformasiOS

Antes de empezar

Entorno de desarrollo de Android (Android Studio)
minSdk 28 o superior
STEP 01

Agregar dependencias

Open Mobile Maps está disponible en Maven Central. No es necesario agregar orígenes.

app/build.gradle.ktsKotlin
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")
}
STEP 02

Agregar permisos

Se requiere una red para obtener mosaicos. Si no usa la ubicación, solo basta con INTERNET.

AndroidManifest.xmlXML
<uses-permission android:name="android.permission.INTERNET" />
STEP 03

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

Notes
OpenStreetMap
Estilo estándar de OpenStreetMap
OpenStreetMapJapan
Representación adaptada a Japón
OpenTopoMap
Mapa topográfico

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.