You can use one or more basemap layersA basemap layer is the layer in a map or scene that displays basemap data. The data source for a basemap layer is typically a basemap service. Learn more to provide visual and geographic context for the data layersA data layer is a layer that references geographic data from a file or a service and is used to visualize the data in a map or scene. Learn more displayed.

Basemap layer types

There are two fundamental types of basemap layers: vector tile and image tile. There are many vector tile styles available, such as streets and streets night, gray canvas, navigation, and topographic. Image tiles include satellite imagery, ocean, hillshade, and others.

Vector tile layersA vector tile layer is a data layer used to access and display tiled data and its corresponding styles. Learn more contain a vector representation of the data and a separate visual style. Tile access performance combined means vector tile layers can adapt to any display resolution across device types.

In addition to the default vector basemap styles, you can create custom vector basemap stylesA basemap style is a definition that controls the visual appearance of how geographic data in a basemap are displayed. It includes colors, backgrounds, outlines, labels, and other visual elements. Each basemap style emphasizes a specific type of cartographic theme and data. Learn more with the ArcGIS Vector Tile Style EditorThe ArcGIS Vector Tile Style Editor is a web-based application used to create, edit, and save a custom style for vector tile basemap layer. Learn more .

Image tile layersAn image tile layer is a data layer that can access and display raster tile data provided by an image layer service. Learn more display pre-rendered image or raster data stored as tiles of .png or .jpeg images that can be displayed at different scales.

For a complete list of styles, see the Custom basemap styles topic in the Mapping and location services guide.

Basemaps

Basemap layers are organized as a basemapA basemap is the foundational layer and data that provides the overall visual and geographic context for a map or scene. It typically includes geographic features and labels for land, water, roads, buildings, cities, places, and administrative boundaries, but can also include raster data such as satellite and areal images. Learn more and you use the Basemap property of the ArcGIS Map to control the basemap in your scene.

The following are the source and source types to create a Basemap to use in your ArcGIS Map.

Source

Source type

Basemap layer

Basemap

Web map

Basemap

Image tile layer

Image layer

Vector tile layer

Vector tile layer

Basemaps from the basemap layer service

The basemap layer serviceThe ArcGIS Basemap Styles service, also referred to as the Basemap Styles service, is a location service that provides basemap styles and data for the world. It returns styles as Mapbox styles and web maps, and data as vector tiles and/or map tiles. It supports all of the styles in the ArcGIS Basemap style and Open Basemap style family. An ArcGIS Location Platform or ArcGIS Online account is required to use the service. Learn more provides vector tile and image tile global basemap layers in a variety of styles to use in mapping applications.

There are two ways to access basemap layers: through the basemap styles service or the tile services. You can access the basemap styles service with a URL and parameters to get the JSON definition for a specific basemap style. To see a complete list of styles, visit the Basemap styles service (v2) in the ArcGIS REST APIs documentation.

With the plugin, you can use the standard endpoint formatted as follows.

  • For the basemap styles service (v2):

    https://basemapstyles-api.arcgis.com/arcgis/rest/services/styles/v2/webmaps/{data_source}/{style}

    For information about tile services, see the image tile layers and vector tile layers sections.

    Basemaps from web maps

    As mentioned previously, you can create a basemap from a URL that references a web mapA web map is a map stored as a JSON object that defines properties such as the basemap layer, data layers, layer styles, and pop-up styles. Its JSON structure is defined by the web map specification. Learn more by providing the item page URL or the JSON, typically read from an itemAn item, also known as a content item, is a resource stored in a portal such as a web map, hosted layer, style, script tool, file, or notebook. Learn more with type Web Map which is stored in an ArcGIS PortalArcGIS portal, also known as a portal, is a website with applications and tools that can be used to create, manage, access, and share geospatial content and data. It supports security and authentication, developer credentials, content and data service management, user and group management, and site administration. A portal can be hosted in Esri's infrastructure or your own infrastructure. Learn more .

    You can load any web map that contains image tile layers, vector tile layers, or reference layers as a basemap. It is possible to use web maps that contain other layer types, but they will not be displayed in the viewport.

    The SDK provides several preset basemaps from the Map Creator UI. These also use the basemap layer service with the web map format.

    There are two ways to format the URL to create a basemap from a web map:

    • Item page URL
    • REST endpoint URL

    Set a basemap

    In the Basemap panel is a list of selectable, preset basemaps. You can also set a basemap from a basemap layer service, a web map, an image tile layer, a vector tile layer, or a local tile package.

    If you do not want to set a basemap, click the ArcGIS Map Actor in the Outliner panel and empty the Basemap field in the Details panel.

    The preset basemaps are listed in the World Basemaps for Developers group in ArcGIS OnlineArcGIS Online is a GIS mapping, analytics, data hosting, and content management software as a service (SaaS) product. It includes applications, tools, APIs, and location services for users and developers. It is subscription-based and requires an ArcGIS Online account. Learn more . Preset basemaps do not include Human Geography Map and Human Geography Dark Map.

    To set a custom basemap:

    1. Click the Basemap tab.

    2. Click + Add New at the bottom of the list. A pop-up window opens.

    3. In the Source field, enter a service URL or a local file path.

      • To use a basemap layer service or a web map, select Basemap from the Type drop-down list.
      • To use an image tile layer service, select Image Layer from the Type drop-down list.
      • To use a .tpk or .tpkx tile package as a basemap source, copy and paste the local tile package file path, then select Image Layer from the Type drop-down list.
      • To use a vector tile layer service, select Vector Tile Layer from the Type drop-down list.
      • To use a .vtpk file package as a basemap source, copy and paste the local vector tile package file path, then select Vector Tile Layer from the Type drop-down list.
      • To use a privately hosted web map or services, select the matching configuration from the Authentication drop-down list. For more information about using private content, see user authentication.
    4. Type a Name for your basemap; this will be used to identify it in the basemap gallery.

    5. Click Add to finish creating the custom basemap. The pop-up window closes.

    6. Verify that the custom basemap is selected in the gallery.

    To remove a custom basemap registry from the basemap gallery, click on X on the thumbnail.

    Refer to the FAQ to troubleshoot data loading issues.