Click or drag to resize

BasemapStyle Enumeration

Lists available basemap styles.

Namespace:  Esri.ArcGISRuntime.Mapping
Assembly:  Esri.ArcGISRuntime (in Esri.ArcGISRuntime.dll) Version: 100.11.0
Syntax
public enum BasemapStyle
Members
  Member nameValueDescription
ArcGISImagery0 A composite basemap with raster satellite imagery of the world as the base layer and vector labels as the reference layer.
ArcGISImageryStandard1A raster basemap with satellite imagery of the world as the base layer.
ArcGISImageryLabels2 A vector basemap with labels for the world as the reference layer. Designed to be overlaid on ArcGISImageryStandard.
ArcGISLightGray3 A vector basemap for the world featuring a light neutral background style with minimal colors as the base layer and labels as the reference layer.
ArcGISLightGrayBase4 A vector basemap for the world featuring a light neutral background style with minimal colors.
ArcGISLightGrayLabels5 A vector basemap with labels for the world as the reference layer. Designed to be overlaid on light neutral backgrounds such as the ArcGISLightGrayBase style.
ArcGISDarkGray6 A vector basemap for the world featuring a dark neutral background style with minimal colors as the base layer and labels as the reference layer.
ArcGISDarkGrayBase7 A vector basemap for the world featuring a dark neutral background style with minimal colors.
ArcGISDarkGrayLabels8 A vector basemap with labels for the world as the reference layer. Designed to be overlaid on dark neutral backgrounds such as the ArcGISDarkGrayBase style.
ArcGISNavigation9A vector basemap for the world featuring a custom navigation map style.
ArcGISNavigationNight10 A vector basemap for the world featuring a 'dark mode' version of the ArcGISNavigation style, using the same content.
ArcGISStreets11A vector basemap for the world featuring a classic Esri street map style.
ArcGISStreetsNight12A vector basemap for the world featuring a custom 'night time' street map style.
ArcGISStreetsRelief13 A composite basemap with elevation hillshade (raster) and a classic Esri street map style (vector) as the base layers.
ArcGISStreetsReliefBase30 A vector basemap in the classic Esri street map style, using a relief map as the base layer. This is a transparent basemap so it is recommended to use it along with a hillshade (raster) layer or adjust the background grid of the view.
ArcGISTopographic14 A composite basemap with raster elevation hillshade and classic Esri topographic map style including a vector relief map as the base layers.
ArcGISTopographicBase31 A vector basemap in the classic Esri topographic map style, using a relief map as the base layer. This is a transparent basemap so it is recommended to use it along with a hillshade (raster) layer or adjust the background grid of the view.
ArcGISOceans15 A composite basemap with ocean data of the world (raster) as the base layer and labels (vector) as the reference layer.
ArcGISOceansBase16A raster basemap with ocean data of the world as the base layer.
ArcGISOceansLabels17A vector basemap with labels for the world as the reference layer.
ArcGISTerrain18 A composite basemap that combines a raster elevation hillshade with minimal vector map content like water and land fill, water lines, roads, populated places, admin areas, and boundary lines.
ArcGISTerrainBase19 A vector basemap with minimal map content like water and land fill, water lines and roads as the base layer.
ArcGISTerrainDetail20 A vector basemap with minimal map content like populated places, admin areas, and boundary lines as the reference layer.
ArcGISCommunity21 A vector basemap for the world in a style that is optimized to display special areas of interest (AOIs) that have been created and edited by Community Maps contributors.
ArcGISChartedTerritory22 A composite basemap with elevation hillshade (raster) and the world featuring a geopolitical style reminiscent of a printed atlas plate or a school classroom wall map (vector) as the base layers.
ArcGISChartedTerritoryBase32 A vector basemap in a geopolitical style reminiscent of a school classroom wall map as the base layer. This is a transparent basemap so it is recommended to use it along with a hillshade (raster) layer or adjust the background grid of the view.
ArcGISColoredPencil23A vector basemap presented in the style of hand-drawn, colored pencil cartography.
ArcGISNova24 A vector basemap for the world featuring a dark background with glowing blue symbology inspired by science-fiction and futuristic themes.
ArcGISModernAntique25 A composite basemap with elevation hillshade (raster) and the look of 18th and 19th century antique maps in the modern world of multi-scale mapping (vector) as the base layers.
ArcGISModernAntiqueBase33 A vector basemap in the style of 18th and 19th century antique maps in the modern world of multi-scale mapping as the base layer. This is a transparent basemap so it is recommended to use it along with a hillshade (raster) layer or adjust the background grid of the view.
ArcGISMidcentury26 A vector basemap inspired by the art and advertising of the 1950's that presents a unique design option to the ArcGIS basemaps.
ArcGISNewspaper27 A vector basemap in black and white design with halftone patterns, red highlights, and stylized fonts to depict a unique "newspaper" styled theme.
ArcGISHillshadeLight28A raster basemap with elevation hillshade.
ArcGISHillshadeDark29 A raster basemap with world hillshade (Dark) is useful in building maps that provide terrain context while highlighting feature layers and labels.
OSMStandard101 A vector basemap version of Open Street Map (OSM) data hosted by Esri and rendered using Open Street Map (OSM) cartography.
OSMStandardRelief102 A composite basemap with raster elevation hillshade and vector Open Street Map (OSM) data hosted by Esri and rendered using Open Street Map (OSM) cartography as the base layers.
OSMStandardReliefBase103 A vector basemap is a version of Open Street Map (OSM) data hosted by Esri and rendered using Esri Street Map cartographic style.
OSMStreets104 A vector basemap version of Open Street Map (OSM) data hosted by Esri and rendered using Esri Street Map style.
OSMStreetsRelief105 A composite basemap with elevation as an artistic hillshade (raster) and vector Open Street Map (OSM) data hosted by Esri and displayed using a cartographic style similar to the Esri Street Map (with Relief).
OSMStreetsReliefBase112 A vector basemap with Open Street Map (OSM) data hosted by Esri. It is rendered similarly to the Esri Street Map (with Relief) and uses a cartographic style as the base layer. This is a transparent basemap so it is recommended to use it along with a hillshade (raster) layer or adjust the background grid of the view.
OSMLightGray106 A vector basemap version of Open Street Map (OSM) data hosted by Esri and rendered using light neutral style with minimal colors as the base layer and labels as the reference layer.
OSMLightGrayBase107 A vector basemap version of Open Street Map (OSM) data hosted by Esri and rendered using light neutral style with minimal colors as the base layer.
OSMLightGrayLabels108 A vector basemap with Open Street Map (OSM) labels as the reference layer, hosted by Esri.
OSMDarkGray109 A vector basemap version of Open Street Map (OSM) data hosted by Esri and rendered using dark neutral style with minimal colors as the base layer and labels as the reference layer.
OSMDarkGrayBase110 A vector basemap version of Open Street Map (OSM) data hosted by Esri and rendered using dark neutral style with minimal colors as the base layer.
OSMDarkGrayLabels111 A vector basemap with Open Street Map (OSM) labels as the reference layer, hosted by Esri.
Remarks
These basemaps are secured and access requires either an ApiKey or a named user. Only ArcGISImageryStandard, ArcGISOceansBase, ArcGISHillshadeLight, and ArcGISHillshadeDark are supported in both 2D maps and 3D scenes. All other styles use vector tile layers which are currently supported only in 2D maps.
Examples

UWP

Example Name: ChangeBasemap

Change a map's basemap. A basemap is beneath all layers on a `Map` and is used to provide visual reference for the operational layers.

Code example screen shot.

C#
// Copyright 2021 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: http://www.apache.org/licenses/LICENSE-2.0
// 
// 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.Mapping;
using System.Collections.Generic;
using System.Linq;
using Windows.UI.Xaml.Controls;

namespace ArcGISRuntime.UWP.Samples.ChangeBasemap
{
    [ArcGISRuntime.Samples.Shared.Attributes.Sample(
        name: "Change basemap",
        category: "Map",
        description: "Change a map's basemap. A basemap is beneath all layers on a `Map` and is used to provide visual reference for the operational layers.",
        instructions: "Use the drop down menu to select the active basemap from the list of available basemaps.",
        tags: new[] { "basemap", "map" })]
    public partial class ChangeBasemap
    {
        // Dictionary that associates names with basemaps.
        private readonly Dictionary<string, Basemap> _basemapOptions = new Dictionary<string, Basemap>()
        {
            {"Streets", new Basemap(BasemapStyle.ArcGISStreets)},
            {"Streets - Night", new Basemap(BasemapStyle.ArcGISStreetsNight)},
            {"Imagery", new Basemap(BasemapStyle.ArcGISImageryStandard)},
            {"Imagery with Labels", new Basemap(BasemapStyle.ArcGISImagery)},
            {"Dark Gray Canvas", new Basemap(BasemapStyle.ArcGISDarkGray)},
            {"Light Gray Canvas", new Basemap(BasemapStyle.ArcGISLightGray)},
            {"Navigation", new Basemap(BasemapStyle.ArcGISNavigation)},
            {"OpenStreetMap", new Basemap(BasemapStyle.OSMStandard)}
        };

        public ChangeBasemap()
        {
            InitializeComponent();

            // Setup the control references and execute initialization
            Initialize();
        }

        private void Initialize()
        {
            // Create new Map
            Map myMap = new Map();

            // Assign the map to the MapView
            MyMapView.Map = myMap;

            // Set titles as an items source and choose the first item
            BasemapChooser.ItemsSource = _basemapOptions.Keys;
            BasemapChooser.SelectedIndex = 0;
        }

        private void OnBasemapListSelectionChanged(object sender, SelectionChangedEventArgs e)
        {
            // Get the title of the selected basemap
            string selectedBasemapTitle = e.AddedItems[0].ToString();

            // Retrieve the basemap from the dictionary
            MyMapView.Map.Basemap = _basemapOptions[selectedBasemapTitle];
        }
    }
}
XAML
<UserControl
    x:Class="ArcGISRuntime.UWP.Samples.ChangeBasemap.ChangeBasemap"
    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>
                <TextBlock Text="Select a basemap"
                           FontWeight="SemiBold"
                           HorizontalAlignment="Center"
                           Margin="0,0,0,5"
                           TextWrapping="Wrap" />
                <ComboBox x:Name="BasemapChooser"
                          HorizontalAlignment="Stretch"
                          SelectionChanged="OnBasemapListSelectionChanged" />
            </StackPanel>
        </Border>
    </Grid>
</UserControl>
Examples

Xamarin Forms UWP

Example Name: DisplayMap

Display a map with an imagery basemap.

Code example screen shot.

C#
// Copyright 2016 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: http://www.apache.org/licenses/LICENSE-2.0
// 
// 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.Mapping;
using Xamarin.Forms;

namespace ArcGISRuntime.Samples.DisplayMap
{
    [ArcGISRuntime.Samples.Shared.Attributes.Sample(
        name: "Display map",
        category: "Map",
        description: "Display a map with an imagery basemap.",
        instructions: "Run the sample to view the map. Pan and zoom to navigate the map.",
        tags: new[] { "basemap", "map" })]
    public partial class DisplayMap : ContentPage
    {
        public DisplayMap()
        {
            InitializeComponent();

            // Create the UI, setup the control references and execute initialization 
            Initialize();
        }

        private void Initialize()
        {
            // Create new Map with basemap
            Map myMap = new Map(BasemapStyle.ArcGISImageryStandard);

            // Assign the map to the MapView
            MyMapView.Map = myMap;
        }
    }
}
XAML
<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"             
             xmlns:esriUI="clr-namespace:Esri.ArcGISRuntime.Xamarin.Forms;assembly=Esri.ArcGISRuntime.Xamarin.Forms"
             xmlns:mapping="clr-namespace:Esri.ArcGISRuntime.Mapping;assembly=Esri.ArcGISRuntime" 
             x:Class="ArcGISRuntime.Samples.DisplayMap.DisplayMap">
  <Grid>
    <esriUI:MapView x:Name="MyMapView"/>
  </Grid>
</ContentPage>
See Also
Additional Examples
Hyperlink to ExampleDescription
AccessLoadStatusDetermine the map's load status which can be: `NotLoaded`, `FailedToLoad`, `Loading`, `Loaded`.
AddAnIntegratedMeshLayerView an integrated mesh layer from a scene service.
AddEncExchangeSetDisplay nautical charts per the ENC specification.
AddFeaturesAdd features to a feature layer.
AddGraphicsRendererA renderer allows you to change the style of all graphics in a graphics overlay by referencing a single symbol style.
AddPointSceneLayerView a point scene layer from a scene service.
AnalyzeHotspotsUse a geoprocessing service and a set of features to identify statistically significant hot spots and cold spots.
Animate3DGraphicAn `OrbitGeoElementCameraController` follows a graphic while the graphic's position and rotation are animated.
ApplyMosaicRuleApply mosaic rule to a mosaic dataset of rasters.
BrowseWfsLayersBrowse a WFS service for layers and add them to the map.
BufferCreate a buffer around a map point and display the results as a `Graphic`
ChangeAtmosphereEffectChanges the appearance of the atmosphere in a scene.
ChangeBasemapChange a map's basemap. A basemap is beneath all layers on a `Map` and is used to provide visual reference for the operational layers.
ChangeEncDisplaySettingsConfigure the display of ENC content.
ChangeFeatureLayerRendererChange the appearance of a feature layer with a renderer.
ChangeStretchRendererUse a stretch renderer to enhance the visual contrast of raster data for analysis.
ChangeSublayerRendererApply a renderer to a sublayer.
ChangeTimeExtentFilter data in layers by applying a time extent to a MapView.
ChangeViewpointSet the map view to a new viewpoint.
ClipGeometryClip a geometry with another geometry.
ClosestFacilityFind a route to the closest facility from a location.
ClosestFacilityStaticFind routes from several locations to the respective closest facility.
ConvexHullCreate a convex hull for a given set of points. The convex hull is a polygon with shortest perimeter that encloses a set of points. As a visual analogy, consider a set of points as nails in a board. The convex hull of the points would be like a rubber band stretched around the outermost nails.
ConvexHullListGenerate convex hull polygon(s) from multiple input geometries.
CreateAndSaveKmlFileConstruct a KML document and save it as a KMZ file.
CreateFeatureCollectionLayerCreate a Feature Collection Layer from a Feature Collection Table, and add it to a map.
CreateGeometriesCreate simple geometry types.
CreateTerrainSurfaceRasterSet the terrain surface with elevation described by a raster file.
CreateTerrainSurfaceTilePackageSet the terrain surface with elevation described by a local tile package.
CustomDictionaryStyleUse a custom dictionary style (.stylx) to symbolize features using a variety of attribute values.
CutGeometryCut a geometry along a polyline.
DeleteFeaturesDelete features from an online feature service.
DensifyAndGeneralizeA multipart geometry can be densified by adding interpolated points at regular intervals. Generalizing multipart geometry simplifies it while preserving its general shape. Densifying a multipart geometry adds more vertices at regular intervals.
DictionaryRendererGraphicsOverlayThis sample demonstrates applying a dictionary renderer to graphics, in order to display military symbology without the need for a feature table.
DisplayDeviceLocationDisplay your current position on the map, as well as switch between different types of auto pan Modes.
DisplayGridDisplay coordinate system grids including Latitude/Longitude, MGRS, UTM and USNG on a map view. Also, toggle label visibility and change the color of grid lines and grid labels.
DisplayMapDisplay a map with an imagery basemap.
DisplaySceneDisplay a scene with a terrain surface and some imagery.
DisplaySubtypeFeatureLayerDisplays a composite layer of all the subtype values in a feature class.
DisplayUtilityAssociationsCreate graphics for utility associations in a utility network.
DisplayWfsDisplay a layer from a WFS service, requesting only features for the current extent.
DistanceMeasurementMeasure distances between two points in 3D.
EditBranchVersioningCreate, query and edit a specific server version using service geodatabase.
EditFeatureAttachmentsAdd, delete, and download attachments for features from a service.
EditFeatureLinkedAnnotationEdit feature attributes which are linked to annotation through an expression.
EditKmlGroundOverlayEdit the values of a KML ground overlay.
FeatureCollectionLayerFromPortalCreate a feature collection layer from a portal item.
FeatureCollectionLayerFromQueryCreate a feature collection layer to show a query result from a service feature table.
FeatureLayerDefinitionExpressionLimit the features displayed on a map with a definition expression.
FeatureLayerDictionaryRendererConvert features into graphics to show them with mil2525d symbols.
FeatureLayerGeodatabaseDisplay features from a local geodatabase.
FeatureLayerQueryFind features in a feature table which match an SQL query.
FeatureLayerSelectionSelect features in a feature layer.
FeatureLayerShapefileOpen a shapefile stored on the device and display it as a feature layer with default symbology.
FeatureLayerTimeOffsetDisplay a time-enabled feature layer with a time offset.
FeatureLayerUrlShow features from an online feature service.
FindAddressFind the location for an address.
FindPlaceFind places of interest near a location or within a specific area.
FindRouteDisplay directions for a route between two points.
FindServiceAreaFind the service area within a network from a given point.
FindServiceAreasForMultipleFacilitiesFind the service areas of several facilities from a feature service.
FormatCoordinatesFormat coordinates in a variety of common notations.
GeodatabaseTransactionsUse transactions to manage how changes are committed to a geodatabase.
GeodesicOperationsCalculate a geodesic path between two points and measure its distance.
GeoViewSyncKeep the view points of two views (e.g. MapView and SceneView) synchronized with each other.
GroupLayersGroup a collection of layers together and toggle their visibility as a group.
IdentifyGraphicsDisplay an alert message when a graphic is clicked.
IdentifyKmlFeaturesShow a callout with formatted content for a KML feature.
IdentifyLayersIdentify features in all layers in a map. MapView supports identifying features across multiple layers. Because some layer types have sublayers, the sample recursively counts results for sublayers within each layer.
LineOfSightLocationPerform a line of sight analysis between two points in real time.
ListTransformationsGet a list of suitable transformations for projecting a geometry between two spatial references with different horizontal datums.
ManageBookmarksAccess and create bookmarks on a map.
ManageOperationalLayersAdd, remove, and reorder operational layers in a map.
MapImageLayerTablesFind features in a spatial table related to features in a non-spatial table.
MapImageSublayerQueryFind features in a sublayer based on attributes and location.
MapRotationRotate a map.
NavigateRouteUse a routing service to navigate between points.
NavigateRouteReroutingNavigate between two points and dynamically recalculate an alternate route when the original route is unavailable.
NearestVertexFind the closest vertex and coordinate of a geometry to a point.
OpenStreetMapLayerAdd OpenStreetMap as a basemap layer.
PlayKmlToursPlay tours in KML files.
ProjectProject a point from one spatial reference to another.
QueryFeatureCountAndExtentZoom to features matching a query and count the features in the current visible extent.
RasterColormapRendererApply a colormap renderer to a raster.
RasterHillshadeUse a hillshade renderer on a raster.
RasterLayerFileCreate and use a raster layer made from a local raster file.
RasterLayerGeoPackageDisplay a raster contained in a GeoPackage.
RasterLayerImageServiceRasterCreate a raster layer from a raster image service.
RasterLayerRasterFunctionLoad a raster from a service, then apply a function to it.
RasterRenderingRuleDisplay a raster on a map and apply different rendering rules to that raster.
RasterRgbRendererApply an RGB renderer to a raster layer to enhance feature visibility.
ReadShapefileMetadataRead a shapefile and display its metadata.
RenderPictureMarkersUse pictures for markers.
RenderSimpleMarkersShow a simple marker symbol on a map.
RenderUniqueValuesRender features in a layer using a distinct symbol for each unique attribute value.
ReverseGeocodeUse an online service to find the address for a tapped point.
RouteAroundBarriersFind a route that reaches all stops without crossing any barriers.
SceneLayerSelectionIdentify features in a scene to select.
SceneLayerUrlDisplay an ArcGIS scene layer from a URL.
ScenePropertiesExpressionsUpdate the orientation of a graphic using expressions based on its attributes.
SceneSymbolsShow various kinds of 3D symbols in a scene.
SearchPortalMapsFind webmap portal items by using a search term.
SelectEncFeaturesSelect features in an ENC layer.
ServiceFeatureTableCacheDisplay a feature layer from a service using the **on interaction cache** feature request mode.
ServiceFeatureTableManualCacheDisplay a feature layer from a service using the **manual cache** feature request mode.
ServiceFeatureTableNoCacheDisplay a feature layer from a service using the **no cache** feature request mode.
SetInitialMapAreaDisplay the map at an initial viewpoint representing a bounding geometry.
SetMinMaxScaleRestrict zooming between specific scale ranges.
ShowCalloutShow a callout with the latitude and longitude of user-tapped points.
ShowLabelsOnLayerDisplay custom labels on a feature layer.
SimpleRenderersDisplay common symbols for all graphics in a graphics overlay with a renderer.
SketchOnMapUse the Sketch Editor to edit or sketch a new point, line, or polygon geometry on to a map.
SpatialRelationshipsDetermine spatial relationships between two geometries.
StatisticalQueryQuery a table to get aggregated statistics back for a specific field.
SurfacePlacementsPosition graphics relative to a surface using different surface placement modes.
SymbolizeShapefileDisplay a shapefile with custom symbology.
SymbolsFromMobileStyleCombine multiple symbols from a mobile style file into a single symbol.
TakeScreenshotTake a screenshot of the map.
TimeBasedQueryQuery data using a time extent.
UpdateAttributesUpdate feature attributes in an online feature service.
UpdateGeometriesUpdate a feature's location in an online feature service.
UseDistanceCompositeSymChange a graphic's symbol based on the camera's proximity to it.
ViewPointCloudDataOfflineDisplay local 3D point cloud data.
ViewshedCameraAnalyze the viewshed for a camera. A viewshed shows the visible and obstructed areas from an observer's vantage point.
ViewshedGeoElementAnalyze the viewshed for an object (GeoElement) in a scene.
ViewshedLocationPerform a viewshed analysis from a defined vantage point.
WfsXmlQueryLoad a WFS feature table using an XML query.
WmsIdentifyIdentify features in a WMS layer and display the associated popup content.
WMSLayerUrlDisplay a WMS layer using a WMS service URL.
WmsServiceCatalogConnect to a WMS service and show the available layers and sublayers.