OpenStreetMap-Tools for Android
Java XSLT HTML Other
Permalink
Failed to load latest commit information.
GoogleWrapperSample nojira adding a license activity Jan 14, 2017
OSMMapTilePackager #428 more javadoc content Oct 1, 2016
OpenStreetMapViewer #544 minor ui updates for the sample app Jan 27, 2017
config #435 part 2, settings preferences for the various configuration options Oct 21, 2016
gradle/wrapper #421 updating gradle fury Sep 18, 2016
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 #527 #180 attempt at fixing the build. root cause was related to the … Jan 15, 2017
osmdroid-android #548 #552 potential fix by reducing the amount of checks for file len… Jan 29, 2017
osmdroid-dist #553 tile server in the distro Jan 27, 2017
osmdroid-geopackage #527 #180 attempt at fixing the build. root cause was related to the … Jan 15, 2017
osmdroid-mapsforge attempting to reenable forge ci tests Jan 15, 2017
osmdroid-server-jdk #255 gradle enabling the simple tile server. this build will fail due… Dec 24, 2016
osmdroid-third-party #522 moving bing into osmdroid-android and the open map demo application Jan 8, 2017
src/site updating the src/stc content (which is a clone from the wiki Jan 17, 2017
.gitattributes Normalize line endings Mar 6, 2014
.gitignore prepare for next dev cycle Dec 13, 2016
.travis.yml #180 should fix the build Jan 14, 2017
CHANGELOG.md #428 more javadoc content Oct 1, 2016
CONTRIBUTING.md adding contributing Oct 6, 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
README.md prepare for next dev cycle Feb 5, 2017
archive.sqlite #428 more javadoc content Oct 1, 2016
build.gradle #255 jdk server Dec 31, 2016
gradle.properties prepare for next dev cycle Feb 5, 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 #381 sample proguard files Aug 28, 2016
proguard_osm.txt #381 sample proguard files Aug 28, 2016
proguard_osm_min.txt #381 sample proguard files Aug 28, 2016
settings.fdroid #407 making an fdroid compatible build profile (narrows the build to … Sep 11, 2016
settings.gradle #180 auto zoom to bounds of the selected tile source for both geopack… Jan 14, 2017
travis.sh #321 temporarily disabling the maven build from ci until the maven-an… Jun 4, 2016
world.map #180 auto zoom to bounds of the selected tile source for both geopack… Jan 14, 2017

README.md

Build Status

Maven Central

Android Arsenal

Get it on Google Play

osmdroid

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 Feb 4th, 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 {
        mavenCentral()
}

dependencies {
    compile 'org.osmdroid:osmdroid-android:5.6.4'
}

Maven dependency

<dependency>
  <groupId>org.osmdroid</groupId>
  <artifactId>osmdroid-android</artifactId>
  <version>5.6.4</version>
  <type>aar</type>
</dependency>

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

<platform>8</platform>

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.

Screenshots

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 {
            mavenCentral()
            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 gradle.properties. 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.