Maps SDK For Android Examples

Clone repository and build the Maps SDK Examples app to see key features of the Maps SDK. Modify the source code to learn more about the SDK. This Maps SDK Examples app is provided by TomTom and subject to TomToms privacy policy at https://tomtom.com/privacy. Developers using TomTom SDKs and APIs in their apps similarly bear responsibility to adhere to applicable privacy laws. These Maps SDK Examples are provided as-is and shall be used internally, and for evaluation purposes only. Any other use is strictly prohibited.

Documentation

More informations how to start are available on: Maps SDK for Android page.

• Map

• Search

• Routing

• Traffic

• Release notes

• Migration guide from Google Maps SDK

Api Reference

• Javadocs for Map

• Javadocs for Search

• Javadocs for Routing

• Javadocs for Traffic

Project set up

To develop your own application with Maps SDK, you need to make sure that the pre-requisites are in place and that you have added Maps SDK  as a dependency into your project. Follow the steps below and then you are ready to code!

Get the pre-requisites in place:

• Android Studio IDE installed (Android Studio)

• Set up the application minimum API level to Android 4.4 "Kit Kat" (API Level 16) or higher

Set up your project like this:

1. Open Android Studio IDE

2. Create a new project or open an existing one

Add repositories to all projects to root/build.gradle:

allprojects {

   repositories {
      google()
      jcenter()
      maven {
         url 'https://maven.tomtom.com:8443/nexus/content/repositories/releases/'
      }
   }   
}

Configuration for all Maps SDK modules

To include all Maps SDK modules in your app, modify AndroidManifest.xml and build.gradle  

• Modify AndroidManifest.xml

  Add service keys, taken from http://developer.tomtom.com, inside <application> tag.

  <meta-data android:name="OnlineMaps.Key" android:value="undefined" />
  <meta-data android:name="OnlineTraffic.Key" android:value="undefined" />
  <meta-data android:name="OnlineSearch.Key" android:value="undefined" />
  <meta-data android:name="OnlineRouting.Key" android:value="undefined" />

• Modify build.gradle (app/build.gradle)

  //library required to display map
  api "com.tomtom.online:sdk-maps:2.+"
  
  //library required for search
  api "com.tomtom.online:sdk-search:2.+"
  
  //library required for routing
  api "com.tomtom.online:sdk-routing:2.+"
  
  //library required for traffic
  api "com.tomtom.online:sdk-traffic:2.+"

• Add MultiDex support if required, as described here

License

Copyright (c) 2015-2018 TomTom N.V. All rights reserved.

This software is the proprietary copyright of TomTom N.V. and its subsidiaries and may be used for internal evaluation purposes or commercial use strictly subject to separate licensee agreement between you and TomTom. If you are the licensee, you are only permitted to use this Software in accordance with the terms of your license agreement. If you are not the licensee then you are not authorised to use this software in any manner and should immediately return it to TomTom N.V.

See the LICENSE file for details.