TdxMapControlAzureMapImageryDataProvider.Tileset Property
Specifies the active tileset type.
#Declaration
property Tileset: TdxAzureMapTileset read; write; default TdxAzureMapTileset.Road;
#Property Value
Type | Default | Description |
---|---|---|
Tdx |
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 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.
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:
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;
#Default Value
The Tileset
property’s default value is TdxAzureMapTileset.Road.