# Impact Apps

Support for schedules provided by [impactapps.com.au](https://impactapps.com.au/). ImpactApps are the creators of the platform used by several councils in Australia to provide waste collection schedules. The API is hosted as a subdomain of `waste-info.com.au` for each council.

Some of the supported councils are available at [calendars.impactapps.com.au](https://calendars.impactapps.com.au/), however, not all councils are listed there.

## Configuration via configuration.yaml

```yaml
waste_collection_schedule:
  sources:
    - name: impactapps_com_au
      args:
        service: COUNCIL_NAME or API URL
        property_id: PROPERTY_ID
        suburb: SUBURB
        street_name: STREET_NAME
        street_number: STREET_NUMBER
```

### Configuration Variables

**service**
*(string) (required)*

The service can be provided in 1 of 3 different ways:
1. Use the Council name (eg: `"Cowra Council"`)
2. Use the council component of the API url (eg: `"cowra"`)
3. User the full API url (eg: `"https://cowra.waste-info.com.au"`)

Currently supported councils and the argument options are given in the table below:

|#1: Council Name |#2: URL Component|#3: API URL|
|---|---|---|
|City of Ballarat|ballarat|https://ballarat.waste-info.com.au|
|Baw Baw Shire Council|baw-baw|https://baw-baw.waste-info.com.au|
|Bayside Council|rockdale|https://rockdale.waste-info.com.au|
|Benalla Rural City Council|benalla|https://benalla.waste-info.com.au|
|Bega Valley Shire Council|bega|https://bega.waste-info.com.au|
|Blue Mountains City Council|bmcc|https://bmcc.waste-info.com.au|
|Brisbane City Council|brisbane|https://brisbane.waste-info.com.au|
|Burwood City Council|burwood|https://burwood.waste-info.com.au|
|Campbelltown City Council|campbelltown|https://campbelltown.waste-info.com.au|
|City of Canada Bay Council|canada-bay|https://canada-bay.waste-info.com.au|
|Clarence Valley Council|clarence|https://clarence.waste-info.com.au|
|Coffs Coast Waste Services|coffs-coast|https://coffs-coast.waste-info.com.au|
|Cowra Council|cowra|https://cowra.waste-info.com.au|
|Cumberland City Council|cumberland|https://cumberland.waste-info.com.au|
|Forbes Shire Council|forbes|https://forbes.waste-info.com.au|
|Ku-ring-gai Council|ku-ring-gai|https://ku-ring-gai.waste-info.com.au|
|Gwydir Shire Council|gwydir|https://gwydir.waste-info.com.au|
|Gympie Regional Council|gympie|https://gympie.waste-info.com.au|
|Horsham Rural City Council|hrcc|https://hrcc.waste-info.com.au|
|Lithgow City Council|lithgow|https://lithgow.waste-info.com.au|
|Livingstone Shire Council|livingstone|https://livingstone.waste-info.com.au|
|Moira Shire Council|moira|https://moira.waste-info.com.au|
|Moree Plains Shire Council|moree|https://moree.waste-info.com.au|
|Murrindindi Shire Council|murrindindi|https://murrindindi.waste-info.com.au|
|Penrith City Council|penrith|https://penrith.waste-info.com.au|
|Port Macquarie Hastings Council|pmhc|https://pmhc.waste-info.com.au|
|Port Stephens Council|port-stephens|https://port-stephens.waste-info.com.au|
|Queanbeyan-Palerang Regional Council|qprc|https://qprc.waste-info.com.au|
|Redland City Council|redland|https://redland.waste-info.com.au|
|Snowy Valleys Council|snowy-valleys|https://snowy-valleys.waste-info.com.au|
|South Burnett Regional Council|south-burnett|https://south-burnett.waste-info.com.au|
|Wellington Shire Council|wellington|https://wellington.waste-info.com.au|
|Wollongong City Council|wollongong|https://wollongong.waste-info.com.au|

**property_id**
*(integer) (optional)*\
The property id can be found by inspecting the network traffic when using the council's website to find the schedule.


OR

**suburb**
*(string) (optional)*\
It must match the suburb of the address available via the calendar provided on the council's website.

**street_name**
*(string) (optional)*\
It must match the street name of the address available via the calendar provided on the council's website.

**street_number**
*(string) (optional)*\
It must match the street number of the address available via the calendar provided on the council's website.


## Examples (different configurations, same address)

```yaml
waste_collection_schedule:
  sources:
    - name: impactapps_com_au
      args:
        service: "Penrith City Council"
        suburb: "Emu Plains"
        street_name: "Beach Street"
        street_number: "3"
```
```yaml
waste_collection_schedule:
  sources:
    - name: impactapps_com_au
      args:
        service: "penrith"
        property_id: "14122"
```