SDEP

From Wikipedia, the free encyclopedia
Jump to: navigation, search
Street events Data Exchange Protocol
Filename extension .sdep or .xml
Internet media type text/xml
Uniform Type Identifier (UTI) public.xml
Developed by ELGIN
Initial release 7 April 2006 (2006-04-07)
Latest release 5  / May 2010; 4 years ago (2010-05)
Type of format Markup language, data exchange, Geographic Information System
Extended from SGML, XML, SOAP, GML, NLPG
Standard http://interim.cabinetoffice.gov.uk
Open format? yes
Website http://www.elgin.org.uk or [1]

The SDEP (Street events Data Exchange Protocol) comprises an XML data schema and web service WSDL for exchanging information about streetworks, roadworks, and street events between systems.

ELGIN was funded by the UK NeSDS Government e-Standards Programme to conduct a consultation and convene meetings to define the requirements of a common data exchange protocol for streetworks registers and other systems handling street events data. SDEP was developed to allow the open exchange of such data between back office systems used by local authorities to manage their highway networks in order to enable e-Government and streetworks co-ordination.

The SDEP consultation group comprised ELGIN (Chair), Mayrise Ltd., Symology Ltd., Pitney Bowes Inc., Exor Corporation (Bentley Systems), Office of the Deputy Prime Minister and Transport for London, with the National Traffic Control Centre in an observing capacity.

SDEP Sources[edit]

Schema can be downloaded here:

RoadEventList[edit]

The data comes in a long list of RoadEvents and sits in a RoadEventList.

<!-- Example -->
<?xml version="1.0" encoding="utf-8"?>
<n1:RoadEventList xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:sch="http://www.ascc.net/xml/schematron" xmlns:bs7666="http://www.govtalk.gov.uk/people/bs7666" xmlns:osgb="http://www.ordnancesurvey.co.uk/xml/namespaces/osgb" xmlns:n2="http://www.govtalk.gov.uk/CM/gms-xs" xmlns:q1="http://www.w3.org/2001/XMLSchema" xmlns:gml="http://www.opengis.net/gml" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:apd="http://www.govtalk.gov.uk/people/AddressAndPersonalDetails" xmlns:core="http://www.govtalk.gov.uk/core" xmlns:pdt="http://www.govtalk.gov.uk/people/PersonDescriptives" xmlns:gms="http://www.govtalk.gov.uk/CM/gms" DateTimeGenerated="2011-05-26T18:09:37.1385011+01:00" IsChangeOnly="false" OrganisationID="7289" ServiceURL="http://www.jacobs.com" xmlns:n1="http://schemas.elgin.gov.uk/sdep/roadevents">
  <RoadEvent LastModified="2009-10-01T02:22:01">
    <Description>HV POWER CABLE TO BE ADOPTED BY EDF.  S50 LICENCE TO BE REVOKED ONCE CONFIRMATION THAT EDF HAVE ADOP...</Description>
    <Cause>
      <Roadworks>Roadworks</Roadworks>
    </Cause>
    <ResponsibleAuthority>
      <OrganisationName>BUCKINGHAMSHIRE</OrganisationName>
      <OrganisationID>0430</OrganisationID>
    </ResponsibleAuthority>
    <Originator>
      <OrganisationName>BUCKINGHAMSHIRE</OrganisationName>
      <OrganisationID>430</OrganisationID>
      <OrganisationSectionID>0001</OrganisationSectionID>
    </Originator>
    <OriginatorEventReference>BH001P000000002423</OriginatorEventReference>
    <Location>
      <LocationDescription>ELECTRICITY INTAKE STATION TO SITE BOUNDARY...</LocationDescription>
      <StartDatim Estimated="true">2009-02-23T00:00:00</StartDatim>
      <EndDatim Estimated="true">2014-02-22T23:59:59</EndDatim>
      <CarriagewayRestriction>None / signing only</CarriagewayRestriction>
      <FootwayClosure>false</FootwayClosure>
      <ParkingSuspensions>false</ParkingSuspensions>
      <gml:LineString gid="14435502.1" srsName="EPSG:WGS84" axisLabels="x y">
        <gml:posList srsDimension="2">-7.55729176027305 49.7667305378033</gml:posList>
      </gml:LineString>
      <gml:Point gid="14435502.1" srsName="EPSG:WGS84" srsDimension="2" axisLabels="x y">
        <gml:pos>-.839842024565897 51.8260666089754</gml:pos>
      </gml:Point>
      <USRN>1400010</USRN>
      <OutOfHours>false</OutOfHours>
      <Diversion>false</Diversion>
      <Impact>Delays likely</Impact>
    </Location>
    <PlannedStatus>Scheduled</PlannedStatus>
  </RoadEvent>
</n1:RoadEventList>

RoadEvent[edit]

Each event is described as a RoadEvent in the Xml.

  <RoadEvent LastModified="2011-05-16T08:27:00">
    <Description>Abandon 112m of 4 INCH Cast Iron Main and replace with 90mm PE.</Description>
    <Cause>
      <Roadworks>Roadworks</Roadworks>
    </Cause>
    <ResponsibleAuthority>
      <OrganisationName>KENT</OrganisationName>
      <OrganisationID>2275</OrganisationID>
    </ResponsibleAuthority>
    <Originator>
      <OrganisationName>SOUTHERN GAS NETWORKS</OrganisationName>
      <OrganisationID>7270</OrganisationID>
      <OrganisationSectionName>ASHFORD E728 (REPLACEMENT WORKS)</OrganisationSectionName>
      <OrganisationSectionID>XW036</OrganisationSectionID>
    </Originator>
    <OriginatorEventReference>XW036W106824803-01877</OriginatorEventReference>
    <Location>
      <LocationDescription>From Boxley Road to 13A Rock Road FW/CW</LocationDescription>
      <StartDatim Estimated="false">2011-05-13T00:00:00</StartDatim>
      <EndDatim Estimated="true">2011-06-17T23:59:59</EndDatim>
      <CarriagewayRestriction>None / signing only</CarriagewayRestriction>
      <FootwayClosure>false</FootwayClosure>
      <ParkingSuspensions>false</ParkingSuspensions>
      <gml:Polygon gid="25036880.2" srsName="osgb:BNG">
        <gml:exterior xsi:type="gml:exterior">
          <gml:LinearRing srsName="osgb:BNG" axisLabels="x y">
            <gml:posList xsi:type="gml:posList" srsDimension="10">576416 157014 576409 157004 576497 156943 576497 156951 576416 157014</gml:posList>
          </gml:LinearRing>
        </gml:exterior>
      </gml:Polygon>
      <gml:Point gid="25036880.2" srsName="osgb:BNG" srsDimension="2" axisLabels="x y">
        <gml:pos>576497 156943</gml:pos>
      </gml:Point>
      <USRN>24201877</USRN>
      <OutOfHours>false</OutOfHours>
      <Diversion>false</Diversion>
      <TemporaryTrafficOrder>false</TemporaryTrafficOrder>
      <Impact>Delays unlikely</Impact>
    </Location>
    <PlannedStatus>Scheduled</PlannedStatus>
  </RoadEvent>

LastModified[edit]

Date and time the event was last modified/updated with Elgin

<RoadEvent LastModified="2011-05-16T08:27:00"/>

Description[edit]

Description of the event/works

<Description>Abandon 112m of 4 INCH Cast Iron Main and replace with 90mm PE.</Description>

Cause[edit]

The cause of the roadevent.

This is currently restricted to the following values

  • Roadworks
  • RoutineMaintenance
  • PublicEvent
  • Obstruction
  • SurveyOrCheckPoint
  • Accident
  • Weather
  • Incident
  • Unknown

Unknown may include diversions, temporary traffic orders etc. which would not fall intio any of the other categories.

    <Cause>
      <Roadworks>Roadworks</Roadworks>
    </Cause>

ResponsibleAuthority[edit]

The authority responsible for sending the information to Elgin

<ResponsibleAuthority>
   <OrganisationName>KENT</OrganisationName>
   <OrganisationID>2275</OrganisationID>
</ResponsibleAuthority>

OrganisationName[edit]

The name of the organisation or authority

<OrganisationName>KENT</OrganisationName>

OrganisationID[edit]

The code for the authority or organisation

<OrganisationID>2275</OrganisationID>

Originator[edit]

The works promoter (organisation or authority) responsible for the event/works

    <Originator>
      <OrganisationName>SOUTHERN GAS NETWORKS</OrganisationName>
      <OrganisationID>7270</OrganisationID>
      <OrganisationSectionName>ASHFORD E728 (REPLACEMENT WORKS)</OrganisationSectionName>
      <OrganisationSectionID>XW036</OrganisationSectionID>
    </Originator>

OrganisationName[edit]

The name of the works promoter

<OrganisationName>SOUTHERN GAS NETWORKS</OrganisationName>

OrganisationID[edit]

The code for the works promoter

<OrganisationID>7270</OrganisationID>

OrganisationSectionID[edit]

The code for the section/area of the promoter. Not a mandatory field.

<OrganisationSectionID>XW036</OrganisationSectionID>

OrganisationSectionName[edit]

Name of the section/area of the promoter. Not a mandatory field.

<OrganisationSectionName>ASHFORD E728 (REPLACEMENT WORKS)</OrganisationSectionName>

OriginatorEventReference[edit]

Unique reference for the event/works.

<OriginatorEventReference>XW036W106824803-01877</OriginatorEventReference>

Location[edit]

The following fields define the location of the event/works. This includes when and where the event/works take place. There can be multiple sites(where) or phases(when) for an event/works.

    <Location>
      <LocationDescription>From Boxley Road to 13A Rock Road FW/CW</LocationDescription>
      <StartDatim Estimated="false">2011-05-13T00:00:00</StartDatim>
      <EndDatim Estimated="true">2011-06-17T23:59:59</EndDatim>
      <CarriagewayRestriction>None / signing only</CarriagewayRestriction>
      <FootwayClosure>false</FootwayClosure>
      <ParkingSuspensions>false</ParkingSuspensions>
      <gml:Polygon gid="25036880.2" srsName="osgb:BNG">
        <gml:exterior xsi:type="gml:exterior">
          <gml:LinearRing srsName="osgb:BNG" axisLabels="x y">
            <gml:posList xsi:type="gml:posList" srsDimension="10">576416 157014 576409 157004 576497 156943 576497 156951 576416 157014</gml:posList>
          </gml:LinearRing>
        </gml:exterior>
      </gml:Polygon>
      <gml:Point gid="25036880.2" srsName="osgb:BNG" srsDimension="2" axisLabels="x y">
        <gml:pos>576497 156943</gml:pos>
      </gml:Point>
      <USRN>24201877</USRN>
      <OutOfHours>false</OutOfHours>
      <Diversion>false</Diversion>
      <TemporaryTrafficOrder>false</TemporaryTrafficOrder>
      <Impact>Delays unlikely</Impact>
    </Location>

LocationDescription[edit]

A description of the site/phase for the event/phase

<LocationDescription>From Boxley Road to 13A Rock Road FW/CW</LocationDescription>

StartDatim[edit]

Start date and time for this site/phase. This also includes an Estimated description of whether the date is an estimate (true) or actual (false).

<StartDatim Estimated="false">2011-05-13T00:00:00</StartDatim>

EndDatim[edit]

End date and time for this site/phase. This also includes an Estimated description of whether the date is an estimate (true) or actual (false).

<EndDatim Estimated="true">2011-06-17T23:59:59</EndDatim>

CarriagewayRestriction[edit]

The restriction on the carriageway due to traffic management.

Values include

  • None / signing only
  • Traffic control (stop/go boards)
  • Traffic control (two-way signals)
  • Traffic control (multi-way signals)
  • Traffic control (give and take)
  • Traffic control (priority working)
  • Traffic control (convoy working)
  • Lane closure
  • Contra-flow
  • Road closure
<CarriagewayRestriction>None / signing only</CarriagewayRestriction>

FootwayClosure[edit]

Indicates whether the footway is closed(true) or not(false)

<FootwayClosure>false</FootwayClosure>

ParkingSuspensions[edit]

Indicates whether parking suspensions are in force (true) or not(false).

<ParkingSuspensions>false</ParkingSuspensions>

gml:Polygon[edit]

Describes the geometry of the site/phase if polygon information is available.

<!-- SDEP -->
<s:element ref="gml:Polygon"/>
<!-- GML -->
<element name="Polygon" type="gml:PolygonType" substitutionGroup="gml:_Surface"/>
<!-- Example -->
<gml:Polygon gid="25036880.2" srsName="osgb:BNG">
   <gml:exterior xsi:type="gml:exterior">
     <gml:LinearRing srsName="osgb:BNG" axisLabels="x y">
       <gml:posList xsi:type="gml:posList" srsDimension="10">576416 157014 576409 157004 576497 156943 576497 156951 576416 157014</gml:posList>
     </gml:LinearRing>
   </gml:exterior>
</gml:Polygon>

gml:LineString[edit]

Describes the geometry of the site/phase if polyline information is available.

<!-- SDEP -->
<s:element ref="gml:LineString"/>
<!-- GML -->
<element name="LineString" type="gml:LineStringType" substitutionGroup="gml:_Curve"/>
<!-- Example -->
<gml:LineString gid="25379177.10" srsName="osgb:BNG" axisLabels="x y">
  <gml:posList srsDimension="4">574559 156755 574527 156730</gml:posList>
</gml:LineString>

gml:Point[edit]

Point information for the site/phase.

<!-- SDEP -->
<s:element ref="gml:Point"/>
<!-- GML -->
<element name="Point" type="gml:PointType" substitutionGroup="gml:_GeometricPrimitive"/>
<!-- Example -->
<gml:Point gid="25379177.10" srsName="osgb:BNG" srsDimension="2" axisLabels="x y">
  <gml:pos>574559 156755</gml:pos>
</gml:Point>

USRN[edit]

The Unique Street Reference Number

<USRN>24200623</USRN>

OutOfHours[edit]

Describes if the work is to be done out of hours(true) if no information is available or the work is to take place in normal working hours this will be set to false.

<OutOfHours>false</OutOfHours>

Diversion[edit]

Indicates whether the event is a diversion(true) or not(false).

<Diversion>false</Diversion>

Impact[edit]

The impact of a roadwork is derived in Elgin and is categorised into Severe, Moderate, Slight or Minimal according to the following criteria:

Severe impact - severe delays likely[edit]

Applies to major works on motorways where the anticipated delay is greater than 30 minutes.

Moderate impact - delays likely[edit]

Applies in the following cases:

  • works on motorways where the anticipated delay is 10–30 minutes
  • works where there is a road closure or convoy working. Convoy working is a method of working in which traffic is brought to a halt in advance of roadworks using traffic control and is then led through the site past the works by a works vehicle at 10 mph or less.
  • works where the road is deemed traffic sensitive and there is traffic control
Slight impact - delays possible[edit]
  • Applies to works on motorways and trunk routes where the anticipated delay is less than 10 minutes, and to all other roadworks on roads that are deemed not to be traffic sensitive where the following traffic control measures are in use:
  • stop/go boards
  • two-way or multi-way traffic lights
  • contra-flow or lane closure
Minimal impact - delays unlikely[edit]

Applies to works on motorways and trunk routes where there is no anticipated delay, and to works on footways (pavements). All roadworks that have not been assigned an impact due to insufficient information are assigned to this category.

<Impact>Delays unlikely</Impact>

PlannedStatus[edit]

The status of the works includes the following

  • Unplanned
    • This includes incidents and accidents
  • Speculative
    • This includes forward planning information that may or may not happen.
  • Scheduled
    • Planned events/works. When the event/works has started the start date estimate will change from true to
  • Completed
    • When the works/event is complete.
  • Cancelled
    • When the works/event is cancelled.
<PlannedStatus>Scheduled</PlannedStatus>

Requesting Xml[edit]

Full-update request example[edit]

<!--
POST /sdep-publication/sdep.asmx HTTP/1.1
User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; MS Web Services Client Protocol 2.0.50727.3615)
Content-Type: text/xml; charset=utf-8
SOAPAction: "http://schemas.elgin.gov.uk/sdep/webservice/RequestPull"
Host: services.elgin.gov.uk
Content-Length: 1263
Expect: 100-continue
Connection: Keep-Alive
-->

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
        <soap:Header>
                <Authentication xmlns="http://schemas.elgin.gov.uk/sdep/webservice">
                        <User>user</User>
                        <Password>pass</Password>
                </Authentication>
        </soap:Header>
        <soap:Body>
                <RequestPull xmlns="http://schemas.elgin.gov.uk/sdep/webservice">
                        <RequestPullParameter DateTimeRequested="2011-05-26T18:13:00.21875+01:00" xmlns="http://schemas.elgin.gov.uk/sdep/roadevents">
                                <RequestCriteriaGroup>
                                        <RequestLocation>
                                                <Polygon srsName="WGS84" xmlns="http://www.opengis.net/gml">
                                                        <exterior xsi:type="exterior">
                                                                <LinearRing srsName="WGS84">
                                                                        <posList xsi:type="posList" srsDimension="10">-1.5 52.5 -1.5 51.5 0.5 51.5 0.5 52.5 -1.5 52.5</posList>
                                                                </LinearRing>
                                                        </exterior>
                                                </Polygon>
                                        </RequestLocation>
                                        <RequestTimeSpan StartDatim="2011-05-25T18:13:00.21875+01:00" EndDatim="2013-05-26T18:13:00.21875+01:00"/>
                                </RequestCriteriaGroup>
                                <ServiceURL>http://www.org.com</ServiceURL>
                                <Organisation>
                                        <OrganisationName>ORG</OrganisationName>
                                        <OrganisationID>0</OrganisationID>
                                </Organisation>
                        </RequestPullParameter>
                </RequestPull>
        </soap:Body>
</soap:Envelope>

Change-only request example[edit]

<!--
POST /sdep-publication/sdep.asmx HTTP/1.1
User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; MS Web Services Client Protocol 2.0.50727.3615)
Content-Type: text/xml; charset=utf-8
SOAPAction: "http://schemas.elgin.gov.uk/sdep/webservice/RequestPull"
Host: services.elgin.gov.uk
Content-Length: 1263
Expect: 100-continue
Connection: Keep-Alive
-->

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
        <soap:Header>
                <Authentication xmlns="http://schemas.elgin.gov.uk/sdep/webservice">
                        <User>user</User>
                        <Password>pass</Password>
                </Authentication>
        </soap:Header>
        <soap:Body>
                <RequestPull xmlns="http://schemas.elgin.gov.uk/sdep/webservice">
                        <RequestPullParameter DateTimeRequested="2011-05-26T18:13:00.21875+01:00" xmlns="http://schemas.elgin.gov.uk/sdep/roadevents">
                                <RequestCriteriaGroup>
                                        <RequestLocation>
                                                <Polygon srsName="WGS84" xmlns="http://www.opengis.net/gml">
                                                        <exterior xsi:type="exterior">
                                                                <LinearRing srsName="WGS84">
                                                                        <posList xsi:type="posList" srsDimension="10">-1.5 52.5 -1.5 51.5 0.5 51.5 0.5 52.5 -1.5 52.5</posList>
                                                                </LinearRing>
                                                        </exterior>
                                                </Polygon>
                                        </RequestLocation>
                                        <RequestChangeOnly ChangeOnlyRequestDatim="2010-05-12T11:35:34.140625+01:00"/>
                                </RequestCriteriaGroup>
                                <ServiceURL>http://www.org.com</ServiceURL>
                                <Organisation>
                                        <OrganisationName>ORG</OrganisationName>
                                        <OrganisationID>0</OrganisationID>
                                </Organisation>
                        </RequestPullParameter>
                </RequestPull>
        </soap:Body>
</soap:Envelope>

External links[edit]