From a71e4c7d5665ea4cc05c13d02f1c014b96060641 Mon Sep 17 00:00:00 2001 From: mampfes Date: Sun, 14 Nov 2021 19:32:51 +0100 Subject: [PATCH] improve ics documentation --- doc/source/ics.md | 82 +++++++++++++++++++++++++++++++++++++---------- 1 file changed, 65 insertions(+), 17 deletions(-) diff --git a/doc/source/ics.md b/doc/source/ics.md index 5b3cf805..f2b972dd 100644 --- a/doc/source/ics.md +++ b/doc/source/ics.md @@ -6,22 +6,24 @@ This source has been successfully tested with the following service providers: ### Germany - [Abfall Landkreis Stade](https://abfall.landkreis-stade.de/) -- [AVL Ludwigsburg](https://www.avl-ludwigsburg.de/) +- [Abfallkalender Zollernalbkreis](https://www.zollernalbkreis.de/landratsamt/aemter++und+organisation/Elektronischer+Abfallkalender) ([Example](#abfallkalender-zollernalbkreis)) +- [Abfallwirtschaft Kreis Böblingen](https://www.lrabb.de/start/Service+_+Verwaltung/Abfuhrtermine.html) +- [AVL Ludwigsburg](https://www.avl-ludwigsburg.de/) ([Example](#avl-ludwigsburg)) +- [ASR Chemnitz](https://www.asr-chemnitz.de/kundenportal/entsorgungskalender/) - [AWB Esslingen](https://www.awb-es.de/) +- [AWM München](https://www.awm-muenchen.de) ([Notes](#awm-münchen)) - [Awista Starnberg](https://www.awista-starnberg.de/) -- [AWM München](https://www.awm-muenchen.de) +- [EAW Rheingau Taunus](https://www.eaw-rheingau-taunus.de/service/abfallkalender.html) ([Example](#eaw-rheingau-taunus)) - [EDG Entsorgung Dortmund](https://www.edg.de/) +- [Entsorgungsgesellschaft Görlitz-Löbau-Zittau](https://www.abfall-eglz.de/abfallkalender.0.html) ([Notes](#entsorgungsgesellschaft-görlitz-löbau-zittau)) +- [Müllabfuhr-Deutschland](https://www.muellabfuhr-deutschland.de/) ([Notes](#müllabfuhr-deutschland)) - [Stadtreinigung Leipzig](https://www.stadtreinigung-leipzig.de/) -- [Entsorgungsgesellschaft Görlitz-Löbau-Zittau](https://www.abfall-eglz.de/abfallkalender.0.html) (Remove the year from the generated URL to always get the current year.) -- [Abfallwirtschaft Kreis Böblingen](https://www.lrabb.de/start/Service+_+Verwaltung/Abfuhrtermine.html) (API from AbfallPlus / Abfall.IO) -- [ASR Chemnitz](https://www.asr-chemnitz.de/kundenportal/entsorgungskalender/) (Service von https://asc.hausmuell.info/ics/ics.php) -- [Müllabfuhr-Deutschland](https://www.muellabfuhr-deutschland.de/) (You need to find the direct ics export link for your region, e.g. [Weimarer Land, Bad Berka](https://www.muellabfuhr-deutschland.de/weimarer-land/location/0c595d1c-2cbc-4d19-ae81-df5318fceb7c/pickups)) ### Sweden - [NSR Nordvästra Skåne](https://nsr.se/privat/allt-om-din-sophamtning/nar-toms-mitt-karl/tomningskalender/) ### United States of America -- [ReCollect](https://recollect.net) +- [ReCollect.net](https://recollect.net) ([Notes](#recollect)) ## Configuration via configuration.yaml @@ -84,8 +86,20 @@ Field in params dictionary to be replaced with current year (4 digits including Delimiter to split event summary into individual collection types. If your service puts multiple collections types which occur at the same day into a single event, this option can be used to separate the collection types again. -## Examples +## Examples and Notes +*** +### Local file +```yaml +waste_collection_schedule: + sources: + - name: ics + args: + file: "test.ics" +``` + +*** +### AVL Ludwigsburg ```yaml waste_collection_schedule: sources: @@ -95,14 +109,8 @@ waste_collection_schedule: offset: 1 ``` -```yaml -waste_collection_schedule: - sources: - - name: ics - args: - file: "test.ics" -``` - +*** +### Abfallkalender Zollernalbkreis ```yaml waste_collection_schedule: sources: @@ -128,6 +136,8 @@ waste_collection_schedule: year_field: year ``` +*** +### EAW Rheingau Taunus ```yaml waste_collection_schedule: sources: @@ -137,7 +147,8 @@ waste_collection_schedule: split_at: "," ``` -### Recollect.net +*** +### ReCollect To get the URL, search your address in the recollect form of your home town, click "Get a calendar", then "Add to iCal". Finally, the URL under "Subscribe to calendar" is your ICS calendar link: ``` webcal://recollect.a.ssl.fastly.net/api/places/BCCDF30E-578B-11E4-AD38-5839C200407A/services/208/events.en.ics?client_id=6FBD18FE-167B-11EC-992A-C843A7F05606 @@ -151,3 +162,40 @@ waste_collection_schedule: url: "https://recollect.a.ssl.fastly.net/api/places/BCCDF30E-578B-11E4-AD38-5839C200407A/services/208/events.en.ics", split_at: "\\, [and ]*", ``` +*** +### Entsorgungsgesellschaft Görlitz-Löbau-Zittau +Remove the year from the generated URL to always get the current year. + +*** +### Müllabfuhr-Deutschland +You need to find the direct ics export link for your region, e.g. [Weimarer Land, Bad Berka](https://www.muellabfuhr-deutschland.de/weimarer-land/location/0c595d1c-2cbc-4d19-ae81-df5318fceb7c/pickups). + +Known districts: + +- https://www.muellabfuhr-deutschland.de/burgenlandkreis +- https://www.muellabfuhr-deutschland.de/saalekreis +- https://www.muellabfuhr-deutschland.de/soemmerda +- https://www.muellabfuhr-deutschland.de/weimarer-land + +```yaml +waste_collection_schedule: + sources: + - name: ics + args: + url: https://www.muellabfuhr-deutschland.de/weimarer-land/location/0c595d1c-2cbc-4d19-ae81-df5318fceb7c/pickups/ical.ics +``` + +*** +### AWM München + +1. Find your ICS export link via the AWM web page +2. Remove the cHash attribute +3. Replace current year with {%Y} + +```yaml +waste_collection_schedule: + sources: + - name: ics + args: + url: "https://www.awm-muenchen.de/entsorgen/abfuhrkalender?tx_awmabfuhrkalender_abfuhrkalender%5Bhausnummer%5D=2&tx_awmabfuhrkalender_abfuhrkalender%5Bleerungszyklus%5D%5BB%5D=1%2F2%3BG&tx_awmabfuhrkalender_abfuhrkalender%5Bleerungszyklus%5D%5BP%5D=1%2F2%3BU&tx_awmabfuhrkalender_abfuhrkalender%5Bleerungszyklus%5D%5BR%5D=001%3BG&tx_awmabfuhrkalender_abfuhrkalender%5Bsection%5D=ics&tx_awmabfuhrkalender_abfuhrkalender%5Bsinglestandplatz%5D=false&tx_awmabfuhrkalender_abfuhrkalender%5Bstandplatzwahl%5D=true&tx_awmabfuhrkalender_abfuhrkalender%5Bstellplatz%5D%5Bbio%5D=70114566&tx_awmabfuhrkalender_abfuhrkalender%5Bstellplatz%5D%5Bpapier%5D=70114566&tx_awmabfuhrkalender_abfuhrkalender%5Bstellplatz%5D%5Brestmuell%5D=70114566&tx_awmabfuhrkalender_abfuhrkalender%5Bstrasse%5D=Freimanner%20Bahnhofstr.&tx_awmabfuhrkalender_abfuhrkalender%5Byear%5D={%Y}} +``` \ No newline at end of file