Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The Map (preview) in Microsoft Fabric offers a comprehensive set of options for customizing the map and display. By default, the map style is set to Grayscale Light, but you can easily change the map style, apply a data color theme, and toggle the visibility of various map elements. More customization options include adding interactive controls, setting the initial map view, and selecting a display language that best suits the needs of the map's audience.
Important
This feature is in preview.
Prerequisites
- A workspace with a Microsoft Fabric-enabled capacity
- A map with editing permissions and connected data sources, either geoJson files in lakehouse, or KQL querysets.
Change Map settings
The Map visual in Microsoft Fabric offers a comprehensive set of options for customizing the map and display. By default, the map style is set to Grayscale Light, but you can easily change the map style, apply a data color theme, and toggle the visibility of various map elements. More customization options include adding interactive controls such as zoom, scale, pitch, compass, and world wrap, setting the initial map view, and selecting a display language that best suits the needs of the map's audience.
The following screenshot displays a map using the "Road" style, centered around the state of Washington in the United States.
The following screenshot displays the same map as in the previous example, but with labels and administrative borders hidden. Additionally, all map controls—such as zoom, pitch, compass, and scale—are enabled.
The following table describes the available map settings and their corresponding properties.
| Section | Property | Description |
|---|---|---|
| Style | Map style | Supports the following built-in map styles:
Default = Grayscale (Light) |
| Data theme | Change color theme for geometry data such as points, lines, and polygons. Supports the following themes:
Default = Default |
|
| Background color | Configure background color when the map style is set to Blank or Blank (accessible). | |
| Initial map view | Latitude | The latitude coordinate defines the center point of your preferred map view. The value must be set between -90 and 90 degrees. |
| Longitude | The longitude coordinate defines the center point of your preferred map view. The value must be set between -180 and 180 degrees. | |
| Zoom level | The initial zoom level for the preferred map view should be set between 1 and 22. Default = 1 | |
| Pitch | Pitch controls the viewing angle of the map relative to the horizon. The value must be between 0 and 60 degrees. Default = 0 | |
| Compass | The compass setting allows users to rotate the map view, with values ranging from -180 to 180 degrees. Default = 0 | |
| Map elements | Labels | Toggle the visibility of map labels such as road names, city names, and country/region names. Default = on |
| Country/Region border | Toggle the visibility of Country/Region borders on the map. Default = on | |
| Administrative district border | Toggle visibility of borders for first-level administrative areas, such as states or provinces. Default = on | |
| Admin distric 2 border | Toggle visibility of borders for second-level administrative areas, such as counties. Default = on | |
| Road details | Toggle visibility of detailed street layouts in populated areas. Default = on | |
| Building footprints | Toggle visibility of building footprints at higher zoom levels. Default = on | |
| Controls | Zoom control | Toggle visibility of the zoom control on the map, enabling users to adjust the zoom level interactively. Default = off |
| Pitch control | Toggle visibility of the pitch control on the map, enabling users to adjust the viewing angle. Default = off | |
| Compass control | Toggle visibility of the compass control on the map, enabling users to adjust the rotation of map. Default = off | |
| Scale control | Toggle visibility of the scale bar on the map. Currently, only metric units are supported. Default = off | |
| World wrap | The world wrap control enables seamless horizontal panning across the globe. Default = on | |
| Localization | Display language | Set the language for map labels. By default, it follows the Fabric user's language setting. For more information on supported languages, see Localization support in Azure Maps |
Customize geometry data
Spatial data is typically represented as points, lines, or polygons. Map offers various visual effects to emphasize business-relevant patterns, relationships, and spatial distributions. The following sections detail how to configure properties for each visual effect type to enhance map readability and analytical value.
General settings
The following table describes the general settings for data layers.
| Setting | Description |
|---|---|
| Layer color | Defines the base color applied to this data layer. Note: If the "series group" option is enabled, individual series colors override the layer color setting. |
| Tooltips | Specifies which more data properties should be displayed when hovering over map geometries. These properties provide contextual information about the spatial features shown on the map. |
| Zoom level | Defines the range of zoom levels at which map geometries are visible. Note: This setting isn't supported when using PMTiles as the data source. |
Data label settings
When enabled, data labels display text derived from the chosen fields in your dataset, allowing each map point to show relevant information directly on the visual.
The following examples illustrate data labels on maps with various geometries including point, line and polygon.
This example uses point geometry to display public schools, with data labels indicating school names:
This example uses line geometry to display National Forest System trails, with data labels indicating trail name:
This example uses polygons that represent areas previously affected by forest fires in California, with each polygon labeled using the official fire name:
The following table describes the general settings for data labels.
| Setting | Description |
|---|---|
| Enable data labels | A toggle switch used to enable/disable data labels for the selected layer. |
| Data labels | A drop-down list showing available fields from the selected data source. |
| Text color | The text color of the data label. The available color choices depend on the selected data theme. For more information, see Change Map settings. |
| Text size | The text size of the data label. Valid text sizes range from 8-48. Default=12. |
| Text stroke color | The text stroke color of the data label. The available color choices depend on the selected data theme. For more information, see Change Map settings. |
| Text stroke width | The text stroke width of the data label. Valid text sizes range from 0-10. Default=1. |
Point settings
Bubble layer
A bubble visual displays individual data points as circles on a geographic map. Each bubble's size, color, and opacity can be customized to represent attributes such as magnitude, category, or intensity. This visualization is ideal for highlighting differences across locations, helping users compare values and spot patterns or outliers in spatial datasets. Bubble layers are especially useful for mapping quantitative data like population, sales volume, or event frequency.
The following screenshot shows EV charging station locations across Washington State. A bubble layer is used to represent the data, which consists of point features. Each station is visualized as a bubble, with size and opacity customized to reflect station-specific attributes.
The following table outlines the available bubble visual settings along with their descriptions.
| Setting | Description |
|---|---|
| Opacity | Controls the opacity of point features on the map. Valid range: 0% (fully transparent) to 100% (fully opaque). |
| Stroke width | The numeric value that determines how thick the border of each bubble appears on the map, measured in pixels. Valid values: 0-10. |
| Stroke color | Specifies the color used for the border of each bubble. This helps distinguish bubbles from the map background and can be used to emphasize or categorize data points. |
| Enable series group | Toggle to use color to group and differentiate geometries based on the selected data property. Default: off Note: If enabled, the Layer color defined in General settings aren't applied. |
| Series group | Select a data property from this drop-down list to group and color-code bubble features. This option is only accessible when the Enable series group setting is active. |
| Size | Configure how bubble sizes are displayed on the map:
|
| Enable clustering | Groups nearby data points into clusters to reduce visual clutter and improve map readability. Default = off |
| Cluster size | Configure size of clustered bubble, Support fixed value, users can configure clustered bubble size from 1px to 50px. Default = 16px |
| Aggregate by | The "Aggregate by" property allows users to select a numeric data field from a dropdown list to group and categorize bubble data. This feature is only applicable when working with numeric properties and is typically used to summarize or visualize aggregated values across spatial features. |
| Aggregation | Select a method for summarizing data based on the chosen numeric property. Available options include:
|
Enable series group
The following screenshot displays electric vehicle (EV) charging stations in Washington State, United States, categorized by access hours. Users can easily identify stations that operate 24 hours a day.
Enable clustering
The following screenshot displays taxi pick-up location statistics in New York City. Enabling clustering based on the average trip distance can provide aggregated insights into which areas typically generate longer trips.
When using the zoom control to zoom in, more granular clustering visuals appear.
Heat map layer
Heat maps, or point density maps, use color gradients to visualize where data points are most concentrated. They highlight high-density areas ("hot spots") and make spatial patterns easier to detect. This method is especially effective for large datasets, converting raw data into a smooth, continuous surface that reveals both absolute and relative densities across geographic regions.
The following table describes the available heat map visual settings.
| Setting | Description |
|---|---|
| Color gradient | The color theme for displaying hot spots of the data |
| Opacity | The opacity of heat map visual. Valid values range from 1% to 100%. Default = 100% |
| Intensity | Adjusts the multiplier applied to each data point's weight to control heatmap intensity. Valid values range from 1% to 100%. Default = 1% |
| Radius | Specifies the pixel radius used to render each data point in the heat map layer. This determines how far the influence of each point spreads visually. Valid values range from 1 to 100. Default = 30 |
| Weight | Set the weight of each point using a numeric data property. Default = 1 |
| Enable clustering | Groups nearby data points into clusters to reduce visual clutter and improve map readability. Default = off |
Apply weight
The following screenshot illustrates a taxi trip heat map of New York City. Each trip is represented as a data point, with the fare_amount used as a weight, meaning areas with higher fares contribute more intensity to the heat map. To enhance readability, lower opacity is applied, allowing the map and overlapping data to remain visible.
Enable clustering
The following screenshot illustrates a clustered heat map that visualizes spatial data density. By fine-tuning parameters such as radius and intensity, the map more effectively reveals patterns that are obscured by overlapping data points.
Line settings
Line layer
Line layers are used to visualize linear geographic features such as roads, paths, routes, or boundaries on a map. It connects a series of coordinates to form lines, which can be styled with various attributes like color, stroke width. This type of visual is especially useful for representing movement, direction, or connections between locations, and is commonly applied in scenarios like route planning, infrastructure mapping, or network visualization.
The following screenshot shows national forest trails near Mount Rainier.
The following table describes the available line visual setting and description.
| Setting | Description |
|---|---|
| Stroke opacity | The opacity of line features. Valid values range from 1% to 100%. Default = 100% |
| Stroke width | The width of lines measured in pixels. Valid values: 0-10. Default = 3px |
| Enable series group | Toggle to use color to group and differentiate geometries based on the selected data property. Default: off Note: If enabled, the Layer color defined in General settings aren't applied. |
| Series group | Select a data property from this drop-down list to group and color-code lines. This option is only accessible when the Enable series group setting is active. |
Enable series group
The following screenshot shows national forest trail data near by Mount Rainier. Enable series group and use data property ATV_RESTRICTED to identify trails that restricts ATVs (All-Terrain Vehicle).
Polygon settings
Polygon layer
Polygon layers are used to visualize areas or regions by connecting multiple geographic coordinates to form enclosed shapes. These polygons can represent boundaries such as city limits, zones, or regions of interest. You can customize the appearance of these shapes using attributes like layer color, and opacity. This visual is useful for highlighting specific geographic areas and analyzing spatial relationships or coverage.
The following screenshot displays a historical fire perimeters map of California, showing the geographic extent of past wildfires using red polygons. Each polygon represents a distinct fire event and includes metadata such as the year, cause, and GIS-calculated acreage. This visualization enables users to quickly identify fire-prone areas, analyze historical fire patterns, and support wildfire mitigation and land management planning.
The following table describes the available polygon visual setting and description.
| Setting | Description |
|---|---|
| Fill opacity | The opacity of polygon features on the map. Valid range: 0% (fully transparent) to 100% (fully opaque). Default = 60% |
| Enable series group | Toggle to use color to group and differentiate geometries based on the selected data property. Default: off Note: If enabled, the Layer color defined in General settings aren't applied. |
| Series group | Select a data property from this drop-down list to group and color-code lines. This option is only accessible when the Enable series group setting is active. |
| Enable extrusion | This property allows polygons to be rendered in 3D by applying height based on a numeric field. It enhances spatial visualization by adding depth and volume to flat shapes. Default = off. |
| Height | Specifies the numeric data field used to determine the vertical extrusion of each polygon. This option is only accessible when the Enable extrusion setting is active. |
Enable series group
The following screenshot displays a thematic map of California highlighting historic fire perimeters using the polygon visual. Each fire-affected area is color-coded according to the DECADES field, enabling viewers to distinguish wildfire events by time periods such as 1960–1969, 1970–1979, and beyond.
Enable extrusion
The following screenshot presents a 3D map visualization of the Seattle area, showcasing building extrusion. Each building is rendered with varying heights based on its actual elevation data, creating a realistic urban landscape.
