Load an ArcGIS tiled layer from a URL.
Use case
An ArcGISTiledLayer consumes raster tiles provided by an ArcGIS service or a tile package (.tpk & .tpkx). Dividing a raster into tiles provides the user with relevant tiles and level of detail while panning and zooming, allowing for rapid map visualization and navigation. For example, say you wanted an application with a map containing all museums in your city so that you could share this with tourists. Since only the museums would need to support being identifiable or queryable within the app, all other contextual information required to orient and direct the tourists could be sourced from a single ArcGIS tiled layer, leading to faster performance and minimizing the time to load the map.
How to use the sample
Launch the app to view the "World Topographic Map" tile layer as the basemap.
How it works
- Add an
ArcGISTiledLayerfrom an ArcGIS Online service URL to theArcGISMapas an operational layer.
Relevant API
- ArcGISTiledLayer
- Basemap
- Map
- MapView
About the data
The application utilizes the "World Topographic Map" tile layer. This presents a simple yet powerful illustration of adding visualization context to a basemap through the use of an ArcGIS tiled layer.
Additional information
An ArcGISTiledLayer can also be added to the ArcGISMap as a layer, but it's best practice to use as a basemap since its purpose is to provide geographical context. ArcGIS tiled layers do not support reprojection, query, select, identify, or editing.
Tags
basemap, layers, raster tiles, tiled layer, visualization
Sample Code
// Copyright 2016 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: http://www.apache.org/licenses/LICENSE-2.0
//
// 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.
using Android.App;
using Android.OS;
using Android.Widget;
using Esri.ArcGISRuntime.Mapping;
using Esri.ArcGISRuntime.UI.Controls;
using System;
namespace ArcGISRuntime.Samples.ArcGISTiledLayerUrl
{
[Activity (ConfigurationChanges=Android.Content.PM.ConfigChanges.Orientation | Android.Content.PM.ConfigChanges.ScreenSize)]
[ArcGISRuntime.Samples.Shared.Attributes.Sample(
name: "ArcGIS tiled layer",
category: "Layers",
description: "Load an ArcGIS tiled layer from a URL.",
instructions: "Launch the app to view the \"World Topographic Map\" tile layer as the basemap. ",
tags: new[] { "basemap", "layers", "raster tiles", "tiled layer", "visualization" })]
public class ArcGISTiledLayerUrl : Activity
{
// Hold a reference to the map view
private MapView _myMapView;
protected override void OnCreate(Bundle bundle)
{
base.OnCreate(bundle);
Title = "ArcGIS tiled layer (URL)";
// Create the UI, setup the control references and execute initialization
CreateLayout();
Initialize();
}
private void Initialize()
{
// Create new Map
Map myMap = new Map();
// Create uri to the tiled service
Uri serviceUri = new Uri(
"https://services.arcgisonline.com/arcgis/rest/services/World_Topo_Map/MapServer");
// Create new tiled layer from the url
ArcGISTiledLayer imageLayer = new ArcGISTiledLayer(serviceUri);
// Add created layer to the basemaps collection
myMap.Basemap.BaseLayers.Add(imageLayer);
// Assign the map to the MapView
_myMapView.Map = myMap;
}
private void CreateLayout()
{
// Create a new vertical layout for the app
LinearLayout layout = new LinearLayout(this) { Orientation = Orientation.Vertical };
// Add the map view to the layout
_myMapView = new MapView(this);
layout.AddView(_myMapView);
// Show the layout in the app
SetContentView(layout);
}
}
}