Take the 2-minute tour ×

What I want is to display a simple offline map using OpenStreetMap. I cannot find in the web the right tools to create map tiles and use it to display a map in Android. I have downloaded different resources but it seems that I don't have any idea where to start. I want to integrate images from OpenStreetMap using JOSM but i don't know if I can use it on Android.

Can I use Mapnik? Your help will a great thank you.

share|improve this question
Yes, you can use Mapnik. But this question is off-topic here. You should ask on help.openstreetmap.org instead. –  Jonas Oct 3 '11 at 10:16
i don't think this is offtopic, but u'r right at help.openstreetmap.org may be more OSM-experts –  youseeus Oct 4 '11 at 10:12
thanks for commenting..any other ideas you can add to the topic? –  rahstame Oct 4 '11 at 10:19
I was be able to display a Map but uses internet " <uses-permission android:name="android.permission.INTERNET" />". <--I don't want to use this. I mean, a project that works offline. I want to display a map which is stored in one of the folders in my project and display it programmatically. It should be offline, and should be able to zoom in/out. Please share your thoughts in this. Thank you mr tim for clearing my thoughts. Please share other ideas. –  rahstame Oct 5 '11 at 17:37
add comment

2 Answers

up vote 14 down vote accepted

I'm currently developing (my first) Android application using the OpenStreetMap (OSM) API, so while I can't help you with the JSOM, I can try to help with the OSM part:

Assuming that you want to create a new activity in your android application that simply displays a OSM map, you might start with something like this:

package example.stackoverflow.osmdroid;

import android.app.Activity;
import android.os.Bundle;

import org.osmdroid.tileprovider.tilesource.TileSourceFactory;
import org.osmdroid.util.GeoPoint;
import org.osmdroid.views.MapView;

public class YourMap extends Activity {
    // The MapView variable:
    private MapView m_mapView;

    // Default map zoom level:
    private int MAP_DEFAULT_ZOOM = 15;

    // Default map Latitude:
    private double MAP_DEFAULT_LATITUDE = 38.535350;

    // Default map Longitude:
    private double MAP_DEFAULT_LONGITUDE = -121.753807;

    public void onCreate(Bundle savedInstanceState) {

        // Specify the XML layout to use:

        // Find the MapView controller in that layout:
        m_mapView = (MapView) findViewById(R.id.mapview);

        // Setup the mapView controller:
    } // end onCreate()
} // end class YourMap

Where your osm_map.xml layout may look something like this:



As for the actual map tiles, there is a really cool program called Mobile Atlas Creator, which allows you to generate the necessary map tiles for the offline Android map implemented above.

Once you have the application installed, and you want to create a new atlas, you'll be asked to select your "desired altas format." When this pops up, select "Osmdroid zip."

Once everything loads, select a region on the map that you would like to create tiles for, select the zoom levels you want tiles for, and hit the "Add Selection" button in the column on the left, followed by "Create Atlas."

Oh, and depending on the source, you may need to check the "Create/Adjust Map tiles" checkbox to force the tiles to be exported as PNGs -- does anyone know if it's possible to use JPG with OSM?

Once the ZIP has been generated, I renamed it to "Mapnik.zip" and moved it to a newly created folder called "tiles" in my Eclipse Android project workspace. In order to get it working, I also had to open the zip file, and rename the top level folder from something like "Google Earth" (depending on the map source you used), to "Mapnik," in order for the tile to display in my Android application.

In order to actually load the tiles onto your phone, however, you'll need to use the ADB tool from the terminal. In your ADB tool directory, you'll want to run something like this (each line is a new command):

./adb shell rm -r /sdcard/osmdroid/
./adb shell mkdir /sdcard/osmdroi/
./adb push ~/path/to/your/mapnik.zip /sdcard/osmdroid

Depending on the size of the map and the speed of the phone's memory bus, this last step may take a several minutes to an hour to complete. Once done, your map should work -- I hope!

As I mentioned, this is the first time I've used the OSM API, so I'm by no means an expert on it, and I can only comment on what worked for me.

Hope this will help you get started!


I didn't have a chance to actually run the code that I wrote up yesterday, so I didn't catch a few of the errors. I just created a new project in Eclipse, dumped my code in there, fixed a few things and got it up and running. All changes that I made are reflected in the code above! I forgot several of the basic import statements, and I forgot to add permissions to the manifest.xml file.

The last few lines of my manifest.xml now look like this:

    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/> 
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

And you also might want to add this to the manifest, although certainly not critical:


Add this right after the <uses-sdk ... /> part.

Furthermore, be sure to import the following two JAR libraries:

osmdroid-android-3.0.3.jar // Or whatever version you're using...


slf4j-android-1.5.8.jar // Or whatever the latest version is...

Without this last JAR, my code kept crashing until I remembered to include it.

Make sure to modify the default coordinates so that they point to a location that you actually have map tiles for, otherwise you're not going to see much of anything, aside from a white canvas.

Sorry for not running the code on my end first!

share|improve this answer
hi Sir Tim. You are truly awesome. Thank you for sharing your code and your ideas. I am really excited to try this out. Your procedure are very clear and very informative. Please update your status sir..thank you. –  rahstame Oct 5 '11 at 14:08
I have this errors: [2011-10-05 22:22:58 - OsmNavigator] Dx 1 error; aborting [2011-10-05 22:22:58 - OsmNavigator] Conversion to Dalvik format failed with error 1 [2011-10-05 22:26:07 - YourMap] Dx UNEXPECTED TOP-LEVEL EXCEPTION: java.lang.IllegalArgumentException: already added: Lorg/osmdroid/tileprovider/tilesource/bing/BingMapTileSource; [2011-10-05 22:26:07 - YourMap] Dx at com.android.dx.dex.file.ClassDefsSection.add(ClassDefsSection.java:123) [2011-10-05 22:26:07 - YourMap] Dx at com.android.dx.dex.file.DexFile.add(DexFile.java:143) –  rahstame Oct 5 '11 at 14:35
Hi rahstame, judging by the output you posted, you might be trying to include two JARs that share some of the same packages and classes; in other words, there is a conflict between some of your included JAR files. Take a look at the suggestions in this link. –  Tim Severeijns Oct 5 '11 at 16:02
When I right click the project > properties > java build paths > libraries. Then I found out that there are diff libraries I used osmdroid-android-3.0.1.jar and osmdroid-android-3.0.5.jar. I deleted the 3.0.5.jar. Then I was able to compile but when I go to the emulator screen it displays "Sorry the application runs unexpectedly" –  rahstame Oct 5 '11 at 16:13
show 7 more comments
./adb shell rm -r /sdcard/osmdroid/
./adb shell mkdir /sdcard/osmdroi/

sorry,I use this sentence in cmd but no ham permission to do it and the i copy and past Mapnik.zip into sdcard/osmdroid

then i run programm but have not run and no eny log in logcat.I debug it and when arrived to setContentView(R.layout.activity_main); the program is closed I think the error is for org.osmdroid.views.MapView> enter xml code here

in layout I want any body help me

share|improve this answer
This does not provide an answer to the question. To ask a new question, use the "Ask Question" button at the top of the page. –  Ed Cottrell 1 hour ago
add comment

Your Answer


