Add configurable site code labels to geographic map with toggle control and max labels limit based on anomaly score ranking

panel_app/kpi_health_check_panel.py

@@ -469,6 +469,9 @@ delta_table = pn.widgets.Tabulator(
     height=320, sizing_mode="stretch_width", layout="fit_data_table"
 )
 
+map_show_site_codes = pn.widgets.Checkbox(name="Show site codes", value=True)
+map_max_labels = pn.widgets.IntInput(name="Max labels", value=200, step=50)
+
 site_select = pn.widgets.AutocompleteInput(
     name="Select a site (Type to search)",
     options={},
@@ -707,6 +710,31 @@ def _build_map_fig(df_map: pd.DataFrame) -> go.Figure | None:
         hover_data=hover_cols,
         custom_data=["site_code"],
     )
+
+    try:
+        if bool(map_show_site_codes.value):
+            max_labels = int(_coerce_int(map_max_labels.value) or 0)
+            if max_labels <= 0:
+                tmp["_label"] = ""
+            elif len(tmp) <= max_labels:
+                tmp["_label"] = tmp["site_code"].astype(str)
+            else:
+                top_idx = (
+                    tmp.sort_values(by=["_score"], ascending=False)
+                    .head(max_labels)
+                    .index
+                )
+                tmp["_label"] = ""
+                tmp.loc[top_idx, "_label"] = tmp.loc[top_idx, "site_code"].astype(str)
+
+            fig.update_traces(
+                mode="markers+text",
+                text=tmp["_label"],
+                textposition="middle center",
+                textfont=dict(color="white", size=10),
+            )
+    except Exception:  # noqa: BLE001
+        pass
     fig.update_layout(
         mapbox_style="open-street-map",
         margin=dict(l=10, r=10, t=10, b=10),
@@ -3042,6 +3070,9 @@ kpi_compare_select.param.watch(_on_drilldown_change, "value")
 kpi_compare_norm.param.watch(_on_drilldown_change, "value")
 corr_window_select.param.watch(_on_drilldown_change, "value")
 
+map_show_site_codes.param.watch(lambda e: _refresh_map_view(), "value")
+map_max_labels.param.watch(lambda e: _refresh_map_view(), "value")
+
 analysis_range.param.watch(_on_drilldown_params_change, "value")
 baseline_days.param.watch(_on_drilldown_params_change, "value")
 recent_days.param.watch(_on_drilldown_params_change, "value")
@@ -3349,6 +3380,7 @@ _tab_delta = pn.Column(
 _tab_map = pn.Column(
     pn.pane.Markdown("## Map"),
     map_message,
+    pn.Row(map_show_site_codes, map_max_labels),
     pn.Column(map_pane, sizing_mode="stretch_both", min_height=700),
     sizing_mode="stretch_both",
 )