Supported web map features

You can create a web map using ArcGIS Online or Portal for ArcGIS, then display it in your map application's MapView, as described in Work with web maps. This topic describes how the ArcGIS Runtime SDK for .NET handles certain features of web maps.

Supported web map layers

When you display a web map created using ArcGIS Online or Portal for ArcGIS in a MapView, the web map's layers are converted to layer types native to ArcGIS Runtime SDK for .NET. For more information on the JSON structure of web maps, see ArcGIS web map JSON format. The list that follows describes the layers you can add to an ArcGIS Online web map and the corresponding layer types in the ArcGIS Runtime API:

  • ArcGIS map service layer:
    • With tile cache—Creates an ArcGISTiledMapServiceLayer
    • Without tile cache—Creates an ArcGISDynamicMapServiceLayer
  • ArcGIS feature service layer—Creates a FeatureLayer
  • ArcGIS image service layer—Creates an ArcGISImageServiceLayer
  • Bing Maps basemaps—Creates a BingMapsLayer

    For your web map's Bing Maps basemap to display in an ArcGIS Runtime SDK application, set your Bing Maps key for the map by using the static LoadAsync overload of WebMapViewModel which takes a Bing key: WebMapViewModel.LoadAsync(webMap, portal, "yourBingKey");.

  • Feature collection - Creates a GraphicsLayer and displays all features in the collection as graphics
  • OpenStreetMap basemap—Creates an OpenStreetMapLayer
  • Layer from KML via URL—Creates a KMLLayer

    The URL of the KML or KMZ (compressed KML) file must be publicly accessible for the layer to display in your MapView. If you added a file to your ArcGIS Online account, the file/resource must be public.

  • Layer from CSV (by referencing a URL)—Creates a CSVLayer

Disabling editing on feature layers

When you add a layer from an editable feature server to an ArcGIS web map, you have the option to disable editing for this layer. You can do so with the ArcGIS Online web map editor by clicking the layer and selecting Disable Editing from the list of options (or conversely, if editing is disabled, Enable Editing will show as the option). If you save the web map with the editing disabled on a feature layer and open this web map in an ArcGIS Runtime application, edits on this layer will not be permitted. The reverse is not true; you cannot enable editing via the ArcGIS Online web map editor on a layer from a feature service that is not editable.


You cannot edit layers created within ArcGIS Online as map notes. The ArcGIS Runtime .NET API treats map note layers as feature collections and therefore presents them as graphics. You cannot apply graphic edits back to the service, therefore editing is disabled.

Setting a minimum and maximum scale on layers

When you create or edit a web map on ArcGIS Online, you can set a minimum and maximum scale on any layer. This is done by clicking the layer in the table of contents and, from the resulting list of options, choosing Set Visibility Range. If you've set a minimum scale on a layer in a web map, the layer will no longer display in your MapView when you are zoomed out past this scale. If you've set a maximum scale on a layer, the layer will no longer display if you are zoomed in beyond this scale.

Related topics