Service Request -id (alpha-numeric) -status ("open","closed","more info", "in progress") -location (location type) -data feed URL (atom feed subscription) -List of:

 -who (string)
 -activity date (date timestamp)
 -description (text blob)

Location -jurisdiction returns acceptable location schema (lat/lng, human readable address, internal ID) -location {

       lat/lng: GS84 (or what ever is the standard)
       human readable location (String blob?)
       3rd party addressing scheme (defined in meta data returned by jurisdiction)
   } 
   

Linking service requests ( serial/parallel ? ) -id { [id:status] }

Location Schema

Abstract

The Open311 API provides a way to work with service requests between citizens, governments and non-governmental organizations.

Open311 is decentralized. There is no central registry to which a providing system is required to register. There is also no central authority that lists the responsible Open311 providers for a particular location or set of concerns.

Open311 is intended to be applicable every where for all languages. The spec has been initially written in English with English terms solely for the convenience of the authors. All attempts were made to provide for the API to work for all language locales.

Open311 uses only standard HTTP requests and responses.

The Open311 API is a RESTful service. All GET requests are idempotent, they have no side effect other then returning data in a response to the client.

It is expected that multiple versions of the Open311 API will exist and interoperate concurrently. The spec is designed to allow service providers of different versions to be able to communicate together.

Terminology

Provider or Service Provider

The system on which the API calls are made. This is the system that is mapped to by the URIs that a client makes HTTP calls to.

Client

The entity or system from which API calls are made. This could be a citizen's browser, a third party computer system or another service provider.

Issue

A specific, geographically stationary, concern that has a concrete definable fix. Some common names include: service request, work order or ticket.

Citizen

Any natural person.

Non-Governmental Organization

An entity that is not a government.

Government

The organization that manages a political unit of any size.

Latitude / Longitude

All latitudes and longitude values MUST be WGS84 (World Geodetic System 1984) datum values expressed in decimal format. See http://en.wikipedia.org/wiki/WGS84

   Example: 37.40320,-121.977521