TdxAzureMapTileset Enum

Enumerates tileset types available for Azure Maps services.

Declaration

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
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
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
LabelsDarkGrey	An auxiliary tileset that displays road label data (Dark Grey Style). Microsoft Tileset ID microsoft.base.labels.darkgrey Supported Zoom Levels 0 – 22
LabelsRoad	An auxiliary tileset that displays road label data (Main Style). Microsoft Tileset ID microsoft.base.labels.road Supported Zoom Levels 0 – 22
Road	Default. A base tileset that displays all data layers (Main Style). Microsoft Tileset ID microsoft.base.road Supported Zoom Levels 0 – 22
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: Azure Maps Weather Services Coverage Weather Services in Azure Maps
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: Azure Maps Weather Services Coverage Weather Services in Azure Maps
TrafficAbsolute	An auxiliary tileset that displays absolute traffic data. Microsoft Tileset ID microsoft.traffic.absolute.main
TrafficRelative	An auxiliary tileset that displays relative traffic data. Microsoft Tileset ID microsoft.traffic.relative.main
Satellite	A base tileset that displays a combination of satellite and aerial imagery. Microsoft Tileset ID microsoft.imagery Supported Zoom Levels 0 – 19
Terrain	An auxiliary tileset that displays shaded relief and terrain layers. Microsoft Tilset ID microsoft.terra.main Supported Zoom Levels 0 – 6

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:

Delphi

uses
  dxAzureMapImageryDataProvider;  // 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;

C++

#include "dxAzureMapImageryDataProvider.hpp"  // Declares TdxMapControlAzureMapImageryDataProvider
// ...

void __fastcall TMyForm::AddAzureMapLayer(const UnicodeString &AAzureKey)
{
  TdxMapLayer *ALayer;
  TdxMapImageTileLayer *ATileLayer;
  TdxMapControlAzureMapImageryDataProvider *AProvider;

  ALayer = dxMapControl1->Layers->Add(__classid(TdxMapImageTileLayer));
  ATileLayer = dynamic_cast<TdxMapImageTileLayer*>(ALayer);
  ATileLayer->ProviderClass = __classid(TdxMapControlAzureMapImageryDataProvider);
  AProvider = dynamic_cast<TdxMapControlAzureMapImageryDataProvider*>(ATileLayer->Provider);
  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
  }
}

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.