New to Telerik UI for WPF? Download free 30-day trial

ArcGIS Online Map Provider

The ArcGIS online services can be used via the ArcGisMapProvider class.

To use the ArcGIS vector tile services refer to the Migrating to Vector Tile Map Provider section of this article.

Currently the ArcGIS map provider support six modes which specify the type of appearance of the map can and be set using the Mode property:

  1. Aerial
  2. Physical
  3. Shaded Relief
  4. Street
  5. Terrain
  6. Topographic

The following example of the ArcGisMapProvider definition uses the Physical mode:

<telerik:RadMap x:Name="radMap" ZoomLevel="1"> 
    <telerik:RadMap.Provider> 
        <telerik:ArcGisMapProvider Mode="Physical" /> 
    </telerik:RadMap.Provider> 
</telerik:RadMap> 

ArcGisMapProvider provider = new ArcGisMapProvider(); 
provider.Mode = ArcGisMapMode.Physical; 
this.radMap.Provider = provider; 
Dim provider As New ArcGisMapProvider () 
provider.Mode = ArcGisMapMode.Physical 
Me.radMap.Provider = provider 

As of April 16, 2019, ArcGIS Online services only accept connections using TLS 1.2. Thus, you need to explicitly set the ServicePointManager.SecurityProtocol property if you're using a .NET Framework version prior to 4.7.

public App() 
{ 
    // ArcGis rest services require TLS 1.2 protocol. 
    ServicePointManager.SecurityProtocol = (SecurityProtocolType)3072; 
} 
Partial Public Class App 
    Inherits Application 
 
    Public Sub New() 
        ' ArcGis rest services require TLS 1.2 protocol. 
        ServicePointManager.SecurityProtocol = CType(3072, SecurityProtocolType) 
    End Sub 
End Class 

Here is a snapshot of the map that appears when using the Physical mode:

Rad Map Features Providers ArcGIS

For comparison, the following snapshot demonstrates the appearance of the map for the Street mode:

Rad Map Features Providers ArcGIS Street

The ArcGisMapProvider also allows the user to change the map mode using the Map View button of the toolbar.

Rad Map Features Providers ArcGIS Config

Migrating to Vector Tile Map Provider

To migrate to a vector-based tile provider that uses the ArcGIS vector tile services you can create a custom vector tile providers. The Custom Vector Tile Provider article demonstrates how to do this.

Additional to this, as of 2023, part of the ArcGIS raster-based services are obsolete and no longer supported. The following list shows the end-points of the map layers that are obsolete and if they have alternatives in the vector-based services.

Map Layer Old Address New Address
Physical https://www.arcgis.com/home/item.html?id=c4ec722a1cd34cf0a23904aadf8923a0 no longer supported
ShadedRelief https://www.arcgis.com/home/item.html?id=9c5370d0b54f4de1b48a3792d7377ff2 no longer supported
Streets (world streets) https://www.arcgis.com/home/item.html?id=3b93337983e9436f8db950e38a8629af https://www.arcgis.com/home/item.html?id=de26a3cf4cc9451298ea173c4b324736
Terrain (world terrain) https://www.arcgis.com/home/item.html?id=c61ad8ab017d49e1a82f580ee1298931 no longer supported
Topographic (world topographic) https://www.arcgis.com/home/item.html?id=30e5fe3149c34df1ba922e6f5bbf808f https://www.arcgis.com/home/item.html?id=7dc6cea0b1764a1f9af2e679f642f0f5

See Also

In this article