@camstack/addon-waste-collections 0.0.0-stage → 0.1.1

package/python/vendor/waste_collection_schedule/service/ArcGis.py

@@ -0,0 +1,176 @@
+"""
+ArcGIS REST API Client Library.
+
+Provides reusable helpers for interacting with ArcGIS services:
+  - Geocoding addresses via the ArcGIS World GeocodeServer
+  - Querying ArcGIS Feature Services with spatial or attribute filters
+
+Typical workflow:
+    1. Call geocode() to turn an address string into coordinates.
+    2. Call query_feature_layer() with those coordinates to retrieve
+       attributes from a FeatureServer layer.
+"""
+
+from __future__ import annotations
+
+import json
+import logging
+from datetime import date, timedelta
+from typing import Any
+
+import requests
+
+_LOGGER = logging.getLogger(__name__)
+
+GEOCODE_URL = "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer"
+
+
+class ArcGisError(Exception):
+    """Base exception for ArcGIS-related failures."""
+
+
+class ArcGisGeocodeError(ArcGisError):
+    """Raised when geocoding fails or returns no candidates."""
+
+
+class ArcGisQueryError(ArcGisError):
+    """Raised when a feature layer query fails or returns no features."""
+
+
+def geocode(
+    address: str,
+    *,
+    geocode_url: str = GEOCODE_URL,
+    out_sr: int = 4326,
+    max_locations: int = 1,
+    timeout: int = 20,
+) -> dict[str, float]:
+    """Geocode an address string to coordinates.
+
+    Args:
+        address: Free-text address to geocode.
+        geocode_url: Base URL of the GeocodeServer (defaults to Esri World).
+        out_sr: Output spatial reference WKID (default 4326 = WGS84).
+        max_locations: Maximum number of candidates to request.
+        timeout: Request timeout in seconds.
+
+    Returns:
+        dict with 'x' and 'y' keys (longitude and latitude for WKID 4326).
+
+    Raises:
+        ArcGisGeocodeError: If no candidates are found.
+    """
+    params: dict[str, Any] = {
+        "SingleLine": address,
+        "outSR": json.dumps({"wkid": out_sr}),
+        "maxLocations": max_locations,
+        "f": "json",
+    }
+
+    r = requests.get(
+        f"{geocode_url.rstrip('/')}/findAddressCandidates",
+        params=params,
+        timeout=timeout,
+    )
+    r.raise_for_status()
+
+    candidates = r.json().get("candidates", [])
+    if not candidates:
+        raise ArcGisGeocodeError(f"No candidates found for: {address}")
+
+    location = candidates[0]["location"]
+    _LOGGER.debug("Geocoded '%s' -> (%s, %s)", address, location["x"], location["y"])
+    return location
+
+
+def query_feature_layer(
+    feature_url: str,
+    *,
+    geometry: dict[str, Any] | None = None,
+    geometry_type: str = "esriGeometryPoint",
+    spatial_rel: str = "esriSpatialRelIntersects",
+    where: str | None = None,
+    out_fields: str = "*",
+    return_geometry: bool = False,
+    in_sr: int = 4326,
+    timeout: int = 20,
+) -> list[dict[str, Any]]:
+    """Query an ArcGIS FeatureServer layer.
+
+    Supports both spatial queries (point-in-polygon) and attribute queries.
+
+    Args:
+        feature_url: Full URL to the FeatureServer layer
+            (e.g. '.../FeatureServer/0').
+        geometry: Geometry dict for spatial queries (e.g. {'x': ..., 'y': ...}).
+        geometry_type: ArcGIS geometry type string.
+        spatial_rel: Spatial relationship for the query.
+        where: SQL where clause for attribute queries.
+        out_fields: Comma-separated field names or '*' for all.
+        return_geometry: Whether to include geometry in the response.
+        in_sr: Input spatial reference WKID for the geometry.
+        timeout: Request timeout in seconds.
+
+    Returns:
+        List of attribute dicts, one per matching feature.
+
+    Raises:
+        ArcGisQueryError: If no features are found.
+    """
+    params: dict[str, Any] = {
+        "outFields": out_fields,
+        "returnGeometry": str(return_geometry).lower(),
+        "f": "json",
+    }
+
+    if geometry is not None:
+        params["geometry"] = json.dumps(geometry)
+        params["geometryType"] = geometry_type
+        params["spatialRel"] = spatial_rel
+        params["inSR"] = str(in_sr)
+
+    if where is not None:
+        params["where"] = where
+
+    r = requests.get(
+        f"{feature_url.rstrip('/')}/query",
+        params=params,
+        timeout=timeout,
+    )
+    r.raise_for_status()
+
+    features = r.json().get("features", [])
+    if not features:
+        raise ArcGisQueryError("No features found for the given query.")
+
+    return [f.get("attributes", {}) for f in features]
+
+
+def epoch_ms_to_date(epoch_ms: int | float) -> date:
+    """Convert an ArcGIS epoch-millisecond timestamp to a Python date."""
+    return date.fromtimestamp(epoch_ms / 1000)
+
+
+def get_next_n_dates(start: date, n: int, delta: timedelta) -> list[date]:
+    """
+    Starting from `start`, advance past today by `delta` steps, then
+    collect the next `n` dates (each `delta` apart).
+    """
+    d = start
+    today = date.today()
+    result: list[date] = []
+    for _ in range(n):
+        while d < today:
+            d += delta
+        result.append(d)
+        d += delta
+    return result
+
+
+def most_recent_weekday(day_of_week: int) -> date:
+    """
+    Return the most recent (including today) occurrence of `day_of_week`
+    (0=Monday … 6=Sunday).
+    """
+    today = date.today()
+    return today - timedelta((today.weekday() - day_of_week + 7) % 7)

package/python/vendor/waste_collection_schedule/service/CMCityMedia.py

@@ -0,0 +1,271 @@
+#!/usr/bin/env python3
+
+SERVICE_MAP = [
+    {  # Blankenheim, 53945
+        "hpid": 415,
+        "realm": 41500,
+        "name": "Blankenheim App - Müllkalender",
+        "region": "Gemeinde Blankenheim",
+        "icons": {
+            "158": "mdi:package-variant",  # Altpapier
+            "154": "mdi:leaf",  # Biomüll
+            "159": "mdi:tree",  # Grüngut
+            "157": "mdi:recycle",  # Leichtverpackungen
+            "155": "mdi:trash-can",  # Restmüll
+            "160": "mdi:truck-flatbed",  # Sondermüll
+            "161": "mdi:truck-flatbed",  # Sondermüll Rewe-Parkplatz
+        },
+    },
+    {
+        "hpid": 95,
+        "realm": 9501,
+        "name": "www.lrasha.de - Müllkalender",
+        "region": "Landkreis Schwäbisch Hall",
+        "disabled": True,
+        "icons": {
+            "16": "mdi:trash-can",  # Bio- und Restmüllabfuhr (60 l/120 l/240 l/1,1 m³)
+            "12": "mdi:recycle",  # Gelbe Säcke
+            "14": "mdi:package-variant",  # Papiertonne
+        },
+    },
+    {
+        "hpid": 1,
+        "realm": 100,
+        "name": "www.buehlerzell.de - Müllkalender",
+        "region": "Gemeinde Bühlerzell",
+        "disabled": True,
+        "icons": {
+            "44": "mdi:trash-can",  # Bio- und Restmüllabfuhr (60 l/120 l/240 l/1,1 m³)
+            "42": "mdi:recycle",  # Gelbe Säcke
+            "43": "mdi:package-variant",  # Papiertonne
+        },
+    },
+    {
+        "hpid": 107,
+        "realm": 10701,
+        "name": "www.kressbronn.de - Müllkalender",
+        "region": "Gemeinde Kressbronn am Bodensee",
+        "disabled": True,
+        "icons": {
+            "47": "mdi:trash-can",  # Bio- und Restmüllabfuhr
+            "46": "mdi:recycle",  # Gelbe Säcke
+            "48": "mdi:package-variant",  # Papiertonne
+        },
+    },
+    {
+        "hpid": 168,
+        "realm": 16801,
+        "name": "www.hohenlohekreis.de - Müllkalender",
+        "region": "Hohenlohekreis",
+        "disabled": True,
+        "icons": {
+            "31": "mdi:leaf",  # Bioenergietonne
+            "36": "mdi:pine-tree",  # Christbaumsammlung
+            "30": "mdi:trash-can",  # Restmülltonne
+            "33": "mdi:recycle",  # Wertstofftonne Altpapier
+            "32": "mdi:package-variant",  # Wertstofftonne Verpackung
+        },
+    },
+    {
+        "hpid": 225,
+        "realm": 22500,
+        "name": "Deggenhausertal App - Müllkalender",
+        "region": "Gemeinde Deggenhausertal",
+        "icons": {
+            "141": "mdi:nail",  # Altmetallsammlung Vereine
+            "138": "mdi:leaf",  # Bioabfall 2-wöchentlich
+            "139": "mdi:pine-tree",  # Christbaumsammlung
+            "143": "mdi:tree",  # Gartenabfall
+            "142": "mdi:recycle",  # Gelber Sack
+            "146": "mdi:package-variant",  # Papier 4-wöchentlich
+            "145": "mdi:package-variant",  # Papiercontainer 2-wöchentlich nur nach Anmeldung
+            "140": "mdi:package-variant",  # Papiersammlung Vereine
+            "144": "mdi:biohazard",  # Problemstoffsammlung
+            "136": "mdi:trash-can",  # Restmüll 2-wöchentlich
+            "137": "mdi:trash-can",  # Restmüll 4-wöchentlich
+        },
+    },
+    {
+        "hpid": 233,
+        "realm": 23301,
+        "name": "kraichtal.de - Müllkalender 1",
+        "region": "Stadt Kraichtal",
+        "disabled": True,
+        "icons": {
+            "19": "mdi:package-variant",  # Altpapier
+            "21": "mdi:trash-can",  # Reststoff
+            "25": "mdi:biohazard",  # Schadstoff
+            "18": "mdi:recycle",  # Wertstoff
+        },
+    },
+    {
+        "hpid": 248,
+        "realm": 24800,
+        "name": "www.kappelrodeck.de - Müllkalender",
+        "region": "Gemeinde Kappelrodeck",
+        "disabled": True,
+        "icons": {
+            "75": "mdi:trash-can",  # Bio- und Restmüllabfuhr (60 l/120 l/240 l/1,1 m³)
+            "73": "mdi:recycle",  # Gelbe Säcke
+            "74": "mdi:package-variant",  # Papiertonne
+        },
+    },
+    {
+        "hpid": 331,
+        "realm": 33100,
+        "name": "www.schutterwald.de - Müllkalender",
+        "region": "Gemeinde Schutterwald",
+        "icons": {
+            "67": "mdi:trash-can",  # Bio- und Restmüllabfuhr (60 l/120 l/240 l/1,1 m³)
+            "65": "mdi:recycle",  # Gelbe Säcke
+            "66": "mdi:package-variant",  # Papiertonne
+        },
+    },
+    {
+        "hpid": 374,
+        "realm": 37401,
+        "name": "www.aschheim.de - Müllkalender",
+        "region": "Gemeinde Aschheim",
+        "disabled": True,
+        "icons": {
+            "38": "mdi:leaf",  # Biomüll
+            "147": "mdi:vacuum",  # Biotonnenreinigung
+            "37": "mdi:recycle",  # Gelber Sack
+            "41": "mdi:biohazard",  # Giftmobil
+            "45": "mdi:tree",  # Häckselaktion
+            "61": "mdi:package-variant",  # Papier Aschheim
+            "165": "mdi:package-variant",  # Papier Dornach
+            "39": "mdi:trash-can",  # Restmüll Nord
+            "40": "mdi:trash-can",  # Restmüll Süd
+            "68": "mdi:plus",  # Sonderleerung
+        },
+    },
+    {
+        "hpid": 390,
+        "realm": 39000,
+        "name": "Mittelbiberach App - Müllkalender",
+        "region": "Gemeinde Mittelbiberach",
+        "disabled": True,
+        "icons": {
+            "149": "mdi:trash-can",  # Bio- und Restmüllabfuhr
+            "148": "mdi:recycle",  # Gelbe Säcke
+            "150": "mdi:package-variant",  # Papiertonne
+        },
+    },
+    {
+        "hpid": 391,
+        "realm": 39100,
+        "name": "www.ehingen.de - Müllkalender",
+        "region": "Stadt Ehingen",
+        "disabled": True,
+        "icons": {
+            "116": "mdi:leaf",  # Biotonne
+            "121": "mdi:package-variant",  # Blaue Tonne
+            "117": "mdi:pine-tree",  # Christbaum
+            "122": "mdi:tree",  # Gartenabraum
+            "118": "mdi:recycle",  # Gelber Sack
+            "123": "mdi:trash-can",  # Hausmüll
+            "119": "mdi:package-variant",  # Vereinssammlung Papier
+            "120": "mdi:package-variant",  # Vereinssammlung Papier und Kartonagen
+        },
+    },
+    {
+        "hpid": 420,
+        "realm": 42000,
+        "name": "Senden (Westfalen) App - Müllkalender",
+        "region": "Gemeinde Senden (Westfalen)",
+        "disabled": True,
+        "icons": {
+            "97": "mdi:leaf",  # Biotonne
+            "95": "mdi:recycle",  # gelbe Tonne/säcke
+            "102": "mdi:tree",  # Häcksler - Auf der Horst
+            "99": "mdi:tree",  # Häcksler - Drachenwiese, Droste-zu-Senden-Str.
+            "100": "mdi:tree",  # Häcksler - Gemeindl. Bauhof
+            "101": "mdi:tree",  # Häcksler - Parkplatz Havixbecker Str.
+            "98": "mdi:tree",  # Häcksler - Spielplatz Siebenstücken
+            "96": "mdi:package-variant",  # Papiertonne
+            "94": "mdi:trash-can",  # Restmülltonne
+            "103": "mdi:biohazard",  # Schadstoffmobil
+        },
+    },
+    {
+        "hpid": 421,
+        "realm": 42100,
+        "name": "KEPTN App - Müllkalender",
+        "region": "Stadt Emden",
+        "disabled": True,
+        "icons": {
+            "56": "mdi:recycle",  # Gelber Sack (Gelbe Tonne)
+            "57": "mdi:package-variant",  # Papier, Pappe, Karton (Blaue Tonne)
+            "55": "mdi:trash-can",  # Restabfall (Graue Tonne)
+        },
+    },
+    {
+        "hpid": 424,
+        "realm": 42400,
+        "name": "Emmendingen App - Müllkalender",
+        "region": "Stadt Emmendingen",
+        "icons": {
+            "79": "mdi:trash-can",  # Bio- und Restmüllabfuhr (60 l/120 l/240 l/1,1 m³)
+            "77": "mdi:recycle",  # Gelbe Säcke
+            "78": "mdi:package-variant",  # Papiertonne
+        },
+    },
+    {
+        "hpid": 426,
+        "realm": 42600,
+        "name": "DORFnet - Müllkalender",
+        "region": "Gemeinde Kalletal",
+        "icons": {
+            "63": "mdi:package-variant",  # Blaue Altpapiertonne
+            "124": "mdi:recycle",  # Gelbe Tonne
+            "64": "mdi:trash-can",  # Graue Restmülltonne
+            "69": "mdi:leaf",  # Grüne Biotonne
+            "70": "mdi:leaf",  # Saisonbiotonne
+            "71": "mdi:biohazard",  # Schadstoffsammlung
+            "72": "mdi:baby",  # Windelsack
+        },
+    },
+    {
+        "hpid": 441,
+        "realm": 44100,
+        "name": "Messstetten App - Müllkalender",
+        "region": "Stadt Messstetten",
+        "icons": {
+            "113": "mdi:package-variant",  # Altpapiersammlung
+            "107": "mdi:package-variant",  # Altpapiertonne
+            "106": "mdi:leaf",  # Biotonne
+            "115": "mdi:pine-tree",  # Christbaumsammlung
+            "108": "mdi:recycle",  # Gelber Sack
+            "109": "mdi:tree",  # Grünabfall-Abfuhr
+            "110": "mdi:fridge",  # Kühlgeräte, Bildschirme und Fernsehgeräte
+            "104": "mdi:trash-can",  # Restmülltonne
+            "105": "mdi:trash-can",  # Restmülltonne 1100 l
+            "111": "mdi:biohazard",  # Schadstoffsammlung Gewerbe in der Kreismülldeponie
+            "112": "mdi:biohazard",  # Schadstoffsammlung im Wertstoffzentrum
+            "114": "mdi:nail",  # Schrottsammlung
+        },
+    },
+    {
+        "hpid": 447,
+        "realm": 44700,
+        "name": "Oberstadion App - Müllkalender",
+        "region": "Gemeinde Oberstadion",
+        "disabled": True,
+        "icons": {
+            "128": "mdi:tshirt-crew",  # Altkleider
+            "133": "mdi:nail",  # Altmetall
+            "162": "mdi:leaf",  # Bioabfalltonne
+            "129": "mdi:package-variant",  # Blaue Tonne
+            "130": "mdi:pine-tree",  # Christbaumabfuhr
+            "132": "mdi:tree",  # Gartenabraum
+            "127": "mdi:recycle",  # Gelber Sack
+            "126": "mdi:trash-can",  # Hausmüll
+            "131": "mdi:tree",  # Holzabfuhr
+            "164": "mdi:biohazard",  # Problemstoffannahme im Entsorgungszentrum
+            "135": "mdi:biohazard",  # Schadstoffmobil
+            "134": "mdi:trash-can-outline",  # Sperrmüll
+            "163": "mdi:package-variant",  # Straßensammlung Papier
+        },
+    },
+]