In the previous blog post we explained why we think Open311 is a good idea. In this post we’ll explain what it actually does.
Open311 is very simple, but because it’s fundamentally a technical thing it’s usually explained from a technical point of view. So this post describes what Open311 does without the nerdy language (but with some nerdy references for good measure). At the end there’s a round-up of the terms so you can see how it fits in with the actual specification.
We’re using an unusual example here — a blue cat stuck up a tree — to show how applicable Open311 is to a wide range of problems. Or, to put it another way, this is not just about potholes.
So… someone has a problem they want to report (for this discussion, she’s using a service like FixMyStreet).
There’s one place where that report needs to be sent (in the UK, that’s your council). That administrative body (the council) almost certainly has a database full of problems which only their staff can access.
I have a problem :–(the “client”
I fix problems!the “server”
In this example, FixMyStreet is an Open311 client and the council is an Open311 server. The server is available over HTTP(S), so the client can access it, and the server itself connects to the council’s database. In reality it’s a little bit more complicated than that (for now we’ll ignore clients that implement only part of Open311, multiple servers, and decent security around these connections), but that is the gist of it.
Although it’s not technically correct to confuse the client with the user, or the server with the council, it makes things a lot easier to see it this way, so we’ll use those terms throughout.
To start things off, the client can ask the server: what services do you provide?
Until the client has asked the server what problems it can fix, it can’t sensibly request any of them.
What services do you offer?
POT: fix potholes
TELE: clean public teleports
PET: get pets down from trees
JET: renew jetpack licenses …
FixMyStreet can use the response it gets from such a service discovery to offer different categories to people reporting problems. We actually put them into the drop-down menu that appears on the report-a-problem page.
In the Open311 API, this is handled by
GET Service List. Each service has its own
service_codewhich the client must use when requesting it. Note that these services and their codes are decided by the server; they are not defined by the Open311 specification. This means that service discovery can easily fit around whatever services the council already offers. The list of services can (and does) vary widely from one council to the next.
Some services require specific information when they are requested. For example, it might be important to know how deep a pothole is, but it’s not relevant for a streetlight repair.
Tell me more about the PET service!
I can get pets down from trees, but when you request the service, you *must* tell me what kind of animal the pet is, OK?
In the Open311 API, this is handled by the
GET Service Definitionmethod. It’s not necessary for a simple Open311 implementation. In fact, it only makes sense if the service discovery explicitly told the client to ask about the extra details, which the server does by adding
metadata="true"to its response for a given service.
Requesting a service
This is where it gets useful. The client can request a service: this really means they can report a problem to the server for the body to deal with. Some submissions can be automatically rejected:
My hoverboots are broken :–( I need BOOT service!
404: Bzzzt error! I don’t fix hoverboots (use service discovery to see what I *do* fix)
Hey! Blueblue is up a tree! I need PET service (for cats)!
400: error! You forgot to tell me where it is.
If the report is in good order, it will be accepted into the system. Open311 insists that every problem has a location. In practice this is usually the exact position, coordinates on planet Earth, of the pin that the reporter placed on the map in the client application (in this case FixMyStreet.com).
I need PET service (for cats)! Blueblue is stuck up the biggest tree in the park :–(
200: OK, got it… the unique ID for your request is now 981276
In the Open311 API, this is handled by
POST Service Request. You need an API key to do this, which simply means the server needs to know which client this is. Sometimes it makes sense for the server to have additional security such as IP address restriction, and login criteria that’s handled by the machines (not the user).
Listing known requests
The server doesn’t keep its reports secret: if asked, it will list them out. The client can ask for a specific report (using the ID that the server gave when the report was submitted, for example) or for a range of dates.
Did anyone ask you for help yesterday?
Yes, I got two requests:
request 981299: TELE dirty teleport at the cantina (I’m waiting for a new brush)
request 971723: POT pothole at the junction of Kirk and Solo (I filled it in)
In the Open311 API this is handled by
GET Service Request(s). The client can indicate which requests should be listed by specifying the required service request id, service code, start date, end date or status.
Does Open311 work?
Oh yes. On the Open311 website, you can see the growing list of places, organisations, and suppliers who are using it.
The technical bit
In a nutshell: Open311 responds to HTTP requests with XML data (and JSON, if it’s wanted). There’s no messing around with SOAP and failures are reported as the HTTP status code with details provided in the content body.
You can see the specification for Open311 (GeoReport v2). It doesn’t feature blue cats, but if you look at the XML examples you’ll be able to recognise the same interaction described here. And remember the specification is an open standard, which means anyone can (and, we think, should) implement it when connecting a client and server in order to request civic services.
In the next blog post we’ll look at how FixMyStreet uses Open311 to integrate with local council systems, and explain why we’re proposing, and utilising, some additions to the Open311 specification.
Find out more about FixMyStreet for Councils
Illustrated especially for us by René Carbonell.
The Internet has thrown up a host of challenges for governments, large and small. Most people are familiar with the problems presented by issues like hacking, but there is another challenge which probably worries local governments just as much.
The challenge is this – how can a local government cheaply and efficiently cope with the fact that the public wants to request many services through a rapidly expanding plethora of different channels – phones, websites, email, apps, and Twitter? And how can it keep control of costs when new channels are being invented all the time?
The good news is there’s an answer that can prevent each new channel leading to ever-greater costs – a free technology called Open311. The bad news is not many people know it exists, let alone how to use it, or how it works.
In this post, and two more to follow, we’ll explain how Open311 can help governments (and citizens), how it functions, and what mySociety is doing to make Open311 work a bit better.
Background – the status quo
At mySociety, we’ve been running services for years that send messages of different kinds to government bodies, on behalf of our users. Since the very beginning we’ve always been keen that any public servant or politician who receives a message via one of our systems gets it in a familiar form that doesn’t require any special knowledge or training to read or reply to. That’s why for the first few years FixMyStreet sent all its problem reports via email, WhatDoTheyKnow sent all its FOI requests via email, and WriteToThem sent all its letters to politicians via email and fax (remember fax?).
However, despite the fact that reading and responding to emails doesn’t require governments to procure any new technology or any new skills, these days this approach can clearly be bettered. Today, an email report of a broken paving slab will typically be received by a public servant working in a call centre. This person will normally cut and paste text from the email into a new database, or into a new email, before dispatching it for someone else to consider, and action.
Now, imagine that instead of this, a problem report about a broken paving slab could be sent directly from a citizen and placed into the electronic to-do list for the local government team who fix paving slabs. This would do more than just cut costs – it would make it much easier for the citizen to get sent a notification when their problem is marked as ‘resolved’ in the official database.
This is not an original idea. The team at mySociety are not the only people who think that enabling citizens to directly slot requests, messages and problem reports into local government ‘to do’ databases is desirable. In the USA a group of civic minded technologists at OpenPlans were concerned by the same issue. They decided to do something about it – and they launched a project under the banner of Open311.
In the USA a number of cities have non-emergency government telephone helplines, accessible at the phone number 311. As a consequence ‘311’ has come to refer to more than just a phone line – it has come to mean the entire process of handling service requests from citizens around a whole range of non-emergency issues, from garbage to noisy neighbours.
To the ears of some American public servants the name ‘Open311’ consequently conjures up an image of a better, nicer more ‘open’ way of handling such non-emergency requests from citizens.
So what is Open311?
Beyond a brand, what is Open311? The answer is simple: Open311 is standardised way for computers to report problems (like potholes or fallen trees) to the computers run by the bodies that can fix them (like local governments or city departments). It’s an open standard that was started by the lovely people at OpenPlans, and which is now slowly iterating with the help of people inside and outside of governments.
In other words, Open311 is the mechanism through which citizens can slot their service requests directly into the computerised ‘to do’ lists of local government staff, and the way they those citizens can get back progress updates more quickly and easily.
Why is an Open Standard a good thing?
An open standard is just a way of communicating that anyone can implement it, without paying any money for permission to use the technology. The good thing about open standards is that once several technology systems start using the same ones, different systems from different manufacturers can talk to each other. When you phone someone else’s telephone, you are using an open standard – this means you don’t have to have the same brand of phone as the person at the other end.
What this means for a government is that if you can make your database of pothole reports speak to the outside world using Open311 then you don’t have to worry if reports are coming from two, ten or a thousands different websites or apps. You just run one system and it copes with all of them. This is not actually a new idea at all – local government call centres don’t worry what telephone network people are phoning from, or what brand of phone they are using.
However, it is a new idea in the realm of government IT systems for storing things like pothole repair requests, or school-admission applications. Traditionally these systems have not been set up to speak a common language with the outside world. Unfortunately, this failure to speak a common language has not always been by accident. Unscrupulous suppliers will sometimes intentionally set up systems so that the government has to pay extra money if they want any new channels to be added. Using Open311 is both a way to lower your future costs, and a way to make sure your current supplier can’t lock you into expensive upgrades.
Isn’t opening our systems to the outside a security nightmare?
Open311 is not about opening up private data, such as exposing the home addresses of vulnerable children. Open311 can be configured to open up government systems where that is appropriate, and everything that needs to stay private will stay private. There are no fundamental security problems to using an Open311 system.
Is this just about pothole reports?
No. Open311 isn’t limited to street-fixing services like FixMyStreet, even though that kind of problem is where Open311 started. As more and more public bodies offer their services online, they all face the same problem of spiralling costs as the public demands access through more and more diverse channels. In the future it should be possible to renew parking licenses, pay local taxes and do other complex transactions via Open311. But for today we encourage everyone interested to start at the simpler end of the scale.
How does mySociety use Open311?
When a local government anywhere in the world contracts mySociety to deliver a version of FixMyStreet for them (like Bromley, Barnet and Stevenage ) we recommend Open311.
We will still happily connect FixMyStreet to systems that don’t use Open311, but we always explain to clients that Open311 is the most desirable way of connecting their new FixMyStreet deployment with their current problem databases. We even offer lower prices to governments who use Open311.
We offer lower prices this partly because our costs go down, but also because we want to leave local governments with street-fault reporting systems that can connect not just to FixMyStreet, but to any new services in this area that emerge in the future. If Google maps or Twitter suddenly add street fault reporting, why should the local governments have to pay more money to handle those problems, when it could get them for free using Open311?
In short, we see Open311 as a solid foundation for building local government services without locking our clients into a relationship with mySociety as suppliers. In future we will also recommend the use of Open311 for services like ‘Please send me a new recycling bin’, ‘Please tell me what jobs you have open’ and ‘Please answer this FOI request’.
In the next post we’ll cover how Open311 works in a bit more detail (but still as clearly as we can), and in a third post we’ll explain how our work with FixMyStreet for Councils has led us to propose some improvements to the Open311 standard.
Find out more about FixMyStreet for Councils
Photo by Rupert Ganzer (CC)
If you’ve been following mySociety for a while, you’ll know that we have been interested in making maps that show commuting times for several years.
However, we’ve never made public a simple, free, useful version of our slidy-swooshy Mapumental journey times technology. Until today.
Today we pull the wraps off Mapumental Property , a house-hunting service covering England, Scotland and Wales, designed to help you work out where you might live if you want a public transport commute of a particular maximum duration. Have a go, and we guarantee you’ll find it an oddly compelling experience.
We think it’s a genuinely useful tool – especially since unlike some of the other players in this space, we’ve got all the different kinds of public transport, right across the whole of Great Britain. We hope that some of you will find it helpful when deciding where to live.
However, this launch doesn’t mean mySociety is bent on taking over the property websites sector. Mapumental Property isn’t a challenger to the likes of Rightmove, it’s a calling card – an advertisement for our skills – which we hope will help mySociety to attract people and organisations who want beautiful, useful web tools built for them.
In particular we’d like people interested in Mapumental to note that:
- We like to build attractive, usable web tools for clients of all kinds.
- We know how to use complex data to make simple, lovely things.
- We can do some mapping technology that others haven’t worked out yet.
If any of that is of interest, please get in touch, or read about our software development and consulting services.
I’d like to thank quite a few people for helping with this launch. Duncan Parkes was the lead developer, Matthew Somerville ably assisted. Jedidiah Broadbent did the design. The idea originally came from the late Chris Lightfoot, and me, Tom Steinberg. Francis Irving built the first version, and Stamen came up with the awesome idea of using sliders in the first place (and built some early tech). Kristina Glushkova worked on business development, and Zoopla’s API provides the property data. I’m also grateful to Ed Parsons of Google for very kindly giving us a hat tip when they built some technology that was inspired by Mapumental. Thanks to everyone – this has been a long time coming.
We’ll follow up soon with a post about the technology – and in particular how we got away from using Flash. It has been an interesting journey.
Quick question – don’t think too hard about it: what is Amazon?
At one level, Amazon is the world’s largest online retailer, a public company listed on the NASDAQ. At another level – the physical – it is a collection of over 50,000 employees, hundreds of warehouses and zillions of servers.
But for most people Amazon is fundamentally a website.
Sure, it’s an extremely impressive website that can send you parcels in the post, and which can relieve you of money with terrifying ease. But to most people the company has very little reality beyond the big white-blue-and-orange website and the brown cardboard packages.
The same process is happening to the bits of the government that I interact with – the physical reality of bricks and mortar and people and parks is starting to disappear behind the websites.
Government is increasingly a thing I don’t have any mental images of. I don’t know what my local council looks like, nor am I even clear where it is. I’m sure you all have plenty of interactions with HM Revenue and Customs, but do you know where it is or what it looks like?
Increasingly, when I form a mental image of a branch of government in my head, what I see is the website. What else am I supposed to picture?
Governments no longer just ‘own‘ websites, they are websites.
Heartless Bourgeois Pig
Wait! Stop shouting! I know how this sounds.
I am not so out of touch that I don’t know that there are plenty of people out there who are only too familiar with the physical manifestations of government. They see the government as manifested through prison, or hospital, or the job centre. They have no problem forming a vivid mental image of what government means: a waiting room, a queue, a social worker.
And I also know that most of the poorest people in the UK aren’t online yet. It’s one of the great challenges for our country in the next decade.
The majority of citizens don’t have deep, all encompassing, everyday interactions with the state – at most they drop their kids at school every day, or visit the GP a few times a year. That’s as physically close as they get.
To these people, interacting with government already feels somewhat like interacting with Amazon. It sends them benefits, passports, recycling bins, car tax disks from mysterious dispatch offices and it demands money and information in return. The difference is in emotional tone – the Amazon online interactions tend to be seamless, the government online interactions either painful or impossible – time to pick up the phone.
Increasingly, when a modern citizen looks at a government website, they’re literally seeing the state. And if what they see is ugly, confusing or down-right-broken, increasingly that’s how they’re going to see the state as a whole.
This change in public perception means that a previously marginal problem (bad websites) is now pointing towards a rather more worrying possibility. As government websites continue to fall behind private sector websites, governments will slowly look less and less legitimate – less and less like they matter to citizens, less and less like we should be paying any taxes to pay for them. Why pay for something you can’t even navigate?
It is time for the directors and CEOs of public bodies everywhere to wake up to this possibility, before the ideologues get hold of it.
Governments have the wrong management structures for a digital future
I don’t buy the argument that government websites are bad because all the ubermensch have gone off to work for the private sector. The public sector can often teach the private sector a lot about information design, like British road signs and tube maps, which are fantastic. And, of course, there’s the super team at Gov.uk, who represent the kind of change I’m writing about here.
The real difference is one of management structure and focus. At Amazon, CEO Jeff Bezos and his executive colleagues worry all the time about whether their site or app or Kindle are as good as the competitors. But in central and local governments around the world, the top bosses do not stress every day about whether the user experience of their website is up to scratch, or whether conversion rates are lower than desirable.
The main reason that they don’t worry is because their management boards don’t historically contain anyone whose job it is to worry about the performance of digital services. A council chief exec will worry about finance because their finance director will constantly be nagging them about money. But a council CEO won’t be worrying about whether 10,000 people left their website bitterly disappointed last week, because such issues are not ‘normal things to discuss’ at a board level.
Getting digital people to the top table
The solution, at least in the near term – is to recruit or promote people with digital remits and experience right to the top tier of decision making in government bodies. It means creating new roles like ‘CIO’ or ‘Head of Digital’ which have the same seniority as ‘Head of Adult Social Care’ or ‘Head of HR’. And it means empowering those people to make painful changes that are required to make digital services become brilliant and user-centric.
Clearly, this presents dangers. How do you know what powers to give the new role? How do you stop them damaging critical services? And, most problematic of all – how can you tell that a digital expert isn’t a charlatan? After all, they have niche expertise that you don’t have – how are you supposed to sniff them out?
The answer is that it isn’t easy, and that a lot of knowledge sharing and learning from mistakes will be required. As a shameless plug – we can help here – we can help vet candidates and define their roles in Britain and abroad. But none of this hides the fact that becoming digital – learning to run a public organisation that is a website, will be a fraught affair. The reward, though, is nothing less than helping to guarantee the ongoing legitimacy of government (quite apart from all the happier customers). To me that seems well worth going through some pain for.
If you live anywhere in Britain, it won’t have escaped your attention that it’s been raining a bit, recently.
This has been causing quite a bit of flooding. And when flooding happens, people need to know if it is going to affect them.
Unfortunately, the Environment Agency flood warning website leaves something to be desired. It is, quite frankly, a usability dogs’ breakfast, with problems including:
- It doesn’t answer the main question: Most users arriving at this page simply want to know if they might be in danger. The page should be all about answering that question.
- It is trying to serve national and local needs: Information about flooding across the whole country might be useful to journalists or civil servants, but it shouldn’t be the main element.
- Clutter, clutter: A massive grid of numbers which don’t really mean anything, plus lots of sidebar links.
- Confusing graphics: The page contains a national map which doesn’t actually make it clear that the colours relate to the seriousness of flooding, or that it provides links to further content.
There are also some non-design problems with the postcode lookup, but today we want to stick to just the design issues.
Not just moaning minnies
At mySociety we try to be constructive in our criticism, and so whilst the flood waters are still draining from many people’s homes, we thought that we could do something positive. We want to show that a flood warning page could be an exemplar of clear, user-centered information design. So we made a mockup.
Some of the improvements we’d like to point out are:
- A big page title that makes it obvious what this page is, and the fact that it is official information.
- All the main elements on the page are now focussed on the most likely needs of potential flood victims – journalists can follow a link to a different page for their needs.
- We’ve removed roughly 90% of the links on the page for clarity.
- We’ve removed all numerical data because it wasn’t adding value. Nobody can know if ‘5 warnings’ is a lot or a little without some context. As a nod to the overall context we’ve put in a simple graph, similar to a sparkline.
- It presents a clear button to click on if you’re actually endangered by a flood.
- It gives you a way to find out if other people near you are talking about local flooding via social media.
We hope you like this. It’s just the product of a couple of hours’ work, so if you have any suggestions on how it could be better, please let us know.
And, of course, we’re always happy to do similar work for other people.
How do you get everyone working together when the community needs it most – like when there’s a heavy snowfall?
Recently, we posted a conversation with Chris Palmer of Barnet Council, where he talked about integration of FixMyStreet with the council website.
Barnet also use another mySociety tool – Pledgebank – and Chris explained how it helps them within the Barnet communities.
Turning complaints into action
“We took on Pledgebank in the belief that the council needs to get out of people’s way. Online communities are good at complaining about things: it’s easy to get instant outrage on the web, and actually we need mechanisms that allow people to get together creatively.
“One of the issues we had during the heavy winter of 2010 was that people complained the council wasn’t coming round and clearing their paths. Well, the council never came round and cleared the pavement outside those particular houses.
“Many people said, well if the council allowed us to, we would do it ourselves. Pledgebank allowed us to get parents at 25 schools to sign up last year. They pledged to come and spread grit and clear the snow from outside just in return for free shovels and a ton of grit.
“That kind of thing encourages residents to be active, it frees them from the frustrations that the political system gives them. If people feel, ‘Oh, there’s a legal process stopping me doing this’, it moves the council forward, to being an enabler rather than a provider of services.
“A parent can spend 15 minutes in the morning and then be confident their child will be at school for the day and that they can go off to work, so for the parents, it’s win-win.
“One of the things that surprised us was the response of local residents who live in the street but don’t necessarily have children at the school. They felt that they should be helping to clear the snow. It gave a group of active residents who we hadn’t even asked, a chance to be involved”.
Tapping into community interest
Why do you think that is? Is it just that people just want to contribute within their community?
“I genuinely think people just aren’t interested in councils. I couldn’t tell you the name of my council leader where I live, never mind the name of cabinet members. However, I am very interested in the services the council provides: the only public meeting I’ve ever been to was about parking, because it directly affected my street. And I’d probably say there’s a rule, where people will take responsibility for the space outside their own house, and be prepared to extend that a few houses either side. And this just gives people a mechanism to be involved in their local community.
“With Pledgebank, we can leave people to do things amongst themselves, with the understanding that the council is not just a provider of services, but a catalyst to people doing those things themselves”.
What else have you done with Pledgebank?
“We’re hoping residents will play a part in keeping their streets tidy with our Adopt-a-Street scheme. There’s a real sense of ownership if somebody controls the green space outside their house: do they plant the bottom of trees in the street with wild flowers, do they plant bulbs in what’s currently a grass verge? We can give them that element of ownership, and give them control of their local environment.
“So with Adopt-a-Street, we found one or two people locally with an interest in doing it, and we’re looking now at how we encourage them to leaflet their neighbours, get in contact with their neighbours.
A challenge for the marketing department
“It’s worth adding, though, that Pledgebank has taken us a lot of learning. It’s quite easy to imagine that anything you bung up on the web suddenly becomes viral: it doesn’t.
“One of the challenges for us is how we link into what we’re doing, how we publicise what we’re doing with Pledgebank and the web. So we have to look at it not so much as, here’s an interesting web device, but here’s a device that enables residents to do things. But the council has a responsibility to publicise it.
“The key challenge for us is making information available to the relevant people. It’s all about defining communities, and making information available to those communities – and mySociety has been tremendously helpful with that.
“It’s changed the way we’re using our information now and it’s fair to say it’s informed how we’ve built our new website.”
Barnet have been inventive with Pledgebank. As well as using it during the snows, they’ve managed street parties for the Jubilee and Royal Wedding; got volunteers to give IT training to residents; and encouraged visits to carehomes.
If you’re from a council and you think Pledgebank might work for you, drop us a line to find out more.
Image credits: Snow Big Dig by Shashi Bellamkonda, Lakeside Daisy by Matt MacGillivray, and Diamond Jubilee Street Party on Kenyon Clough by Dave Haygarth, all used with thanks under the Creative Commons licence.