Going one step further, we wanted to make all SeeClickFix storm-related reports available to any developers who want to leverage them for their own projects. To that end, we got connected early on with the #HurricaneHackers, a spontaneously connected group of software developers who were brainstorming and building online tools related to Hurricane Sandy. I want to take a moment to briefly outline the self-serve content partnership opportunities we presented to the tech community.
Content Options
For the purpose of leveraging SeeClickFix content for a storm-related hack/project, we currently have three options to choose from:
The self-serve SeeClickFix widget generator allows anyone who runs a website to take advantage of our content on their own website.  We have three types of widgets to choose from:
- Text widget (list only, optionally linking to a map widget landing page)
- Map widget, advanced (with issue list and report)
- Map widget, simple (to be deprecated)
To create a storm-related issue widget, you can use the filter by keyword feature to include only issues that mention the following:
Note, for these widgets related that to Hurricane Sandy, we will upgrade you to our premium ad-free platform at no charge.
2) RSS Feedshurricane,storm,sandy,flood,power,electricityYou can see live examples of SeeClickFix storm issue maps on The Huffington Post, NBC (Washington, Philadelphia, Connecticut), Boston.com, Philly.com, The Hour (Fairfield County, CT), and CT News Junkie.
Note, for these widgets related that to Hurricane Sandy, we will upgrade you to our premium ad-free platform at no charge.
We have a few different RSS feeds, each based off the URL slug of the place in question on our website. For example, the New York City SeeClickFix place page is seeclickfix.com/new-york), so the RSS feeds would be the following:
- Recent Issues: http://seeclickfix.com/new-york.rss
- Top Issues: http://seeclickfix.com/new-york/issues/top.rss
- Hot Issues: http://seeclickfix.com/new-york/issues/hot.rss
3) API
Obviously, for a custom software development project/mashup, you might need more flexibility than what it offered with our off-the-shelf widgets and RSS feeds. For these projects, we invite developers to take advantage of the SeeClickFix API.
For example, for a list of the most recently reported storm-related issues in a certain area (e.g. New York City), you could make one of the following API calls:
- JSON: http:seeclickfix.com/api/issues.json?at=New+York,+NY&sort=Issues.created_at&search=hurricane,storm,sandy,flood,power,electricity,%22tree%22
- XML: http://seeclickfix.com/api/issues.xml?at=New+York,+NY&sort=Issues.created_at&search=hurricane,storm,sandy,flood,power,electricity,%22tree%22
To retrieve details of a specific issue (e.g. "311 busy, nyc.gov website not working"), you could make one of the following API calls:
- JSON: http://seeclickfix.com/api/issues/260386.json
- XML: http://seeclickfix.com/api/issues/260386.xml
Ideas
Do you have ideas for a SeeClickFix storm-related hack project? Get in touch, we'll try to help in any way we can.Support
If you need direct assistance with leveraging SeeClickFix content for your website or project, please contact me at @zbeat or zack [at] seeclickfix [dot] com. Again, if you're using a widget related to the hurricane, be sure to reach out to have us remove the banner ads free of charge.-Zack
No comments:
Post a Comment