Skip to content

Commit b7c9bcf

Browse files
971613: Added more details about map zoom factor and use case of cluster grouping.
1 parent 6914f6b commit b7c9bcf

File tree

2 files changed

+23
-1
lines changed

2 files changed

+23
-1
lines changed

blazor/maps/markers.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -696,6 +696,19 @@ Marker clustering can be enabled for each marker group in the map by using the [
696696

697697
N> When the `MapsMarkerClusterSettings` tag is enabled for a specific marker group, the `MapsMarkerClusterSettings` tag within the layers becomes ineffective.
698698

699+
**Detailed Use Case scenario:**
700+
701+
* **Context**: In the below example, have three marker groups—France, India, and the USA. Each country contains many locations spread across different states. Displaying every location marker at the world level makes the map cluttered and hard to read.
702+
703+
* **What clustering does**:
704+
At a world zoom level, all nearby markers within each country’s group are clustered into a single symbol per group (e.g., one cluster for France, one for India, one for the USA). The cluster icon can display the count of locations it represents.
705+
As the user zooms in on a country, the single country‑level cluster splits into smaller clusters (or individual markers) based on proximity. For example, France’s cluster breaks into clusters around Paris and Normandy, and further zooming reveals the Eiffel Tower, Louvre, and Notre‑Dame markers individually.
706+
The same behavior applies to India (e.g., clusters for Rajasthan, Uttar Pradesh, etc.) and the USA (e.g., clusters for Arizona, Nevada, Tennessee, and so on).
707+
* **Manual expansion**:
708+
If [AllowClusterExpand](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Maps.MapsMarkerClusterSettings.html#Syncfusion_Blazor_Maps_MapsMarkerClusterSettings_AllowClusterExpand) property is set to **true**, a user can click a cluster to expand it immediately and view its child markers without additional zooming. This is useful on touch devices or when you want quick access to the underlying points.
709+
* **Per‑group customization**:
710+
Each marker group (France/India/USA) can have its own `MapsMarkerClusterSettings`—different cluster icons, colors, sizes, and label styles—so clusters are visually distinct by group.
711+
699712
```cshtml
700713
@using Syncfusion.Blazor.Maps
701714

blazor/maps/user-interactions.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,16 @@ documentation: ug
1111

1212
## Zooming
1313

14-
The zooming feature is used to zoom in and out of Maps to show in-depth information. It is controlled by the [ZoomFactor](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Maps.MapsZoomSettings.html#Syncfusion_Blazor_Maps_MapsZoomSettings_ZoomFactor) property of the [MapsZoomSettings](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Maps.MapsZoomSettings.html) class. The [ZoomFactor](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Maps.MapsZoomSettings.html#Syncfusion_Blazor_Maps_MapsZoomSettings_ZoomFactor) is increased or decreased dynamically based on zoom in and out interaction.
14+
The zooming feature is used to zoom in and out of Maps to show in-depth information. It is controlled by the [ZoomFactor](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Maps.MapsZoomSettings.html#Syncfusion_Blazor_Maps_MapsZoomSettings_ZoomFactor) property of the [MapsZoomSettings](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Maps.MapsZoomSettings.html) class. The [ZoomFactor](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Maps.MapsZoomSettings.html#Syncfusion_Blazor_Maps_MapsZoomSettings_ZoomFactor) is increased or decreased dynamically based on zoom in and out interaction. [ZoomFactor](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Maps.MapsZoomSettings.html#Syncfusion_Blazor_Maps_MapsZoomSettings_ZoomFactor) is linear. It represents a magnification multiplier relative to the initial “fit to viewport” view. Increasing the value linearly magnifies the map; decreasing it zooms out. Fractional values are allowed.
15+
16+
**How the map renders at the default:**
17+
18+
By default, [ZoomFactor](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Maps.MapsZoomSettings.html#Syncfusion_Blazor_Maps_MapsZoomSettings_ZoomFactor) is 1. The map automatically fits the layer’s bounds into the available map area. You see the whole world or the whole shape layer centered and sized to the component.
19+
20+
**What happens when you change ZoomFactor:**
21+
22+
* **Zoom in**: Increasing ZoomFactor enlarges the content around the current center. Example: going from 1 to 2 approximately doubles the scale.
23+
* **Zoom out**: Decreasing ZoomFactor reduces the scale, showing a larger area.
1524

1625
<b>Enable zooming</b>
1726

0 commit comments

Comments
 (0)