Registering and Testing Your Amazon Maps API v2 App

You must register your app to give your app access to the Amazon Maps API map tiles.

Once you have registered the app, you can test it on an Amazon device, such as a Fire tablet or Fire phone.

Registering Your App

Each app must have its own registration, and separate registration is required for debug and release builds. In order to load map tiles during testing, you must register the debug build of your app.

Registration for the release build is a separate process and occurs automatically when you submit your app if you have already created a debug registration.

Registration for apps that used Maps v1 will be migrated to v2.

Registration requires three steps:

  1. Retrieve the MD5 and SHA-256 debug fingerprint for your app.
  2. Register your app on the Amazon Mobile Apps & Games Developer portal.
  3. Submit a debug registration request for your app. Provide the debug fingerprint retrieved in step 1 in this submission.

Getting the MD5 and SHA-256 Debug Fingerprint

With your registration request, you must provide the MD5 and SHA-256 debug fingerprint that is applied by the tools that you use to build your app.

To obtain the fingerprint, you can run a keytool command from the JDK bin directory. Before running the keytool command, you need to know the path to the debug keystore.

To show the path to the debug keystore in Eclipse:

  1. On the Windows menu, click Preferences.
  2. Expand Android, and then click Build.
  3. In the Default debug keystore box, view or copy the path.

The following table shows the default locations for the debug keystore.

Operating system left">Path
Windows 7 / Windows Vista <SYSTEMDRIVE> :Users <user> .androiddebug.keystore
Windows XP _ <SYSTEMDRIVE> :Documents and Settings <user> .androiddebug.keystore
Mac OS / Linux ~/.android/debug.keystore

At the command line, run the following command:

Mac OS/ Linux:

    keytool -v -list -alias androiddebugkey -keystore ~/.android/debug.keystore -storepass android

Windows:

    keytool -v -list -alias androiddebugkey -keystore %HOMEPATH%\.android\debug.keystore  -storepass android

When the command runs successfully, it produces output similar to the following:

Alias name: androiddebugkey
Creation date: Aug 11, 2014
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 00000000
Valid from: Mon Aug 11 15:16:52 PDT 2014 until: Wed Aug 03 15:16:52 PDT 2044
Certificate fingerprints:
    MD5:  00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00
    SHA1: 00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00
    SHA256: 00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00
Signature algorithm name: SHA256withRSA

If you see only the SHA1 fingerprint under Certificate fingerprints, be sure to use the -v option and then run the command again.

If you omit the -storepass parameter, you will be prompted to enter the password for the keystore. The default password for the debug keystore is android.

Registering Your App on the Amazon Mobile Apps & Games Developer Portal

You can submit registration requests for your apps on the Amazon Mobile Apps & Games Developer Portal.

To register your app:

  1. Sign in, and then open the list of your apps.
  2. If the app that you want to register for the Amazon Maps API is not already listed, click Add a New App.
  3. Fill out the form, and then click Save.

Submitting Your Debug Registration Request

To submit a debug registration request for your app that uses the Amazon Maps API:

  1. On the Amazon Apps & Games Developer Portal, open the list of your apps.
  2. Click the app that you want to register. If your app is not listed, first add the app to the portal.
  3. Click Maps.
  4. Click Add a Debug Registration.
  5. In the Package name box, enter the package name for your app.
  6. In the Developer signature box, enter the MD5 and SHA-256 fingerprint of the debug certificate that you obtained by running the keytool command.
  7. Click Submit.

It takes time to propagate the registration to your device. After clicking Submit, allow one hour before testing the app that you registered. If a recently registered app does not show map tiles, you may need to allow more time for registration to take effect.

Loading Your App on a Device for Testing

Once you have registered your app, you can use Android Debug Bridge (ADB) to connect your device to a development computer for testing and debugging.

For information about using ADB, see:

Guidelines for Testing Your App

Make sure that you include the following in your test plans:

  • Test whether map tiles appear when you run your app.
  • Test all of your mapping-related functionality.
  • Where Google Maps and Amazon Maps API functionality differs, verify that your app works as you intended, particularly if you migrated the application from Google Maps. For information about the differences, see Differences between the Amazon Maps API and Google Maps API.
  • Verify that your application adjusts on devices that do not support the Amazon Maps API v2.

    The Amazon Maps v2 API is supported on Fire phone and 3rd generation or later Fire tablets with FireOS 4.5 and later. Earlier devices (Kindle Fire tablets 2nd generation and earlier) do not support the Maps API.

    Test your app on earlier devices to ensure that it runs successfully with mapping functionality hidden.