MapBox On Android

I’m a big fan of the work that MapBox has done with OpenStreetMap and the great open source tools that they provide for building custom maps.

However after searching the Web and talking with MapBox Engineers I discovered that there is no support for Android, nor are there any plans to do so. This bugged me as I want to make use of their maps on some Android projects, so I did some research and built a solution.

My original proof of concept project, called BikeMapBox, is available on GitHub, but to make it easier for others who are looking for a solution too I worked with the OSMDroid team to have it included in that project. It’ll be available in the next OSMDroid official release (it’s already in the SNAPSHOT builds on Maven Central), but if you’d like to use it now you can download the code and include it in your project’s source code.

Usage is pretty straightforward.

Add a MapView to your layout.xml file

<org.osmdroid.views.MapView
        android:layout_width="match_parent"
        android:layout_height="match_parent"

Add your MapBox Map Id to AndroidManifest.xml

<meta-data android:name="MAPBOX_MAPID" android:value="example.map-3a5gfw2p"/>

Create And Associate the MapBoxTileSource with your MapView in your Activity

MapBoxTileSource.retrieveMapBoxMapId(Context context);
MapBoxTileSource mapBoxTileSource = new MapBoxTileSource();

MapView mapView = (MapView)findViewById(R.id.mapview);
mapView.setTileSource(mapBoxTileSource);