jetlag-maps/copenhagen/scripts/export_google_mymaps.py

#!/usr/bin/env python3
"""Export the master GeoPackage to a Google My Maps-importable KML.

Reads (from data/processed): master.gpkg (lines, stops, stations), area.gpkg
Read (from config): coastline.kml — the coastline layer extracted verbatim
from the reference map
(https://www.google.com/maps/d/u/0/kml?mid=17T6ZDYbGz72h_eteL-CxdkiaXcgDLEA&forcekml=1)

Writes: output/copenhagen-mymaps.kml

My Maps turns each top-level KML Folder into a layer on import. We emit:

    Bus stops / Bus routes
    Train stations / Train routes   (metro + S-tog + light rail + regional)
    Ferry stops / Ferry routes
    City Pass boundary (outline + faint fill)
    Coastline (verbatim from the reference map's layer)

Colours match the PNG map: routes use colour_final from prepare.py; stop
icons use styling.yaml palette defaults (train stations match the reference
map's red pin). Import manually in Google My Maps:
Create map → Import → upload the .kml.
"""
import re
import sys
import xml.etree.ElementTree as ET

import geopandas as gpd
import yaml

from _common import CONFIG, OUTPUT, PROCESSED

KML = "http://www.opengis.net/kml/2.2"
ET.register_namespace("", KML)

# My Maps stock pin (same as the reference map uses); tinted via IconStyle.
ICON_HREF = "https://www.gstatic.com/mapspro/images/stock/503-wht-blank_maps.png"
ICON_SCALE = 1.0

TRAIN_STATION_COLOR = "#C2185B"  # reference map's station-pin red
TRAIN_STYLES = ["metro", "s_tog", "light_rail", "regional"]

# route line widths in pixels, per style
LINE_WIDTH = {
    "metro": 4.5,
    "s_tog": 4.25,
    "light_rail": 4.25,
    "regional": 3.5,
    "ferry": 3.75,
    "bus": 2.75,
}

BOUNDARY_COLOR = "#006064"
BOUNDARY_LINE_WIDTH = 3.0
BOUNDARY_FILL_ALPHA = 0x54  # ~33 %


class Styles:
    """Registry of unique (kind, color, width) -> KML <Style> ids."""

    def __init__(self):
        self._map = {}

    def get(self, kind, color_hex, width=0.0):
        key = (kind, color_hex, width)
        if key not in self._map:
            self._map[key] = f"s{len(self._map):03d}"
        return self._map[key]

    def elements(self):
        """Yield <Style> elements for everything registered so far."""
        by_id = sorted(self._map.items(), key=lambda kv: kv[1])
        for (kind, color_hex, width), sid in by_id:
            st = ET.Element(f"{{{KML}}}Style", id=sid)
            if kind == "icon":
                el = ET.SubElement(st, f"{{{KML}}}IconStyle")
                el.append(_tex("color", kml_color(color_hex)))
                el.append(_tex("scale", str(ICON_SCALE)))
                icon = ET.SubElement(el, f"{{{KML}}}Icon")
                icon.append(_tex("href", ICON_HREF))
            else:
                el = ET.SubElement(st, f"{{{KML}}}LineStyle")
                el.append(_tex("color", kml_color(color_hex)))
                el.append(_tex("width", str(width)))
                if kind == "poly":
                    poly = ET.SubElement(st, f"{{{KML}}}PolyStyle")
                    poly.append(_tex("color", kml_color(color_hex, BOUNDARY_FILL_ALPHA)))
            balloon = ET.SubElement(st, f"{{{KML}}}BalloonStyle")
            balloon.append(_tex("text", "<h3>$[name]</h3>"))
            yield st


def _tex(tag, value):
    el = ET.Element(f"{{{KML}}}{tag}")
    el.text = value
    return el


def kml_color(hex_color, alpha=0xFF):
    """#RRGGBB -> KML AABBGGRR."""
    h = hex_color.lstrip("#")
    return f"{alpha:02x}{h[4:6]}{h[2:4]}{h[0:2]}"


def placemark(folder_el, name, sid, geom_el):
    pm = ET.SubElement(folder_el, f"{{{KML}}}Placemark")
    pm.append(_tex("name", str(name)))
    pm.append(_tex("styleUrl", f"#{sid}"))
    pm.append(geom_el)


def point_el(geom):
    pt = ET.Element(f"{{{KML}}}Point")
    pt.append(_tex("coordinates", f"{geom.x:.7f},{geom.y:.7f}"))
    return pt


def linestring_el(geom):
    ls = ET.Element(f"{{{KML}}}LineString")
    ls.append(_tex("tessellate", "1"))
    ls.append(_tex("coordinates", " ".join(f"{x:.7f},{y:.7f}" for x, y in geom.coords)))
    return ls


def polygon_el(geom):
    pg = ET.Element(f"{{{KML}}}Polygon")
    pg.append(_tex("tessellate", "1"))
    outer = ET.SubElement(pg, f"{{{KML}}}outerBoundaryIs")
    ring = ET.SubElement(outer, f"{{{KML}}}LinearRing")
    ring.append(_tex("coordinates", " ".join(f"{x:.7f},{y:.7f}" for x, y in geom.exterior.coords)))
    for inner in geom.interiors:
        b = ET.SubElement(pg, f"{{{KML}}}innerBoundaryIs")
        ring = ET.SubElement(b, f"{{{KML}}}LinearRing")
        ring.append(_tex("coordinates", " ".join(f"{x:.7f},{y:.7f}" for x, y in inner.coords)))
    return pg


def multi_el(geom, single):
    """Wrap (Multi)Geometry into a KML element (MultiGeometry if needed)."""
    geoms = list(getattr(geom, "geoms", [geom]))
    if len(geoms) == 1:
        return single(geoms[0])
    mg = ET.Element(f"{{{KML}}}MultiGeometry")
    for g in geoms:
        mg.append(single(g))
    return mg


def add_folder(document, name):
    f = ET.SubElement(document, f"{{{KML}}}Folder")
    f.append(_tex("name", name))
    return f


def add_stops_folder(document, name, gdf, tint, styles):
    f = add_folder(document, name)
    sid = styles.get("icon", tint)
    for _, row in gdf.sort_values("name").iterrows():
        placemark(f, row["name"], sid, point_el(row.geometry))
    return len(gdf)


def add_routes_folder(document, name, gdf, styles):
    f = add_folder(document, name)
    for _, row in gdf.iterrows():
        sid = styles.get("line", row["colour_final"], LINE_WIDTH[row["style"]])
        placemark(f, f'{row["ref"]} {row["name"]}', sid, multi_el(row.geometry, linestring_el))
    return len(gdf)


def add_boundary_folder(document, area_geom, styles):
    f = add_folder(document, "City Pass boundary")
    sid = styles.get("poly", BOUNDARY_COLOR, BOUNDARY_LINE_WIDTH)
    placemark(f, "City Pass boundary", sid, multi_el(area_geom, polygon_el))
    return 1


def append_coastline(document):
    """Append the verbatim coastline layer stored in config/coastline.kml."""
    src = ET.parse(CONFIG / "coastline.kml").getroot().find(f"{{{KML}}}Document")
    n = 0
    for el in src:
        if el.tag == f"{{{KML}}}Folder":
            document.append(el)
            n = len(el.findall(f"{{{KML}}}Placemark"))
        elif el.tag in (f"{{{KML}}}Style", f"{{{KML}}}StyleMap"):
            document.append(el)
    return n


def natural_key(ref):
    return tuple(int(t) if t.isdigit() else t for t in re.split(r"(\d+)", str(ref)))


def main():
    lines = gpd.read_file(PROCESSED / "master.gpkg", layer="lines")
    stops = gpd.read_file(PROCESSED / "master.gpkg", layer="stops")
    stations = gpd.read_file(PROCESSED / "master.gpkg", layer="stations")
    area = gpd.read_file(PROCESSED / "area.gpkg").geometry.union_all()
    styling = yaml.safe_load((CONFIG / "styling.yaml").read_text())
    palette = styling["palette"]

    kml = ET.Element(f"{{{KML}}}kml")
    document = ET.SubElement(kml, f"{{{KML}}}Document")
    document.append(_tex("name", "Kurragömma Köpenhamn"))

    styles = Styles()
    counts = {}

    counts["Bus stops"] = add_stops_folder(
        document, "Bus stops", stops[stops["style"] == "bus"],
        palette["bus"]["default"], styles,
    )
    bus_lines = lines[lines["style"] == "bus"].copy()
    bus_lines["_k"] = bus_lines["ref"].map(natural_key)
    counts["Bus routes"] = add_routes_folder(
        document, "Bus routes", bus_lines.sort_values("_k"), styles
    )

    counts["Train stations"] = add_stops_folder(
        document, "Train stations", stations, TRAIN_STATION_COLOR, styles
    )
    train = lines[lines["style"].isin(TRAIN_STYLES)].copy()
    train["_order"] = train["style"].map(TRAIN_STYLES.index)
    train["_k"] = train["ref"].map(natural_key)
    counts["Train routes"] = add_routes_folder(
        document, "Train routes", train.sort_values(["_order", "_k"]), styles
    )

    counts["Ferry stops"] = add_stops_folder(
        document, "Ferry stops", stops[stops["style"] == "ferry"],
        palette["ferry"]["default"], styles,
    )
    ferry_lines = lines[lines["style"] == "ferry"].sort_values("ref")
    counts["Ferry routes"] = add_routes_folder(document, "Ferry routes", ferry_lines, styles)

    counts["City Pass boundary"] = add_boundary_folder(document, area, styles)
    counts["Coastline"] = append_coastline(document)

    # <Style> elements belong before the first <Folder> (KML resolves style
    # ids regardless of order; this is conventional + nicer on the eyes).
    insert_at = list(document).index(document.find(f"{{{KML}}}name")) + 1
    for offset, st in enumerate(styles.elements()):
        document.insert(insert_at + offset, st)

    out = OUTPUT / "copenhagen-mymaps.kml"
    tree = ET.ElementTree(kml)
    ET.indent(tree, space="  ")
    tree.write(out, encoding="utf-8", xml_declaration=True)

    print(f"wrote {out}")
    for n, c in counts.items():
        print(f"  {n}: {c} placemarks")


if __name__ == "__main__":
    main()