Skip To Content ArcGIS for Developers Sign In Dashboard

ArcGIS Runtime SDK for .NET


This code sample is available for these platforms:
View Sample on GitHub

Display a WMS layer using a WMS service URL.


How to use the sample

The map will load automatically when the sample starts.

How it works

  1. Create a WmsLayer specifying the URL of the service and the names of layers you want to display.
    • Note: The name comes from the Name property, not the Title property. On many services, the title is human-readable while the name is a numeric identifier.
  2. Add the layer to the map as an operational layer.

Relevant API

  • Map
  • MapView
  • WmsLayer

About the data

This sample uses a U.S. National Weather Service radar map. Because WMS services generate map images on-the-fly, this layer is always up-to-date with the latest NOAA NEXRAD radar observations.


OGC, WmsLayer, web map service

Sample Code

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns=""
        <esriUI:MapView x:Name="MyMapView" />
// Copyright 2017 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.

using Esri.ArcGISRuntime.Geometry;
using Esri.ArcGISRuntime.Mapping;
using System;
using System.Collections.Generic;
using Xamarin.Forms;

namespace ArcGISRuntime.Samples.WMSLayerUrl
        "WMS layer (URL)",
        "Add a layer from a WMS service to a map.",
    public partial class WMSLayerUrl : ContentPage
        // Hold the URL to the WMS service showing U.S. weather radar.
        private readonly Uri _wmsUrl = new Uri(

        // Hold a list of uniquely-identifying WMS layer names to display.
        private readonly List<string> _wmsLayerNames = new List<string> { "1" };

        public WMSLayerUrl()


        private void Initialize()
            // Create a map with basemap and initial viewpoint.
            Map myMap = new Map(Basemap.CreateLightGrayCanvas())
                // Set the initial viewpoint.
                InitialViewpoint = new Viewpoint(
                    new Envelope(-19195297.778679, 512343.939994, -3620418.579987, 8658913.035426, 0.0, 0.0, SpatialReferences.WebMercator))

            // Add the map to the mapview.
            MyMapView.Map = myMap;

            // Create a new WMS layer displaying the specified layers from the service.
            WmsLayer myWmsLayer = new WmsLayer(_wmsUrl, _wmsLayerNames);

            // Add the layer to the map.