Optionally integrate with Geoclient API to add address-specific information

[riordan]

First of all: THANK YOU FOR THIS. I was shocked by the lack of NYC-specific Home Assistant integrations out there and this is a gamechanger. Starting my morning with the 311 calendar is like pouring my coffee and listening to WNYC.

There is another API the city offers, Geoclient, that offers most of what NYC knows about an address. This includes:

• Specific dates of sanitation collection for the address (which days are trash, recycling, bulk, organic) (addressing Sanitation Collection Day #1)
• Snowplow priority
• Local school district
• Election districts
• Fire department coverage
• Police department coverage

This provides the stable data for the address, which is modified by the 311 calendar you fetch.

[elahd]

Thanks!

I'm not sure of how useful Geoclient would be for this integration.

Sanitation: Geoclient provides regular collection schedules for every address, but it does not provide any info on rescheduled collection. That is, the API can tell us that your regular Monday collection won't happen because of Presidents' Day, but it doesn't tell us that Monday trash pickup was moved to Tuesday and Monday recycling pickup was moved to Sunday. There doesn't seem to be a formula for predicting rescheduled dates, and the DSNY's own website tells people to check their social media pages for updates! Integrating Geoclient would be a lot of extra work for a feature that only provides partial information. It would be confusing to show a "no exceptions" indicator for the aforementioned Sunday when, in fact, recycling is being picked up off-schedule.

Static Metadata: Is there any value in having Home Assistant show your election or school district?

Of course, I may be completely missing something. Thoughts?

[vjp23]

Following up on #1, wanted to share a Python library I created to check whether a date is a DSNY holiday: https://github.com/vjp23/DSNYHolidays