From 2bc5c2811c113bd2eabdc918bfba2a620d5f585d Mon Sep 17 00:00:00 2001 From: FliesWithWind Date: Mon, 2 May 2022 14:51:11 +0200 Subject: [PATCH] Initial docs --- doc/source/warszawa19115_pl.md | 47 ++++++++++++++++++++++++++++++++++ info.md | 4 +++ 2 files changed, 51 insertions(+) create mode 100644 doc/source/warszawa19115_pl.md diff --git a/doc/source/warszawa19115_pl.md b/doc/source/warszawa19115_pl.md new file mode 100644 index 00000000..f10831f1 --- /dev/null +++ b/doc/source/warszawa19115_pl.md @@ -0,0 +1,47 @@ +# Banyule City Council + +Support for schedules provided by [Warszawa19115](https://warszawa19115.pl/harmonogramy-wywozu-odpadow). + +## Configuration via configuration.yaml + +```yaml +waste_collection_schedule: + sources: + - name: warszawa19115_pl + args: + street_address: STREET_ADDRESS +``` + +### Configuration Variables + +**street_address**
+*(string) (optional)* + +**geolocation_id**
+*(string) (optional)* + +At least one argument must be provided. + +## Example + +```yaml +waste_collection_schedule: + sources: + - name: warszawa19115_pl + args: + street_address: MARSZAŁKOWSKA 84/92, 00-514 Śródmieście +``` + +```yaml +waste_collection_schedule: + sources: + - name: warszawa19115_pl + args: + geolocation_id: 76802934 +``` + +## How to get the source arguments + +Visit the [Warszawa19115 - Harmonogram odbioru odpadów](https://warszawa19115.pl/harmonogramy-wywozu-odpadow) page and search for your address. The ```street_address``` argument should exactly match the street address shown in the autocomplete result. For unlisted addresses use an adjacent listed address. + +The ```geolocation_id``` argument can be used to bypass the initial address lookup on first use. This value can be discovered using the developer console in any modern browser and inspecting the request sent once an address is selected and the search button is clicked. The request URL takes the format: ```https://warszawa19115.pl/harmonogramy-wywozu-odpadow?p_p_id=portalCKMjunkschedules_WAR_portalCKMjunkschedulesportlet_INSTANCE_o5AIb2mimbRJ&p_p_lifecycle=2&p_p_state=normal&p_p_mode=view&p_p_resource_id=ajaxResourceURL&p_p_cacheability=cacheLevelPage&p_p_col_id=column-1&p_p_col_count=1```. diff --git a/info.md b/info.md index 07c8022c..9d670ffe 100644 --- a/info.md +++ b/info.md @@ -104,6 +104,10 @@ Currently the following service providers are supported: - [Gore, Invercargill & Southland](https://github.com/mampfes/hacs_waste_collection_schedule/blob/master/doc/source/wastenet_org_nz.md) - [Wellington](https://github.com/mampfes/hacs_waste_collection_schedule/blob/master/doc/source/wellington_govt_nz.md) +### Poland + +- [Warsaw](https://github.com/FliesWithWind/hacs_waste_collection_schedule/blob/master/doc/source/warszawa19115_pl.md) + ### Sweden - [Lerum.se](https://github.com/mampfes/hacs_waste_collection_schedule/blob/master/doc/source/lerum_se.md)