OpenStreetMap-Tools for Android
Java Other
Latest commit 070a5b2 Aug 25, 2016 @neilboyd neilboyd Increase versionCode
Failed to load latest commit information.
GoogleWrapperSample #378 fix for preview mode Aug 24, 2016
OSMMapTilePackager #378 fix for preview mode Aug 24, 2016
OpenStreetMapViewer #378 fix for preview mode Aug 24, 2016
gradle/wrapper #321 completed application of gradle fury, this enables publishing to… Jun 24, 2016
images Reduce aspect ratio to less than 2:1 so that image can be used on Goo… Dec 10, 2015
osmdroid-android-it Merge branch 'master' into doubles Jul 20, 2016
osmdroid-android #378 fix for preview mode Aug 24, 2016
osmdroid-dist #378 fix for preview mode Aug 24, 2016
osmdroid-forge-app #378 fix for preview mode Aug 24, 2016
osmdroid-mapsforge #378 fix for preview mode Aug 24, 2016
osmdroid-third-party #378 fix for preview mode Aug 24, 2016
.gitattributes Normalize line endings Mar 6, 2014
.gitignore #288 attempt to fix the build Mar 30, 2016
.travis.yml additional logging during ci build failures Jul 21, 2016
LICENSE Initial commit Mar 6, 2014
OSMDroid_CleanUp_Settings.xml Normalize line endings Mar 6, 2014
OSMDroid_Formatter_Settings.xml Normalize line endings Mar 6, 2014 nojira readme update Aug 20, 2016
build.gradle #321 an attempt at integrating grade fury into the grade based build … May 31, 2016 Increase versionCode Aug 25, 2016
gradlew #91 adding grade build files. Note: this is only a partial solution, … Oct 19, 2015
gradlew.bat #91 adding grade build files. Note: this is only a partial solution, … Oct 19, 2015
pom.xml Merge branch 'master' into #213 Jul 9, 2016
settings.gradle #351 adding distribution package and readme updates Jul 10, 2016 #321 temporarily disabling the maven build from ci until the maven-an… Jun 4, 2016

Build Status Maven Central


osmdroid is a (almost) full/free replacement for Android's MapView (v1 API) class. It also includes a modular tile provider system with support for numerous online and offline tile sources and overlay support with built-in overlays for plotting icons, tracking location, and drawing shapes.

Current Release: 5.2 April 28th, 2016

Please read the osmdroid wiki for tutorials on integration.

Gradle dependency

repositories {

dependencies {
    compile 'org.osmdroid:osmdroid-android:5.2@aar'
    //Note as of 5.0, SLF4j is no longer needed!  compile 'org.slf4j:slf4j-simple:1.6.1'

Maven dependency


You can also compile osmdroid from source or download the dependency directly from OSS or download the distribution package

OK now what?

Continue reading here, How-to-use-the-osmdroid-library

Related and important wiki articles

I have a question or want to report a bug

If you have a question, please view the osmdroid FAQ.
You can also view the Stack Overflow osmdroid tag and osmdroid Google Group where you can get feedback from a large pool of osmdroid users.

If you still have an issue, please check the Changelog page to see if this issue is fixed in a newer or upcoming version of osmdroid.

If think you have a legitimate bug to report then go to the Issues page to see if your issue has been reported. If your issue already exists then please contribute information that will help us track down the source of the issue. If your issue does not exist then create a new issue report. When creating an issue, please include the version of osmdroid, the Android platform target and test device you are using, and a detailed description of the problem with relevant code. It is particularly helpful if you can reproduce the problem using our OpenStreetMapViewer sample project as your starting point.

I want to contribute

Great! Osmdroid continues to improve from the contributions of its users. This could include code contributions, sample fragments for OpenStreetMapViewer, or wiki content. If you have an enhancement to contribute please add a new issue. Describe the enhancement you are adding, how you implemented it and attach a patch against the latest trunk. Please take a look at the Developer Guidelines page for code contributions before submitting code.

I want more!

The OSMBonusPack project adds additional functionality for use with osmdroid projects.


Building from source and using the aar in your app

Thanks to Gradle Fury, this publishes the artifacts to mavenLocal.

./gradlew clean install

In your root build.gradle file, add mavenLocal() if not present.

allprojects {
    repositories {
            mavenLocal()    //add this if it's missing

Then in your APK or AAR project that needs osmdroid. Future readers: you may have to update the version numbers to match the source. Hint: the version number is defined in osmdroid file, key = pom.version.

    compile 'org.osmdroid:osmdroid-android:5.3-SNAPSHOT:debug@aar'

Running tests on a device (hardware or virtual)

./gradlew cC

Prepare distribution

./gradlew clean install distZip distro -Pprofile=sources,javadocs

Output zip is at osmdroid-dist/build/distributions/

Publish release artifacts

Edit and update the version information (android.versionCode and pom.version). Commit the change and tag with git.

Edit and set your credentials for nexus endpoint to publish to

./gradlew clean install distZip distro -Pprofile=sources,javadocs publish

Edit and remove your crendentials.