Map UX: layer naming, honest gmaps links, tooltip labels + border

- Legend renamed Tier->Layer; the two network entries are now
  distinguishable: 'Layer 2 - Network sites (towers & antennas)'
  (points) vs 'Layer 2 - Network paths (routes)' (arcs)
- Google Maps links are precision-aware: coordinate deep link only for
  exact/approximate pins; name+city text search for city_level pins
  (their coords are centroids, not the site); none for symbolic pins
- Tooltips show human labels (Site, Operator / venue, Power (MW),
  Pin precision, Source URL...) instead of raw column names; NaN
  values cleaned; popover gets a border
- Flobecq (T2-013) precision upgraded to exact: user report of
  'a farm' checked — OSM surveyed node 3646963462 ('Ancien station de
  relais US/OTAN') sits 7m from the pin; the tower stands in open
  fields on the Pottelberg ridge, pin is correct

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: whiteskylondon

build_map.py

@@ -15,6 +15,7 @@
 
 import argparse
 import re
+import urllib.parse
 from pathlib import Path
 
 import pandas as pd
@@ -40,6 +41,10 @@
 FULLSCREEN_SNIPPET = """<style>
   html, body { width: 100%; height: 100%; }
   .keplergl-widget-container { width: 100vw !important; height: 100vh !important; }
+  .map-popover {
+    border: 1px solid rgba(255, 255, 255, 0.28) !important;
+    border-radius: 6px !important;
+  }
 </style>
 <script>
   window.addEventListener('load', function () {
@@ -49,9 +54,34 @@
 """
 
 TIER_LABELS = {
-    "execution": "Tier 1 — Execution (exchange colo)",
-    "network": "Tier 2 — Network (microwave/shortwave)",
-    "research": "Tier 3 — Research (ML compute)",
+    "execution": "Layer 1 — Execution (exchange colo)",
+    "network": "Layer 2 — Network sites (towers & antennas)",
+    "research": "Layer 3 — Research (ML compute)",
+}
+
+# Column names -> human labels shown in the kepler tooltip (kepler displays
+# raw column names, so the display DataFrames are renamed before add_data).
+SITE_DISPLAY = {
+    "site_name": "Site",
+    "operator_or_venue": "Operator / venue",
+    "firms_linked": "Firms linked",
+    "capacity_note": "Notes",
+    "power_mw": "Power (MW)",
+    "status": "Status",
+    "coord_precision": "Pin precision",
+    "confidence": "Confidence",
+    "evidence_note": "Evidence",
+    "evidence_url": "Source URL",
+    "gmaps_url": "Google Maps",
+}
+PATH_DISPLAY = {
+    "route": "Route",
+    "operator": "Operator",
+    "medium": "Medium",
+    "status": "Status",
+    "confidence": "Confidence",
+    "evidence_note": "Evidence",
+    "evidence_url": "Source URL",
 }
 
 # Hex colors per tier, referenced in the kepler config below.
@@ -61,8 +91,8 @@
     "research": [70, 130, 240],   # blue — the compute layer
 }
 
-PATHS_LABEL = "Tier 2 — Paths (arcs)"
-PATHS_COLOR = [250, 190, 60]      # amber, matching the network tier
+PATHS_LABEL = "Layer 2 — Network paths (routes)"
+PATHS_COLOR = [250, 190, 60]      # amber, matching the network layer
 
 
 def load_sites(csv_path: Path) -> pd.DataFrame:
@@ -73,21 +103,31 @@ def load_sites(csv_path: Path) -> pd.DataFrame:
     if missing:
         raise ValueError(f"CSV missing required columns: {missing}")
 
-    # Google Maps deep link per pin — the "zoom in for detail" handoff.
-    df["gmaps_url"] = (
-        "https://www.google.com/maps/search/?api=1&query="
-        + df["lat"].round(6).astype(str)
-        + ","
-        + df["lon"].round(6).astype(str)
-    )
+    # Google Maps handoff, honest about pin precision: coordinate deep link
+    # only where the pin is placed (exact/approximate); a name+city text
+    # search for city-level pins (the coords are a centroid, not the site);
+    # nothing for symbolic pins (they mark a firm, not a place).
+    def gmaps(row):
+        if row.coord_precision in ("exact", "approximate"):
+            return ("https://www.google.com/maps/search/?api=1&query="
+                    f"{row.lat:.6f},{row.lon:.6f}")
+        if row.coord_precision == "city_level":
+            q = urllib.parse.quote_plus(f"{row.site_name} {row.city}")
+            return f"https://www.google.com/maps/search/?api=1&query={q}"
+        return ""
+
+    df["gmaps_url"] = df.apply(gmaps, axis=1)
     df["tier_label"] = df["tier"].map(TIER_LABELS).fillna(df["tier"])
 
     # Fail loudly on bad coordinates rather than silently dropping pins.
     bad = df[(df["lat"].abs() > 90) | (df["lon"].abs() > 180) | df["lat"].isna()]
     if not bad.empty:
         raise ValueError(f"Bad coordinates for: {bad['site_id'].tolist()}")
 
-    return df
+    # Tooltip hygiene: no NaN in display fields, no trailing ".0" on power.
+    df["power_mw"] = df["power_mw"].map(
+        lambda v: "" if pd.isna(v) else f"{v:g}")
+    return df.fillna("")
 
 
 def load_paths(paths_csv: Path, sites: pd.DataFrame) -> pd.DataFrame | None:
@@ -162,26 +202,8 @@ def kepler_config(df: pd.DataFrame, with_paths: bool = False) -> dict:
             }
         )
 
-    tooltip_fields = [
-        {"name": f}
-        for f in [
-            "site_name",
-            "operator_or_venue",
-            "firms_linked",
-            "capacity_note",
-            "power_mw",
-            "status",
-            "confidence",
-            "evidence_note",
-            "evidence_url",
-            "gmaps_url",
-        ]
-    ]
-    paths_tooltip = [
-        {"name": f}
-        for f in ["route", "operator", "medium", "status", "confidence",
-                  "evidence_note", "evidence_url"]
-    ]
+    tooltip_fields = [{"name": label} for label in SITE_DISPLAY.values()]
+    paths_tooltip = [{"name": label} for label in PATH_DISPLAY.values()]
     fields_to_show = {t: tooltip_fields for t in TIER_COLORS}
     if with_paths:
         fields_to_show["paths"] = paths_tooltip
@@ -220,9 +242,10 @@ def build(csv_path: Path, out_path: Path, paths_csv: Path | None = None) -> None
     for tier in TIER_COLORS:
         subset = df[df["tier"] == tier].reset_index(drop=True)
         if not subset.empty:
-            m.add_data(data=subset, name=tier)
+            m.add_data(data=subset.rename(columns=SITE_DISPLAY), name=tier)
     if paths is not None:
-        m.add_data(data=paths, name="paths")
+        m.add_data(data=paths.fillna("").rename(columns=PATH_DISPLAY),
+                   name="paths")
 
     m.save_to_html(file_name=str(out_path), read_only=False)
 

data/sites_seed.csv

@@ -41,7 +41,7 @@ T2-009,Tour de Reuze (Dunkerque),network,"Rooftop antenna site on Tour de Reuze
 T2-010,Dunkerque port grain elevator (FR),network,"Grain elevator, Port of Dunkerque",McKay Brothers,51.03,2.34,city_level,Dunkerque,France,"McKay Brothers dishes on a port grain elevator for the Channel crossing, documented 2016. Current tenancy unverified.",,active,press,Sniper in Mahwah (2016): McKay Brothers dishes on a Dunkerque port grain elevator; exact silo not identified — city-level pin,https://sniperinmahwah.wordpress.com/2016/01/26/hft-in-the-banana-land/,reported,
 T2-011,Oostduinkerke rooftop relay (BE),network,"±40-meter residential building, Oostduinkerke",Vigilant Global (DRW),51.114,2.674,city_level,Oostduinkerke (Koksijde),Belgium,"Belgian end of Vigilant's PROPOSED direct Channel crossing toward Richborough (Ofcom path data, licenses April 2015). The UK-side 322m mast was refused in January 2017, so the crossing as proposed was never completed.",,historical,press,"Sniper in Mahwah (2016): Belgian end of Vigilant's proposed direct crossing to Richborough (Ofcom path data, Apr 2015 licenses); UK mast refused — historical",https://sniperinmahwah.wordpress.com/2016/01/26/hft-in-the-banana-land/,reported,
 T2-012,"Ramsgate relay cluster (Kent, UK)",network,Multiple masts/structures around Ramsgate (per planning applications),Optiver; Jump Trading; McKay Brothers,51.333,1.416,city_level,Ramsgate,United Kingdom,"Preferred UK landing area for shorter Channel crossings from Houtem/Dunkerque, documented via planning applications 2014-2016. Individual mast locations not pinned in fetched sources.",,active,press,"Sniper in Mahwah / Visionscarto: preferred UK landing area for shorter Channel crossings; documented via 2014-2016 planning applications, individual masts not singly located",https://sniperinmahwah.wordpress.com/2016/01/26/hft-in-the-banana-land/,reported,
-T2-013,"Flobecq DCS tower (Hainaut, BE)",network,Former US Army Defense Communication System tower,Jump Trading; Flow Traders; Optiver,50.763892,3.744626,approximate,Flobecq,Belgium,Old US Army DCS microwave tower on the London-Frankfurt line; HFT dish colocations documented 2014-2015 via Belgian antenna cadastre dossiers. Current tenancy unverified.,,active,press,Sniper in Mahwah V: ex-US Army DCS tower on the London-Frankfurt line; HFT dish colocations documented 2014-2015 via Belgian cadastre dossiers,https://sniperinmahwah.wordpress.com/2015/01/14/hft-in-my-backyard-v/,reported,
+T2-013,"Flobecq DCS tower (Hainaut, BE)",network,Former US Army Defense Communication System tower,Jump Trading; Flow Traders; Optiver,50.763892,3.744626,exact,Flobecq,Belgium,Old US Army DCS microwave tower on the London-Frankfurt line; HFT dish colocations documented 2014-2015 via Belgian antenna cadastre dossiers. Current tenancy unverified.,,active,press,Sniper in Mahwah V (ex-DEB technician coords) + OSM surveyed node 3646963462 'Ancien station de relais US/OTAN' 7m away — two independent sources within 10m,https://sniperinmahwah.wordpress.com/2015/01/14/hft-in-my-backyard-v/,reported,
 T2-014,Sint-Pieters-Leeuw tower (BE),network,"Norkring broadcast tower, Sint-Pieters-Leeuw",McKay Brothers,50.782,4.244,city_level,Sint-Pieters-Leeuw,Belgium,Norkring broadcast tower described by the source as the second tallest building in Belgium; McKay Brothers dishes documented February 2015 via Belgian antenna cadastre dossier. Current tenancy unverified.,,active,press,"Sniper in Mahwah ('the last tower'): McKay dishes on the Norkring broadcast tower, documented Feb 2015",https://sniperinmahwah.wordpress.com/2015/02/03/hft-in-my-backyard-the-last-tower/,reported,
 T2-015,Wavre tower (BE),network,Wavre broadcast tower (third tallest structure in Belgium),Jump Trading,50.717,4.601,city_level,Wavre,Belgium,"Three Jump-owned dishes documented/photographed on the tower in 2014, two pointing to Hannut. Current tenancy unverified.",,active,press,"Sniper in Mahwah II: three Jump-owned dishes photographed 2014, two pointing to Hannut",https://sniperinmahwah.wordpress.com/2014/09/25/hft-in-my-backyard-ii/,reported,
 T2-016,Hannut tower (BE),network,"Relay tower, Hannut",Jump Trading; Optiver,50.671,5.079,city_level,Hannut,Belgium,Hop on Jump's Belgian chain toward Frankfurt; Jump dishes and Optiver colocation documented 2014 via cadastre dossiers. Current tenancy unverified.,,active,press,Sniper in Mahwah II: hop on Jump's Belgian chain toward Frankfurt; Jump dishes + Optiver colocation via cadastre dossiers (2014),https://sniperinmahwah.wordpress.com/2014/09/25/hft-in-my-backyard-ii/,reported,