Layers | ArcGIS Maps SDK for Qt

MapsA map is a collection of layers that are displayed in 2D. It is typically composed of a basemap layer and data layers.Learn more and scenesA scene is a collection of layers that are displayed in 3D. It is typically composed of a basemap layer, data layers, and 3D data.Learn more use a collection of layersA layer is a reference to a collection of geographic data that is used to access and display data. The data for layers are typically provided by the basemap layer service and data services.Learn more to display geographic data from a variety of sources and formats. These can include several 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 and 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 from online or local sources.

Each layerA layer is a reference to a collection of geographic data that is used to access and display data. The data for layers are typically provided by the basemap layer service and data services.Learn more in a map references geographic data, either from an online service or from a local dataset. There are a variety of layers that can be added to a map, each designed to display a particular type of data. Some layers display images, such as satellite photos or aerial photography, others are composed of a collection of featuresA feature is a single record, also known as a row, that represents a real-world entity. It typically contains a geometry (point, multipoint, polyline, or polygon) and attributes but it can also contain just attributes.Learn more to represent real-world entities using point, line, or polygon geometriesA geometry is a geometric shape, such as a point, polyline, or polygon, that contains one or more coordinates and a spatial reference.Learn more. In addition to geometry, features have attributesAttributes are fields and values for a single feature or non-spatial record. They are typically stored in a database or service such as a feature service.Learn more that provide details about the entity it represents.

Basemap layers

A basemap is the foundational layer and data that provides the overall visual and geographic context for a mapA map is a collection of layers that are displayed in 2D. It is typically composed of a basemap layer and data layers.Learn more or sceneA scene is a collection of layers that are displayed in 3D. It is typically composed of a basemap layer, data layers, and 3D data.Learn more. They enable your users to see where geographic features are located relative to other features and to visualize spatial relationships. A basemap typically includes features and labels for real-world topographic features such as land, water, roads, buildings, cities, places, and administrative boundaries, but may also include satellite and aerial image data. The content of a basemap is usually static and does not change frequently.

A basemap is composed of a collection of base layers and reference layersA reference layer is a layer of information in a map that provides context to a location, such as labels for place-names, transportation routes, or other features of reference. Typically a reference layer is part of a basemap.Learn more. Base layers are displayed at the bottom of a map or scene to display geographic context, and reference layers are displayed on top to provide labels and other reference data. Your operational data, or data layers, are displayed between the base layers and reference layers. You can create a basemap from your own data or choose from one of the many hosted basemap stylesThe 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.

The basemap styles 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 a number of vector tile and image tile basemap layers that are categorized by the type of data they support and the type of cartographic design they represent. This is known as the basemap style. In ArcGIS, there are two main families of basemap styles based on data provider type: ArcGIS Basemap stylesArcGIS Basemap styles are the family of basemap styles that use authoritative data from Esri and partners such as TomTom, Garmin, FAO, NOAA, USGS, OpenStreetMap contributors, and the GIS User Community.Learn more and Open Basemap stylesOpen Basemap styles are the family of basemap styles that use open source data from Overture Maps, which includes data from OpenStreetMap (OSM), Microsoft, Esri Community Maps, and other open data sources.Learn more. The list of available basemap styles is defined in an enumeration based on the data source and style name. For example, you can use a Navigation style to create an application that supports driving directions, or you can an Imagery style to create an application that displays a real-world view of the earth. You can also use Open Basemap stylesOpen Basemap styles are the family of basemap styles that use open source data from Overture Maps, which includes data from OpenStreetMap (OSM), Microsoft, Esri Community Maps, and other open data sources.Learn more to access vector basemaps, hosted by Esri, that use map data from the Overture Maps Foundation.

Add a vector tile basemap
Use dark colors for code blocksCopy
    // Set the ArcGIS runtime environment Api Key with your access token.
    ArcGISRuntimeEnvironment::setApiKey("YOUR_ACCESS_TOKEN");

    // Set the base map for for the map to be the basemap style of ArcGISNavigation.
    m_map = new Map(BasemapStyle::ArcGISNavigation, this);

    // Use any of the available BasemapStyle values like:
    // m_map = new Map(BasemapStyle::ArcGISHillshadeLight, this);
    // m_map = new Map(BasemapStyle::ArcGISHillshadeDark, this);
    // ... there are several others.

Add an image tile basemap
Use dark colors for code blocksCopy
    // Set the ArcGIS runtime environment Api Key with your access token.
    ArcGISRuntimeEnvironment::setApiKey("YOUR_ACCESS_TOKEN");

    // Set the base map for for the map to be the basemap style of ArcGISImagery.
    m_map = new Map(BasemapStyle::ArcGISImagery, this);

Data layers

A data layerA 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, also known as an operational layer, is a layerA layer is a reference to a collection of geographic data that is used to access and display data. The data for layers are typically provided by the basemap layer service and data services.Learn more that can access geographic data from a data sourceA data source is a service or file containing geographic data that is accessed by a data layer.Learn more. You use a data layer to display geographic data on top of a basemap layerA 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 in a mapA map is a collection of layers that are displayed in 2D. It is typically composed of a basemap layer and data layers.Learn more or sceneA scene is a collection of layers that are displayed in 3D. It is typically composed of a basemap layer, data layers, and 3D data.Learn more. The data source for the layer can be a data serviceData services, also known as hosted data services, are services created dynamically to store and provide access to your data in ArcGIS. Examples are feature services, vector tile services, map tile services, image services, and scene services.Learn more or a file such as a shapefileA shapefile is a vector data storage format that contains geometry and attribute data for geographic features. It can also include spatial and non-spatial indexes.Learn more or GeoPackageA geopackage is an OGC spatial data storage format that can contain multiple datasets of geographic features, non-spatial tabular data, and raster data.Learn more.

A data layerA 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 provides access to geographic data that is displayed in a map or scene. Each layer references a file or service data sourceA data source is a service or file containing geographic data that is accessed by a data layer.Learn more. The data source contains either as vector data (points, lines, polygons and attributes) or raster data (images). Different types of layers can access and display different types of data.

The data for a data layerA 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 is typically stored in ArcGIS as a data serviceData services, also known as hosted data services, are services created dynamically to store and provide access to your data in ArcGIS. Examples are feature services, vector tile services, map tile services, image services, and scene services.Learn more. You can use feature servicesA feature service is a data service that provides access to spatial and non-spatial data in feature layers, feature layer views, and tables.Learn more, map tile servicesA map tile service, formerly known as image tile service, is a data service that provides access to static, pre-rendered mao tiles. The tiles are typical in PNG format. Map tiles are typically retrieved by specifying a specific level, row, and column value.Learn more, and vector tile servicesA vector tile service is a data service that provides access to vector tile data and a style definition.Learn more to host your data. Learn more in Data hosting.

A data layer can also be created from a dataset stored on the deviceA device is nearly any kind of computer, including desktops, laptops, mobile phones, and tablets.Learn more. For example, data stored in a shapefileA shapefile is a vector data storage format that contains geometry and attribute data for geographic features. It can also include spatial and non-spatial indexes.Learn more, mobile map packageA mobile map package (MMPK) is a standalone file that contains one or more map definitions, including the basemap layers, data layers, layer styles, and pop-up styles for use in offline applications built with ArcGIS Maps SDKs for Native Apps.Learn more, or geodatabaseA geodatabase is a spatial data storage format that can contain multiple datasets of geographic features and non-spatial tabular data, as well as attachments, field domain definitions, and relationships between layers/tables.Learn more. Learn more about using offline data in Offline maps, scenes, and data.

To add a data layerA 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 to a map or scene, you typically add imagery or tile layers first, and then polygons, lines, and points layers last. A map or scene controls the order of the layers, and the map or scene view combines the layers to create the final display.

Add data layers to a map
Use dark colors for code blocksCopy
void Layers::loadMapLayers()
{
    // Set the access token.
    const QString accessToken = QStringLiteral("YOUR_ACCESS_TOKEN");

    // Set the ArcGIS runtime environment Api Key with your access token.
    ArcGISRuntimeEnvironment::setApiKey(accessToken);

    // Create a new "trail heads" feature layer based on a service feature table (using the Url provided).
    FeatureLayer* trailheadsLayer = new FeatureLayer(
        new ServiceFeatureTable(QUrl("https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trailheads_Styled/FeatureServer/0"), this),
        this
        );

    // Create a new "trails" feature layer based on a service feature table (using the Url provided).
    FeatureLayer* trailsLayer = new FeatureLayer(
        new ServiceFeatureTable(QUrl("https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Trails_Styled/FeatureServer/0"), this),
        this
        );

    // Create a new "open spaces" feature layer based on a service feature table (using the Url provided).
    FeatureLayer* openSpacesLayer = new FeatureLayer(
        new ServiceFeatureTable(QUrl("https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Parks_and_Open_Space_Styled/FeatureServer/0"), this),
        this
        );

    // Add the three feature layers to the map's operating layers list model collection.
    m_map->operationalLayers()->append(trailheadsLayer);
    m_map->operationalLayers()->append(trailsLayer);
    m_map->operationalLayers()->append(openSpacesLayer);
}