OpenStreetMap-Tools for Android
Java XSLT Other
Latest commit 81f1218 Oct 17, 2017 @spyhunter99 spyhunter99 Merge branch 'master' of
# Conflicts:
#	src/site
Failed to load latest commit information.
GoogleWrapperSample #701 travis Sep 2, 2017
OSMMapTilePackager #577 minor fix for windows users using the map tile packager that cau… Apr 5, 2017
OpenStreetMapViewer Feature/#736 (#741) Oct 17, 2017
config #435 part 2, settings preferences for the various configuration options Oct 21, 2016
gradle/wrapper #701 attempting to fix the build Sep 2, 2017
images Reduce aspect ratio to less than 2:1 so that image can be used on Goo… Dec 10, 2015
issues #489 update gradle fury references Dec 10, 2016
osmdroid-android-it Feature/#329 (#723) Oct 1, 2017
osmdroid-android Feature/#736 (#741) Oct 17, 2017
osmdroid-dist #553 tile server in the distro Jan 27, 2017
osmdroid-geopackage NOJIRA formatting and adding a beta log message for geopackage stuff Sep 9, 2017
osmdroid-mapsforge feature/#646: MapTileApproximater with several sources (#666) Aug 14, 2017
osmdroid-server-jdk #255 gradle enabling the simple tile server. this build will fail due… Dec 24, 2016
osmdroid-third-party Feature/#650 adjustable zoom speeds (#663) Aug 19, 2017
osmdroid-wms #716 updating references to 5.6.6 to 6.0.0 Sep 17, 2017
src test commit for using git submodule for the wiki pages, thus forcing … Oct 17, 2017
.gitattributes Normalize line endings Mar 6, 2014
.gitignore #701 attempting to fix the travis ci build Sep 2, 2017
.gitmodules test commit for using git submodule for the wiki pages, thus forcing … Oct 17, 2017
.travis.yml #701 travis Sep 2, 2017 #428 more javadoc content Oct 1, 2016 adding contributing Oct 6, 2016 NOJIRA adding an issue template Sep 17, 2017
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, links to some youtube videos Aug 20, 2017
archive.sqlite #428 more javadoc content Oct 1, 2016
build.gradle #255 jdk server Dec 31, 2016 #716 updating references to 5.6.6 to 6.0.0 Sep 17, 2017
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 feature/#255 Oct 24, 2016
proguard_openmap.txt #633 progaurd updates per user feedback Jul 29, 2017
proguard_osm.txt #633 progaurd updates per user feedback Jul 29, 2017
proguard_osm_min.txt #381 sample proguard files Aug 28, 2016
settings.fdroid #407 updating the fdroid build script Aug 19, 2017
settings.gradle Feature/#177 wms client (#699) Sep 9, 2017 #321 temporarily disabling the maven build from ci until the maven-an… Jun 4, 2016 #180 auto zoom to bounds of the selected tile source for both geopack… Jan 14, 2017

Build Status

Maven Central

Android Arsenal

Get it on Google Play


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.6.5 July 1th, 2017

Note: check your calendar, it may take up to a few days for all global mirrors to update.

Please read the osmdroid wiki for tutorials on integration.

Gradle dependency

repositories {

dependencies {
    compile 'org.osmdroid:osmdroid-android:5.6.5'

Maven dependency


Platform or API Level (API level 8 = Platform 2.2)


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

See our contributing guide

I want more!

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


Demo Videos

Free Draw

Maps Forge

Floating point zoom

IIS Tracker

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.

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

Where VERSION is the version listed as the value for pom.version in Note that when using the release versions from Maven Central, drop the :debug@aar part. When using a "release" version that you build locally with gradle, you'll need :release@aar instead.