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), Northamptonshire County Council (representing the Office of the Deputy Prime Minister) and Transport for London, with the National Traffic Control Centre in an observing capacity.

SDEP Sources

Schema can be downloaded here:

Complete archive http://services.elgin.gov.uk/navteq/sdep-publication/schema/SDEP5_100525.rar 110kb

SDEP XSD Schema http://services.elgin.gov.uk/navteq/sdep-publication/schema/SDEP5_100525.xsd 24kb

Elgin Extension to the SDEP Schema http://services.elgin.gov.uk/navteq/sdep-publication/schema/Elgin_SDEP5_Extension.xsd 4kb

Includes http://services.elgin.gov.uk/navteq/sdep-publication/schema/www.govtalk.gov.uk dir

GML 3.1.1 Schema http://services.elgin.gov.uk/navteq/sdep-publication/schema/03-105r1_GML_3.1.1/ dir

GML Includes http://services.elgin.gov.uk/navteq/sdep-publication/schema/xlink/ dir

SOAP WSDL http://services.elgin.gov.uk/navteq/sdep-publication/sdep.asmx?wsdl

Web Service Method Description http://services.elgin.gov.uk/navteq/sdep-publication/sdep.asmx

RoadEventList

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

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

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

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

Description

Description of the event/works

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

Cause

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

The authority responsible for sending the information to Elgin

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

OrganisationName

The name of the organisation or authority

<OrganisationName>KENT</OrganisationName>

OrganisationID

The code for the authority or organisation

<OrganisationID>2275</OrganisationID>

Originator

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

The name of the works promoter <xml><OrganisationName>SOUTHERN GAS NETWORKS</OrganisationName></xml>

OrganisationID

The code for the works promoter

<OrganisationID>7270</OrganisationID>

OrganisationSectionID

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

<OrganisationSectionID>XW036</OrganisationSectionID>

OrganisationSectionName

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

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

OriginatorEventReference

Unique reference for the event/works.

<OriginatorEventReference>XW036W106824803-01877</OriginatorEventReference>

Location

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

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

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

StartDatim

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

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

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

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

<FootwayClosure>false</FootwayClosure>

ParkingSuspensions

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

<ParkingSuspensions>false</ParkingSuspensions>

gml:Polygon

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

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

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

The Unique Street Reference Number

<USRN>24200623</USRN>

OutOfHours

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

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

<Diversion>false</Diversion>

Impact

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

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

Moderate impact - delays likely

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 10mph or less.

works where the road is deemed traffic sensitive and there is traffic control

Slight impact - delays possible

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

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

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 false.

Completed

When the works/event is complete.

Cancelled

When the works/event is cancelled.

<PlannedStatus>Scheduled</PlannedStatus>

Requesting Xml

Street events Data Exchange Protocol
	File:Sdep.png Streetworks, with points, polylines and polygons.
Filename extension	.sdep or .xml
Internet media type	text/xml
Developed by	ELGIN
Initial release	7 April 2006
Latest release	5; May 2010; 15 years ago
Type of format	Roadworks, Geographic Information System
Extended from	XML, SOAP, GML, NLPG
Standard	http://interim.cabinetoffice.gov.uk
Free format?	yes
Website	[1]

Full-update request example

<!--
POST http://schemas.elgin.gov.uk/navteq/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

<!--
POST http://schemas.elgin.gov.uk/navteq/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

This computer networking article is a stub. You can help Wikipedia by expanding it.