TdxMapControlAzureMapImageryDataProvider.Tileset Property

Specifies the active tileset type.

Declaration

delphi

property Tileset: TdxAzureMapTileset read; write; default TdxAzureMapTileset.Road;

Property Value

Type	Default	Description
TdxAzureMapTileset	Road

The active tileset type requested from Azure Map servers.

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.

A tileset is a collection of square tiles rendered at predefined zoom levels (from 0 to 22 for the majority of supported tilesets). Use the Tileset property to switch between tilesets displayed on the current map tile layer.

Map Tileset Types

Base TilesetsDisplay 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 TilesetsDisplay 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.

Refer to the TdxAzureMapTileset type description for detailed information on all available options.

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
C++

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;

cpp

#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
  }
}

Default Value

The Tileset property’s default value is TdxAzureMapTileset.Road.