Talk:Open311.org Draft Spec

2010-03-08T05:57:26Z

Zestyping: /* What is a service? */ new section

Has anyone looked at the proposed [http://www.omgstandard.com/techspec.php Open Municipal Geo-Data Standard]? Thoughts?

Here's a JSON sketch of possible POSTs and GETs

'''servicerequests.submit'''
<pre class="brush:jscript">
{
"open311": {
"serviceRequest": [
{
"id": "",
"status": "submitted",
"location": "148 Lafayette St, New York, NY 10013",
"location_type": "human_readable",
"input_url": "http://api.nyc.gov/311/servicerequests.submit",
"hub_url": "http://hub.open311.org/atom/",
"request": [
{
"author": "John Doe",
"author_email": "john@doe.com",
"submit_date": "2009-11-02T21:18Z",
"description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Quisque mattis mauris nibh. Ut tincidunt sapien condimentum ipsum adipiscing cursus. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Integer blandit vestibulum consequat. Cras feugiat sagittis magna, nec pretium justo pellentesque at. Suspendisse malesuada mauris id libero dapibus placerat. Aliquam a ante at augue tincidunt egestas non vitae dolor. Suspendisse dui felis, auctor venenatis fringilla vel, lobortis sit amet mi. Etiam mollis dictum justo, sed porttitor ante aliquet id. Donec consectetur accumsan erat quis fermentum.",
"metadata": [
{
"key1": "value1",
"key2": "value2"
}
]
}
],
"media": [
{
"image": [
{
"id": 324,
"url": "http://aws.amazon.com/345234/4addsf.jpg"
},
{
"id": 325,
"url": "http://aws.amazon.com/345234/5adsf.jpg"
}
]
}
]
}
]
}
}
</pre>

'''servicerequests.get'''
<pre class="brush:jscript">
{
"open311": {
"serviceRequest": [
{
"id": "54ASDadfgaF4",
"status": "open",
"location": "37.0625,-95.677068",
"location_type": "WGS84_latlong",
"input_url": "http://api.nyc.gov/311/servicerequests.submit",
"hub_url": "http://hub.open311.org/atom/",
"request": [
{
"author": "John Doe",
"submit_date": "2009-11-02T21:18Z",
"description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Quisque mattis mauris nibh. Ut tincidunt sapien condimentum ipsum adipiscing cursus. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Integer blandit vestibulum consequat. Cras feugiat sagittis magna, nec pretium justo pellentesque at. Suspendisse malesuada mauris id libero dapibus placerat. Aliquam a ante at augue tincidunt egestas non vitae dolor. Suspendisse dui felis, auctor venenatis fringilla vel, lobortis sit amet mi. Etiam mollis dictum justo, sed porttitor ante aliquet id. Donec consectetur accumsan erat quis fermentum.",
"metadata": [
{
"title": "Clogged storm drain",
"tags": "",
"customer_id": 234,
"open_date": "2009-11-03T11:18Z",
"jurisdiction_id": "10013.us",
"jurisdiction_name": "New York City 311",
"dependent_request_id": "65a4ds5f4",
"priority": 2,
"votes": 12,
"agency_id": "DEP",
"service_code": 54
}
]
}
],
"location": [
{
"WGS84_latlong": {
"lat": 37.0625000000001,
"long": -95.6770680000002
},
"source": "148 Lafayette St, New York, NY 10013",
"source_type": "human_readable",
"metadata": [
{
"address_id": 134123,
"location_proprietary": "foobar234235987",
"WGS84_accuracy": 0.23
}
]
}
],
"media": [
{
"image": [
{
"id": 324,
"url": "http://aws.amazon.com/345234/4addsf.jpg"
},
{
"id": 325,
"url": "http://aws.amazon.com/345234/5adsf.jpg"
}
]
}
]
}
]
}
}
</pre>

== What is a service? ==

Hello. Please see my comment at [[http://wiki.open311.org/Talk:San_Francisco#What_is_a_service.3F]]. I think the spec could be clarified by defining what "service" means.
[[User:Zestyping|Zestyping]] 05:57, 8 March 2010 (UTC)

Talk:San Francisco

2010-03-08T05:55:09Z

Zestyping: /* What is a service? */ new section

The discussion page for San Francisco 311 technology

== city_id should be domain name? ==

For the city_id, it looks like the existing practice is to use the city's '''domain name''' (e.g. "sfgov.org"), not the city's URL. I think the domain name is a better choice than the URL, and since this is also the existing practice, I suggest that the spec should say "domain name", both in the prose of the city_id section, and in the descriptions of the arguments to the "Select Service", "Create Request", and "Status Update" commands.
[[User:Zestyping|Zestyping]] 05:51, 8 March 2010 (UTC)

== What is a service? ==

I usually think of a "service" as something a government performs for its citizens. But in the "Select Service" section, all the "service_name" attributes don't describe city services at all; they describe problems. Should they describe services? Or conversely, should the API be expressed in terms of problems that need solving?
[[User:Zestyping|Zestyping]] 05:55, 8 March 2010 (UTC)

Talk:San Francisco

2010-03-08T05:51:58Z

Zestyping: /* city_id should be domain name? */ new section

Open311 - User contributions [en]

Talk:Open311.org Draft Spec

Talk:San Francisco

Talk:San Francisco