View in MAUI UWP WPF WinUI View on GitHub
import InlineCode from "@esri-dx/starship-doc-components/components/InlineCode.astro";

Display a layer from a Web Map Tile Service.

Image of WMTS layer

Use case

WMTS services can have several layers. You can use Runtime to explore the layers available from a service. This would commonly be used to enable a browsing experience where users can choose which layers they want to display at run time.

How to use the sample

The layer will be displayed automatically. Use the buttons to choose a different method of loading the layer.

How it works

To display a WMTS layer directly from a URL:

  1. Create a
    object using the URL of the WMTS service.
  2. Create a
    object with the ID of the layer to display.

To explore layers from a WMTS service:

  1. Create a
    object using the URL of the WMTS service.
  2. After loading the WMTS service, get the list of
    objects from the service info of the WMTS service.
  3. Use one of the layer infos to create the WMTS layer.
  4. Create a basemap with the WMTS layer and set it to the map.

Relevant API

  • WmtsLayer
  • WmtsLayerInfo
  • WmtsService
  • WmtsServiceInfo

About the data

We acknowledge the use of imagery provided by services from the Global Imagery Browse Services (GIBS), operated by the NASA/GSFC/Earth Science Data and Information System (ESDIS) with funding provided by NASA/HQ.

Tags

layer, OGC, raster, tiled, web map tile service

Sample Code

WMTSLayer.xaml WMTSLayer.xaml WMTSLayer.xaml.cs
<UserControl x:Class="ArcGIS.WinUI.Samples.WMTSLayer.WMTSLayer"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:esriUI="using:Esri.ArcGISRuntime.UI.Controls">
<Grid>
<esriUI:MapView x:Name="MyMapView" />
<Border Style="{StaticResource BorderStyle}">
<StackPanel>
<Button x:Name="UriButton"
Margin="10"
HorizontalAlignment="Stretch"
Click="UriButton_Click"
Content="WMTSLayer via Uri"
IsEnabled="false" />
<Button x:Name="InfoButton"
Margin="10"
HorizontalAlignment="Stretch"
Click="InfoButton_Click"
Content="WMTSLayer via WmtsLayerInfo" />
</StackPanel>
</Border>
</Grid>
</UserControl>