ArcGIS Runtime SDK for Java

Web Tiled Layer

Demonstrates how to display map tiles from a non-ArcGIS service as a layer in a map.

WebTiledLayer provides a simple way to integrate non-ArcGIS Services as a layer in a map. In this case, map tiles from Stamen are added to the map. The template URI is specified by setting the subDomains, level, column, and row attributes. Additionally, copyright information is added to the layer so that the layer can be properly attributed.

How it works

To create and display a WebTiledLayer with custom attribution:

  1. Create a WebTiledLayer specifying the list of subdomains and a template URI.
  2. After loading the layer, use webTiledLayer.setAttribution(attributionText) to set custom attribution.


 * Copyright 2018 Esri.
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
 * use this file except in compliance with the License. You may obtain a copy of
 * the License at
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations under
 * the License.

package com.esri.samples.tiledlayers.web_tiled_layer;

import java.util.Arrays;
import java.util.List;

import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.control.Alert;
import javafx.scene.layout.StackPane;
import javafx.stage.Stage;

import com.esri.arcgisruntime.layers.WebTiledLayer;
import com.esri.arcgisruntime.loadable.LoadStatus;
import com.esri.arcgisruntime.mapping.ArcGISMap;
import com.esri.arcgisruntime.mapping.Basemap;
import com.esri.arcgisruntime.mapping.view.MapView;

public class WebTiledLayerSample extends Application {

  private MapView mapView;

  public void start(Stage stage) {

    try {
      // create stack pane and application scene
      StackPane stackPane = new StackPane();
      Scene scene = new Scene(stackPane);

      // set title, size, and add scene to stage
      stage.setTitle("Web Tiled Layer Sample");

      // create a map view and set a map to it without a basemap
      mapView = new MapView();
      final ArcGISMap map = new ArcGISMap();

      // create a list of subdomains and template URI
      List<String> subDomains = Arrays.asList("a", "b", "c", "d");
      String templateURI = "http://{subDomain}{level}/{col}/{row}.png";

      // create a web tiled layer
      final WebTiledLayer webTiledLayer = new WebTiledLayer(templateURI, subDomains);
      webTiledLayer.addDoneLoadingListener(() -> {
        if(webTiledLayer.getLoadStatus() == LoadStatus.LOADED){
          // set the web tiled layer as the map's basemap
          map.setBasemap(new Basemap(webTiledLayer));
          // set custom attribution on the layer
          webTiledLayer.setAttribution("Map tiles by <a href=\"\">Stamen Design</a>, " +
              "under <a href=\"\">CC BY 3.0</a>. " +
              "Data by <a href=\"\">OpenStreetMap</a>, " +
              "under <a href=\"\">CC BY SA</a>.");
        } else {
          new Alert(Alert.AlertType.ERROR, webTiledLayer.getLoadError().getMessage()).show();

      // add the map view and control panel to stack pane
    } catch (Exception e) {
      // on any error, display stack trace

   * Stops and releases all resources used in application.
  public void stop() {

    if (mapView != null) {

   * Opens and runs application.
   * @param args arguments passed to this application
  public static void main(String[] args) {



In this topic
  1. How it works
  2. Code