Overview

You will learn: how to display a web map that you created in the Create a web map design lab.

With the ArcGIS Runtime SDK for Android, it is easy to create an app that displays a web map. A web map is special because its format is interchangeable between most applications running on the ArcGIS platform. Web maps are generally created interactively with the Map Viewer and saved in ArcGIS Online. When you save a web map it stores the initial map configuration settings such as the basemap, layer styles, and the pop-up configuration, making it easy for you to load the web map and use the pre-existing settings. This will give you a jump-start building great looking apps. Web maps can also be updated and saved independently from your apps. This is handy if you want to make changes to the map and layers but don't want to make code changes to the app itself.

In this lab, you will use the ArcGIS Android SDK to build a simple mapping app that loads and displays a web map.

Before you begin

Make sure you have installed the latest version of Android Studio.

Reuse the starter project

In a new or empty project folder, make a copy of the Create a starter app or download and unzip the project solution.

  • Open the new Android project in Android Studio.

  • Run the project and verify the project builds and the map displays in the device simulator.

  • You may be required to sync the project dependencies.

Preview the web map

  1. Go to the LA Trails and Parks Map to view the map in the Map Viewer. Make note of the id at the end of the url.

Steps

Add a web map to the map

  1. In the file app > java > {your.package.name} > MainActivity.java, locate the setupMap() member function. Change the way the ArcGISMap is initialized to reference the web map that was created in the Configure pop-ups design lab. Create the web map given its item ID and the portal where it is located.

     private void setupMap() {
         if (mMapView != null) {
             String itemId = "41281c51f9de45edaf1c8ed44bb10e30";
             Portal portal = new Portal("https://www.arcgis.com", false);
             PortalItem portalItem = new PortalItem(portal, itemId);
             ArcGISMap map = new ArcGISMap(portalItem);
             mMapView.setMap(map);
         }
     }
    
  2. Press Control-R to run your project in the simulator.

Congratulations, you're done!

Your map should show trails, trail heads and parks in the Santa Monica Mountains. Compare your solution with our completed solution project.

Challenge

Use your web map

Instead of using the web map we prepared, use the web map you made in the design lab Create a Web Map (2D).

Replace the itemId variable with the ID of your own web map.

Change your map design

Open your web map in the map viewer, make changes to your map design, then save your map. Next time you load that map in your app your changes will be reflected.