Die Programmierschnittstelle (API) mit den Entsorgungsdaten ist hier: https://openerz.metaodi.ch.
Die Daten können von dort entweder als JSON oder ICS (iCal-Kalender) bezogen werden.

Kalender abonnieren

Gemeinde Abfallarten Gebiet Format
Kalender-URL zum kopieren

Die URL kann kopiert und in einer beliebigen Kalender-Applikation abonniert werden (z.B. mit Outlook, Apple Kalender, Google Kalender).

Datenbezug

Die Programmierschnittstelle (API) ist hier im Detail dokumentiert. Es handelt sich dabei um eine interaktive Dokumentation (OpenAPI/Swagger), bei der das API direkt ausprobiert werden kann.

Daten als Kalender beziehen

Wenn du die Entsorungsdaten für deine Gemeinde als Kalender abonnieren möchtest, gehe wiefolgt vor:

  1. Prüfen, ob Daten für deine Gemeinde vorliegen, aktuell gibt es Daten für folgende Gemeinden
    • Adliswil (adliswil)
    • Basel (basel)
    • Bassersdorf (bassersdorf)
    • Dübendorf (duebendorf)
    • Embrach (embrach)
    • Gossau ZH (gossau-zh)
    • Hombrechtikon (hombrechtikon)
    • Horgen (horgen)
    • Kilchberg (kilchberg)
    • Langnau a. A. (langnau)
    • Oberrieden (oberrieden)
    • Richterswil (richterswil)
    • Rüschlikon (rueschlikon)
    • St. Gallen (stgallen)
    • Thalwil (thalwil)
    • Uster (uster)
    • Wädenswil (waedenswil)
    • Wangen-Brüttisellen (wangen-bruttisellen)
    • Wetzikon (wetzikon)
    • Wiesendangen (wiesendangen)
    • Winterthur (winterthur)
    • Zürich (zurich)
  2. Abfallarten auswählen ACHTUNG: nicht alle Abfallarten sind in allen Gemeinden verfügbar
    • Bioabfall (organic) -> Alle
    • Kehricht (waste) -> Alle
    • Altpapier (paper)
    • Karton (cardboard)
    • Unbrennbares / Grubengut (incombustible)
    • Häkseldienst (chipping_service)
    • Grobmetall (metal)
    • Sperrmüll (bulky_goods)
    • Sondermüll (special)
    • eTram (etram) -> Zürich
    • CargoTram (cargotram) -> Zürich
  3. Gebiet auswählen, grössere Gemeinden sind oft in mehrere Gebiete aufgeteilt (1, 2, 3 / A, B, C / PLZ / Ost & West)
    • Adliswil -> keine Aufteilung
    • Basel -> Zone A-H
    • Bassersdorf -> keine Aufteilung
    • Dübendorf -> Kehrichtskreise 1-4
    • Embrach -> Ost und West
    • Gossau ZH -> Dorf + Aussenwachten
    • Hombrechtikon -> keine Aufteilung
    • Horgen -> Zone A-D
    • Kilchberg -> Zone A und B
    • Langnau -> keine Aufteilung
    • Oberrieden -> keine Aufteilung
    • Richterswil -> Zone A und B
    • Rüschlikon -> Zone A und B
    • St. Gallen -> Gebiets-ID A-K + L Ost und L West
    • Thalwil -> Zone A-C
    • Uster -> Kehrichtkreise 1-4
    • Wädenswil -> Zone A-D
    • Wangen-Brüttisellen -> keine Aufteilung
    • Wetzikon -> Kreise 1-4
    • Wiesendangen -> Dorf + Aussenwachten
    • Winterthur -> A + B (Altstadt) und Tour 1-9
    • Zürich -> Aufgeteilt nach Postleitzahl (PLZ)
  4. Format wählen, entweder JSON (calendar.json) oder ICS (calendar.ics).

Mit diesen Angaben, kann die korrekte URL zusammengesetzt werden:

Beispiel für Horgen (region=horgen), Zone B (area=B), Karton und Altpapier (types=cardboard&types=paper). Der Kalender soll auf Deutsch angezeigt werden (lang=de).

Als Format für den Kalender am besten ICS (calendar.ics) wählen, die so entstandene URL kann direkt in der Kalenderapplikation hinzugefügt werden. Wenn die Daten im API aktualisiert werden, so erscheinen die neuen Einträge automatisch im abonnierten Kalender.

https://openerz.metaodi.ch/api/calendar.ics?region=horgen&area=B&types=cardboard&types=paper&sort=date&lang=de

Daten als JSON beziehen

JSON ist gut geeignet um die Daten z.B. in einer App oder auf einer Webseite anzuzeigen. Um die Daten als JSON zu beziehen, muss das Format in der URL auf .json geändert werden. Alternativ kann auch via HTTP der Accept-Header Accept: application/javascript gesendet werden.

Beispiel:

https://openerz.metaodi.ch/api/calendar.json?region=horgen&area=B&types=cardboard&types=paper&sort=date&lang=de

Beispiele

Dieses API wird von einigen Anwendungen verwendet, hier zwei Beispiele:

ZüriCityGPT

ZüriCityGPT ist ein Chatbot für die Webseite der Stadt Zürich. U.a. kann dieser dank OpenERZ auch Fragen zu kommenden Entsorgungsterminen beantworten.

ZüriCityGPT

Altpapier Bot

Der Altpapier Bot ist ein Bot für den Messenger-Dienst Telegram. Ich kann einstellen, an welche Sammlung ich erinnert werden möchte und bekomme dann entsprechend eine Erinnerungsmeldung.

Altpapier Bot