GetBasemapsAsync Method

In This Topic

Gets the list of base maps that are configured for the given portal.

Syntax

Visual Basic (Declaration)
C#

Public Shared Function GetBasemapsAsync( _
   ByVal portal As ArcGISPortal _
) As Task(Of IReadOnlyList(Of PortalItem))

public static Task<IReadOnlyList<PortalItem>> GetBasemapsAsync( 
   ArcGISPortal portal
)

Parameters

portal

Return Value

Task{IReadOnlyList {ArcGIS.Desktop.Core.Portal.PortalItem}}

Exceptions

Exception	Description
PortalConnectionDoesNotExistsException	Thrown when an invalid portal is provided as the active portal.
System.InvalidOperationException	Base map gallery group query was not found.
System.InvalidOperationException	Base map gallery group for 'baseMapGroupQuery' was not found.
System.Net.Http.HttpRequestException	You do not have permissions to access this resource or perform this operation.
System.Net.Http.HttpRequestException	Request failed: status code {status code}.

Remarks

The base maps may include vector base maps if the portal administrator has configured vector base maps as the preferred default. The base maps may also vary depending on the given user's culture.

Example

Get Basemaps

{
    //Basemaps stored locally in the project. This is usually an empty collection
    //Note: Needs QueuedTask to run
    string localBasemapTypeID = "cim_map_basemap";

    var mapContainer = Project.Current.GetProjectItemContainer("Map");
    mapContainer.GetItems().Where(i => i.TypeID == localBasemapTypeID).ToList();

    //portal basemaps. If there is no current active portal, the usual default
    //is arcgis online
    var portal = ArcGISPortalManager.Current.GetActivePortal();
    var portalBaseMaps = await portal.GetBasemapsAsync();

    //use one of them...local or portal...
    //var map = MapView.Active.Map;
    //QueuedTask.Run(() => map?.SetBasemapLayers(portalBaseMaps[0]));  
}

Requirements

Target Platforms: Windows 11 Home, Pro, Enterprise (64 bit)

ArcGIS Pro version: 3.0 or higher.

Reference

ArcGISPortalExtensions Class
ArcGISPortalExtensions Members

Send feedback