Skip to main content
All docs
V24.2

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TdxAzureMapTileset Enum

Enumerates tileset types available for Azure Maps services.

#Declaration

Delphi
TdxAzureMapTileset = (
    DarkGrey,
    HybridDarkGrey,
    HybridRoad,
    LabelsDarkGrey,
    LabelsRoad,
    Road,
    WeatherRadar,
    WeatherInfrared,
    TrafficAbsolute,
    TrafficRelative,
    Satellite,
    Terrain
);

#Members

Name Description Example
DarkGrey

A base tileset that displays all data layers (Dark Grey Style).

Microsoft Tileset ID
microsoft.base.darkgrey
Supported Zoom Levels
0 – 22

VCL Map Control: A Dark Grey Tileset Example

HybridDarkGrey

A base tileset that displays road, boundary, and label data (Dark Grey Style).

Microsoft Tileset ID
microsoft.base.hybrid
Supported Zoom Levels
0 – 22

VCL Map Control: A Hybrid Dark Grey Tileset Example

HybridRoad

A base tileset that displays road, boundary, and label data (Main Style).

Microsoft Tileset ID
microsoft.base.hybrid.road
Supported Zoom Levels
0 – 22

VCL Map Control: A Hybrid Road Tileset Example

LabelsDarkGrey

An auxiliary tileset that displays road label data (Dark Grey Style).

Microsoft Tileset ID
microsoft.base.labels.darkgrey
Supported Zoom Levels
0 – 22

VCL Map Control: A Labels Dark Grey Tileset Example

LabelsRoad

An auxiliary tileset that displays road label data (Main Style).

Microsoft Tileset ID
microsoft.base.labels.road
Supported Zoom Levels
0 – 22

VCL Map Control: A Labels Road Tileset Example

Road

Default. A base tileset that displays all data layers (Main Style).

Microsoft Tileset ID
microsoft.base.road
Supported Zoom Levels
0 – 22

VCL Map Control: A Road Tileset Example

WeatherRadar

An auxiliary tileset that displays weather radar data. Weather radar images include areas of rain, snow, ice, and mixed conditions.

Microsoft Tileset ID
microsoft.weather.radar.main
Supported Zoom Levels
0 – 15

Refer to the following topics for detailed information on weather radar data available for Azure Maps:

VCL Map Control: A Weather Radar Tiles Example

WeatherInfrared

An auxiliary tileset that displays infrared weather data. Infrared satellite images display clouds by their temperature.

Microsoft Tileset ID
microsoft.weather.infrared.main
Supported Zoom Levels
0 – 15

Refer to the following topics for detailed information on weather satellite data available for Azure Maps:

VCL Map Control: A Weather Infrared Tiles Example

TrafficAbsolute

An auxiliary tileset that displays absolute traffic data.

Microsoft Tileset ID
microsoft.traffic.absolute.main

VCL Map Control: A Traffic Absolute Tileset Example

TrafficRelative

An auxiliary tileset that displays relative traffic data.

Microsoft Tileset ID
microsoft.traffic.relative.main

VCL Map Control: A Traffic Relative Tileset Example

Satellite

A base tileset that displays a combination of satellite and aerial imagery.

Microsoft Tileset ID
microsoft.imagery
Supported Zoom Levels
0 – 19

VCL Map Control: A Satellite Tileset Example

Terrain

An auxiliary tileset that displays shaded relief and terrain layers.

Microsoft Tilset ID
microsoft.terra.main
Supported Zoom Levels
0 – 6

VCL Map Control: A Terrain Tileset Example

#Remarks

Azure Maps services allow you to download multiple types of information you can display on a map tile layer, such as terrain, weather, and roads. For example, you can display different information on multiple layers simultaneously.

The TdxAzureMapTileset type enumerates Azure Maps tilesets available for use in the Map Control. A tileset is a collection of square tiles at predefined zoom levels (from 0 to 22 for the majority of supported tilesets).

#Map Tileset Types

Base Tilesets
Display terrain details and may include additional information, such as roads, boundaries, and labels. You can use a base tileset as the only or underlying map image layer in your application.
Auxiliary Tilesets
Display additional information on a map, such as road, traffic, or weather data. You can display one or more auxiliary tilesets in individual layers on top of a base tileset displayed in an underlying map image layer.

Note

TdxAzureMapTileset is a scoped enumeration type. Use the type name together with a scope resolution token (. in Delphi or :: in C++Builder) followed by an enumeration value to refer to this value. For example, use TdxAzureMapTileset.Satellite (in Delphi) or TdxAzureMapTileset::Satellite (in C++Builder) to refer to the Satellite value in code.

#Code Example: Add a Tile Map Layer and Load Azure Maps Data

The following code example implements a procedure that accepts an Azure Maps account key, creates and configures a map tile layer, and loads data:

uses
  dxAzureMapImageryDataProvider;  // This unit declares TdxMapControlAzureMapImageryDataProvider
// ...

procedure TMyForm.AddAzureMapLayer(const AAzureKey: string);
var
  ATileLayer: TdxMapImageTileLayer;
  AProvider: TdxMapControlAzureMapImageryDataProvider;
begin
  ATileLayer := dxMapControl1.Layers.Add(TdxMapImageTileLayer) as TdxMapImageTileLayer;
  ATileLayer.ProviderClass := TdxMapControlAzureMapImageryDataProvider;
  AProvider := ATileLayer.Provider as TdxMapControlAzureMapImageryDataProvider;
  AProvider.BeginUpdate;  // Initiates the following batch change
  try
    AProvider.AzureKey := AAzureKey;  // Assigns the Azure account key
    AProvider.Tileset := TdxAzureMapTileset.Satellite;  // Changes the default tileset
    AProvider.MaxParallelConnectionCount := 8;  // Explicitly defines the number of parallel connections
  finally
    AProvider.EndUpdate;  // Calls EndUpdate regardless of the batch operation's success
  end;
end;

#Additional Information

Refer to the following topic for detailed information on Azure Maps tilesets: Get Map Tileset.

#Direct TdxAzureMapTileset Type Reference

The TdxMapControlAzureMapImageryDataProvider.Tileset property references the TdxAzureMapTileset type.

See Also