Getting started with the WRLD Android SDK

1. Sign up and get an API Key

2. Get the WRLD Android SDK

If you don’t already have an Android Studio project set up then follow the Creating your Android application step in our walkthrough.

To use the SDK, you will need to add it as a library dependency in your build.gradle file in your project:

dependencies {
    compile 'com.wrld3d:wrld-android-sdk:0.0.1467@aar'

You may also need to add mavenCentral() in your project’s root build.gradle file if not already present as shown below:

buildscript {
    repositories {
allprojects {
    repositories {

3. Start mapping

See our walkthrough guide for simple step-by-step instructions on how to set up the map. This includes:

  • Setting permissions

  • Initialize an EegeoApi object using your WRLD API Key created in the first step

  • Associating the MapView object with Activity lifecycle events

4. Add some features

Now that you have your first map, let’s add some features to it!

Take a look at some of our examples to get up and running:


The WRLD Android SDK is undergoing active development - we will be expanding with further features and improvements.

For a more detailed guide, check out our walkthrough.

Full source code for all examples is available on GitHub.

Got a question?

Feel free to email us at or use our Messenger to chat to us directly!

Got a feature request, or found a bug?

Feel free to submit to the WRLD Android SDK Issue Tracker on GitHub.