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 |
---|---|---|
Dark
|
A base tileset that displays all data layers (Dark Grey Style).
|
|
Hybrid
|
A base tileset that displays road, boundary, and label data (Dark Grey Style).
|
|
Hybrid
|
A base tileset that displays road, boundary, and label data (Main Style).
|
|
Labels
|
An auxiliary tileset that displays road label data (Dark Grey Style).
|
|
Labels
|
An auxiliary tileset that displays road label data (Main Style).
|
|
Road
|
Default. A base tileset that displays all data layers (Main Style).
|
|
Weather
|
An auxiliary tileset that displays weather radar data. Weather radar images include areas of rain, snow, ice, and mixed conditions.
Refer to the following topics for detailed information on weather radar data available for Azure Maps: |
|
Weather
|
An auxiliary tileset that displays infrared weather data. Infrared satellite images display clouds by their temperature.
Refer to the following topics for detailed information on weather satellite data available for Azure Maps: |
|
Traffic
|
An auxiliary tileset that displays absolute traffic data.
|
|
Traffic
|
An auxiliary tileset that displays relative traffic data.
|
|
Satellite
|
A base tileset that displays a combination of satellite and aerial imagery.
|
|
Terrain
|
An auxiliary tileset that displays shaded relief and terrain layers.
|
#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
Tdx
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 Tdx
(in Delphi) or Tdx
(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.