1 <!DOCTYPE html PUBLIC
"-//W3C//DTD XHTML 1.0 Strict//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
5 <title>Petter Reinholdtsen: Entries Tagged open311
</title>
6 <link rel=
"stylesheet" type=
"text/css" media=
"screen" href=
"http://people.skolelinux.org/pere/blog/style.css">
7 <link rel=
"alternate" title=
"RSS Feed" href=
"open311.rss" type=
"application/rss+xml">
13 <a href=
"http://people.skolelinux.org/pere/blog/">Petter Reinholdtsen
</a>
19 <p>Entries tagged "open311".
</p>
26 <a href=
"http://people.skolelinux.org/pere/blog/Initial_notes_on_adding_Open311_server_API_on_FixMyStreet.html">Initial notes on adding Open311 server API on FixMyStreet
</a>
34 <p>The last few days I have spent some time trying to add support for
35 the
<ahref=
"http://www.open311.org/">Open311 API
</a> in the
36 <a href=
"http://www.fiksgatami.no/">Norwegian FixMyStreet service
</a>.
37 Earlier I believed Open311 would be a useful API to use to submit
38 reports to the municipalities, but when I noticed that the
39 <a href=
"http://fixmystreet.org.nz/">New Zealand version
</a> of
40 FixMyStreet had implemented Open311 on the server side, it occurred to
41 me that this was a nice way to allow the public, press and
42 municipalities to do data mining directly in the FixMyStreet service.
43 Thus I went to work implementing the Open311 specification for
44 FixMyStreet. The implementation is not yet ready, but I am starting
45 to get a draft limping along. In the process, I have discovered a few
46 issues with the Open311 specification.
</p>
48 <p>One obvious missing feature is the lack of natural language
49 handling in the specification. The specification seem to assume all
50 reports will be written in English, and do not provide a way for the
51 receiving end to specify which languages are understood there. To be
52 able to use the same client and submit to several Open311 receivers,
53 it would be useful to know which language to use when writing reports.
54 I believe the specification should be extended to allow the receivers
55 of problem reports to specify which language they accept, and the
56 submitter to specify which language the report is written in.
57 Language of a text can also be automatically guessed using statistical
58 methods, but for multi-lingual persons like myself, it is useful to
59 know which language to use when writing a problem report. I suspect
60 some lang=nb,nn kind of attribute would solve it.
</p>
62 <p>A key part of the Open311 API is the list of services provided,
63 which is similar to the categories used by FixMyStreet. One issue I
64 run into is the need to specify both name and unique identifier for
65 each category. The specification do not state that the identifier
66 should be numeric, but all example implementations have used numbers
67 here. In FixMyStreet, there is no number associated with each
68 category. As the specification do not forbid it, I will use the name
69 as the unique identifier for now and see how open311 clients handle
72 <p>The report format in open311 and the report format in FixMyStreet
73 differ in a key part. FixMyStreet have a title and a description,
74 while Open311 only have a description and lack the title. I'm not
75 quite sure how to best handle this yet. When asking for a FixMyStreet
76 report in Open311 format, I just merge title an description into the
77 open311 description, but this is not going to work if the open311 API
78 should be used for submitting new reports to FixMyStreet.
</p>
80 <p>The search feature in Open311 is missing a way to ask for problems
81 near a geographic location. I believe this is important if one is to
82 use Open311 as the query language for mobile units. The specification
83 should be extended to handle this, probably using some new lat=, lon=
84 and range= options.
</p>
86 <p>The final challenge I see is that the FixMyStreet code handle
87 several administrations in one interface, while the Open311 API seem
88 to assume only one administration. For FixMyStreet, this mean a
89 report can be sent to several administrations, and the categories
90 available depend on the location of the problem. Not quite sure how
91 to best handle this. I've noticed
92 <a href=
"http://seeclickfix.com/open311/">SeeClickFix
</a> added
93 latitude and longitude options to the services request, but it do not
94 solve the problem of what to return when no location is specified.
95 Will have to investigate this a bit more.
</p>
97 <p>My distaste for web forums have kept me from bringing these issues
98 up with the open311 developer group. I really wish they had a email
99 list available via
<a href=
"http://www.gmane.org/">Gmane
</a> to use for
100 discussions instead of only
101 <a href=
"http://lists.open311.org/groups/discuss">a forum
<a/>. Oh,
102 well. That will probably resolve itself, one way or another. I've
103 also tried visiting the IRC channel #open311 on FreeNode, but no-one
104 seem to reply to my questions there. This make me wonder if I just
105 fail to understand how the open311 community work. It sure do not
106 work like the free software project communities I am used to.
</p>
113 Tags:
<a href=
"http://people.skolelinux.org/pere/blog/tags/english">english
</a>,
<a href=
"http://people.skolelinux.org/pere/blog/tags/fiksgatami">fiksgatami
</a>,
<a href=
"http://people.skolelinux.org/pere/blog/tags/open311">open311
</a>.
117 <div class=
"padding"></div>
119 <p style=
"text-align: right;"><a href=
"open311.rss"><img src=
"http://people.skolelinux.org/pere/blog/xml.gif" alt=
"RSS Feed" width=
"36" height=
"14"></a></p>
132 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2011/01/">January (
16)
</a></li>
134 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2011/02/">February (
6)
</a></li>
136 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2011/03/">March (
6)
</a></li>
138 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2011/04/">April (
6)
</a></li>
145 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2010/01/">January (
2)
</a></li>
147 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2010/02/">February (
1)
</a></li>
149 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2010/03/">March (
3)
</a></li>
151 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2010/04/">April (
3)
</a></li>
153 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2010/05/">May (
9)
</a></li>
155 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2010/06/">June (
14)
</a></li>
157 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2010/07/">July (
12)
</a></li>
159 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2010/08/">August (
13)
</a></li>
161 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2010/09/">September (
7)
</a></li>
163 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2010/10/">October (
9)
</a></li>
165 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2010/11/">November (
13)
</a></li>
167 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2010/12/">December (
12)
</a></li>
174 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2009/01/">January (
8)
</a></li>
176 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2009/02/">February (
8)
</a></li>
178 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2009/03/">March (
12)
</a></li>
180 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2009/04/">April (
10)
</a></li>
182 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2009/05/">May (
9)
</a></li>
184 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2009/06/">June (
3)
</a></li>
186 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2009/07/">July (
4)
</a></li>
188 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2009/08/">August (
3)
</a></li>
190 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2009/09/">September (
1)
</a></li>
192 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2009/10/">October (
2)
</a></li>
194 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2009/11/">November (
3)
</a></li>
196 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2009/12/">December (
3)
</a></li>
203 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2008/11/">November (
5)
</a></li>
205 <li><a href=
"http://people.skolelinux.org/pere/blog/archive/2008/12/">December (
7)
</a></li>
216 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/3d-printer">3d-printer (
13)
</a></li>
218 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/amiga">amiga (
1)
</a></li>
220 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/aros">aros (
1)
</a></li>
222 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/bitcoin">bitcoin (
2)
</a></li>
224 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/bootsystem">bootsystem (
10)
</a></li>
226 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/debian">debian (
49)
</a></li>
228 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/debian edu">debian edu (
63)
</a></li>
230 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/digistan">digistan (
7)
</a></li>
232 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/english">english (
89)
</a></li>
234 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/fiksgatami">fiksgatami (
9)
</a></li>
236 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/fildeling">fildeling (
11)
</a></li>
238 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/intervju">intervju (
9)
</a></li>
240 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/kart">kart (
14)
</a></li>
242 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/ldap">ldap (
8)
</a></li>
244 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/lenker">lenker (
4)
</a></li>
246 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/ltsp">ltsp (
1)
</a></li>
248 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/multimedia">multimedia (
12)
</a></li>
250 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/norsk">norsk (
121)
</a></li>
252 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/nuug">nuug (
116)
</a></li>
254 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/open311">open311 (
1)
</a></li>
256 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/opphavsrett">opphavsrett (
20)
</a></li>
258 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/personvern">personvern (
38)
</a></li>
260 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/reprap">reprap (
11)
</a></li>
262 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/rfid">rfid (
2)
</a></li>
264 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/robot">robot (
4)
</a></li>
266 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/rss">rss (
1)
</a></li>
268 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/sikkerhet">sikkerhet (
23)
</a></li>
270 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/sitesummary">sitesummary (
3)
</a></li>
272 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/standard">standard (
24)
</a></li>
274 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/stavekontroll">stavekontroll (
1)
</a></li>
276 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/surveillance">surveillance (
8)
</a></li>
278 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/video">video (
20)
</a></li>
280 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/vitenskap">vitenskap (
1)
</a></li>
282 <li><a href=
"http://people.skolelinux.org/pere/blog/tags/web">web (
15)
</a></li>