Add dataset for housing API

[patcon]

One of the TPL hackathon teams released a full project page complete with an API. @alexbelloni was hoping to see it added to this beta data portal.

http://alexandrebelloni.com/poh/doc/api.html

@alexbelloni would this be something you'd be willing to submit a pull request for? If it seems appropriate to you, you could file it under the "Civic Tech Toronto" organization. This is an existing entry for another dataset, so you could just copy it into a new file and customize it to your liking:

https://raw.githubusercontent.com/patcon/data.toronto.io/gh-pages/_datasets/city-hall-proceedings-api.md

[patcon]

So to clarify, I think you could include the API as a dataset if you wanted. and if you wanted to create a concise zone <-> neighborhood <-> ward mapping dataset, that would be extremely welcome as well...!

If the dataset could be the source of truth (ie. from which the API was derived), that would be even more amazing -- I've been trying to sell this idea to civic tech projects for awhile :) Basically, my suggestion is that the database that powered the API would be seeded/populated from the dataset you create. So then it wouldn't just be this dataset that's put out only for others, but that the spin-up of your own project depends on it. That approach strikes me as one where datasets are less likely to rot. I personally wish the city worked more like that, so I was hoping we could start leading by example with our civic tech projects...!

The city doesn't do this, but you could offer the dataset using the OKF data package format: http://specs.frictionlessdata.io/data-packages/

They have a subset tabular data package and JSON table schema. I need to do more reading to determine what makes most sense, but I think they have validators for each type, which should help

[alexbelloni]

Ok. I'll work it as soon as possible.

[alexbelloni]

Customized file content:

category: 'Locations and mapping / Development and infrastructure / Community services' maintainer: Alexandre Belloni Alves maintainer_email: alexbelloni@outlook.com notes: >- A Toronto instance of the Open Civic Data API, populated with data from the Housing Connections, Wellbeing Toronto, and City Planning Division maps. Information was extracted from EZHouz project (TPL Hackathon 2016). organization: Civic Tech Toronto resources: format: API name: EZHouz API - Toronto url: http://www.alexandrebelloni.com/poh/api/v1/zones format: HTML name: API Endpoint Documentation url: http://www.alexandrebelloni.com/poh/doc/api.html schema: default title: Housing Zone Radar API source: ?

I'm creating a concise mapping dataset, how you advised.

[patcon]

Looks good, but in the description, you mention Open Civic Data API, which is actually a separate project, not part of the template that we should be using here: http://docs.opencivicdata.org/en/latest/api/index.html

If you have time to create that concise dataset, it could perhaps be a "resource" entry here, or a new dataset, spending how you feel about it :)

[patcon]

And I think I may have given you a bad example dataset to copy from -- "category" is either a string or an array using the categories we have set up here: https://github.com/patcon/data.t0ronto.ca/blob/gh-pages/_data/categories.yml

It's used for dynamically filtering, like this: https://patcon.github.io/data.t0ronto.ca/datasets/?category=business

(the dataset I gave you uses a category no longer in that list, so I should fix that :)

Better example: https://raw.githubusercontent.com/patcon/data.toronto.io/gh-pages/_datasets/211-youth-services.md

[alexbelloni]

Better?

---

• category:
  • Locations and Mapping
  • Development and Infrastructure
• license: ''
• maintainer: Alexandre Belloni Alves
• maintainer_email: alexbelloni@outlook.com
• notes:
  Information extracted from EZHouz API (TPL Hackathon 2016), populated with data from Housing Connections, Wellbeing Toronto, and City Planning Division maps.
• organization: Civic Tech Toronto
• resources:
  • format: JSON
    name: Zones data
    url: http://www.alexandrebelloni.com/poh/api/v1/zoneradar
  • format: JSON
    name: A particular zone
    url: http://www.alexandrebelloni.com/poh/api/v1/zoneradar/{id}
  • format: JSON
    name: Districts
    url: http://www.alexandrebelloni.com/poh/api/v1/districtradar
  • format: JSON
    name: A particular district
    url: http://www.alexandrebelloni.com/poh/api/v1/districtradar/{id}
  • format: JSON
    name: Ward
    url: http://www.alexandrebelloni.com/poh/api/v1/wardradar
  • format: JSON
    name: A particular ward
    url: http://www.alexandrebelloni.com/poh/api/v1/wardradar/{id}
  • format: JSON
    name: Neighborhood
    url: http://www.alexandrebelloni.com/poh/api/v1/neighborhoodradar
  • format: JSON
    name: A particular neighborhood
    url: http://www.alexandrebelloni.com/poh/api/v1/neighborhoodradar/{id}
  • format: HTML
    name: API Documentation
    url: http://www.alexandrebelloni.com/poh/doc/api.html
• source: ?
• title: Housing Zone Radar API

---

[alexbelloni]

I made a website that shows some relationships by using the API:

http://alexandrebelloni.com/poh/radarapp/index.html

[patcon]

Let's talk in person tomorrow night! :)

[alexbelloni]

Unfortunately, I won't go to civic tech, today. Is it ok my dataset description, now? Maybe, we could talk about the API in a 10-minute meeting, this week, at a coffee shop.