MapConductorDocs / Setup / Android / Open Mobile Maps
Open Mobile Maps setup
How to drive Open Mobile Maps (io.openmobilemaps:mapscore) through MapConductor. There is no API key.
MODULE
com.mapconductor:for-openmobilemaps
API KEY
Not required
VIEW
OpenMobileMapsMapView
TIME
10 min
Same provider, other platformsiOS
Before you start
An Android development environment (Android Studio)
minSdk 28 or higher
STEP 01
Add the dependencies
Open Mobile Maps is on Maven Central; no extra repository is needed.
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
Add the permission
Fetching tiles needs the network. If you do not use location, INTERNET alone is enough.
AndroidManifest.xmlXML
<uses-permission android:name="android.permission.INTERNET" />
STEP 03
Decide where tiles come from
With no key, where the tiles come from is your decision. OpenStreetMap’s own tile servers are not suitable for production apps under their usage policy: serve your own, or use a commercial source.
VERIFY
What you should see
Show a map centred on Tokyo. Tiles loading means you are done.
@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())
}Map designs
Notes
OpenStreetMap
The standard OpenStreetMap style
OpenStreetMapJapan
Tuned for Japanese labelling
OpenTopoMap
Topographic
Troubleshooting
The map is blank and no tiles arrive
- This provider has no API key. Check that the style URL you pointed it at is reachable.
- Confirm the device can reach the network.
The tile source returns 429 or 403
- OpenStreetMap's own tile servers have a usage policy that does not cover production apps. Serve your own tiles, or use a commercial source.
Next
Markers, polylines, polygons, circles, ground images, raster layers and info bubbles all work through the shared API. Swapping providers does not change your application code.