Version: 0.3
Last Modified:
03/10/2012
Previous Version: api-bwq-reference-v0.2
Contact:
Environment
Agency Data Info <data.info@environment-agency.gov.uk>
This document details a web API for access to the live publication of Bathing Water Quality information published by the Environment Agency for bathing waters in England and Wales that are monitored in order to meet reporting obligations under the EU Bathing Water Directive.
Bathing waters are places, designated by legislation, where there is a statutory requirement to monitor and report on the quality of bathing waters during the bathing-water season. The bathing water season runs from early May through to the end of September each year. During the season, weekly samples are collected from about 500 sampling points associated with bathing-waters in England and Wales. The samples are assessed in a lab. The weekly assessment results are both published in their own right and are used to produce an annual compliance assessment of how well each bathing-water complies with the requirements of the EU Bathing Water Directive
See end of document .
The publication of bathing-water-quality information as linked data requires the creation or re-use of RDFS or OWL vocabularies both for quality assessment data and for supporting reference information about bathing-waters, their zones of influence and sampling-points.
Vocabulary,
Reference and Assessment Information
The diagram above illustrates the primary vocabularies and datasets components that comprise this linked data bathing water quality publication and their top level URI. Strictly, only the observation datasets contain bathing-water-quality information; the other components act as ‘infrastructure’ to enable its expression.
The diagram below summarises the vocabulary elements that are introduced in the following sections.
The vocabulary extract below (in turtle together with the diagram above illustrates the use of the cube vocabulary for in-season bathing-water sample assessments.
###############################################################
#
# Bathing water quality in-season sample assessment DSD.
#
###############################################################
:sampleDsd
a qb:DataStructureDefinition ;
rdfs:comment "A DSD for reporting Bathing Water Quality in-season samples."@en ;
rdfs:label "sampleAssessmentDsd"@en;
rdfs:isDefinedBy bwq-ttl:,bwq-rdf:;
qb:component [qb:dimension :bathingWater],
[qb:dimension :samplingPoint],
[qb:dimension :sampleWeek],
[qb:dimension :sampleYear],
[qb:measure :totalColiformCount], [qb:attribute :totalColiformQualifier],
[qb:measure :faecalColiformCount], [qb:attribute :faecalColiformQualifier],
[qb:measure :faecalStreptococciCount], [qb:attribute :faecalStreptococciQualifier],
[qb:measure :entrovirusCount], [qb:attribute :entrovirusQualifier],
####################################################
## New counts/qualifiers for RBWD
####################################################
[qb:measure :intestinalEnterococciCount],
[qb:attribute :intestinalEnterococciQualifier],
[qb:measure :escherichiaColiCount], [qb:attribute :escherichiaColiQualifier],
####################################################
[qb:measure :salmonellaPresent],
[qb:measure :sampleClassification],
[qb:attribute :sampleDateTime],
[qb:attribute :abnormalWeatherException],
[qb:attribute :recordStatus],
[qb:attribute :recordDate];
qb:sliceKey :bySamplingPointKey,
:byWeekKey,
:byYearKey,
:bySamplingPointYearKey;
.
Likewise the following fragment illustrates the cube data structure for annual compliance assessments
###############################################################
#
# Annual bathing water compliance DSD.
#
###############################################################
:complianceDsd
a qb:DataStructureDefinition;
rdfs:comment "A DSD for Bathing Water Quality Annual Compliance assessment reporting."@en;
rdfs:label "bwq annual compliance DSD"@en;
rdfs:isDefinedBy <>,bwq-rdf:;
qb:component [qb:dimension :bathingWater],
[qb:dimension :samplingPoint],
[qb:dimension :sampleYear],
[qb:measure :complianceClassification],
[qb:attribute :inYearDetail];
qb:sliceKey :complianceByYearKey,
:complianceBySamplingPointKey;
.
The major reference entities to which bathing-water-quality information needs to refer are the bathing-waters themselves and their sampling points. In addition we provide access to a zone-of-influence which indicates a region associated with a bathing-water where rain-fall may have a significant effect on water quality.
The following URI patterns are used to designate instances of the given class, but bear in mind that whilst they may provide useful 'hint’s URI are in-general considered to be opaque (see cooluris.
Class | URI Pattern | Example URI |
---|---|---|
BathingWater | http://environment.data.gov.uk/id/bathing-water/{eubwid} | http://environment.data.gov.uk/id/bathing-water/ukl1702-36800 |
SamplingPoint | http://location.data.gov.uk/so/ef/SamplingPoint/bwsp.eaew/{samplePointId} | http://location.data.gov.uk/so/ef/SamplingPoint/bwsp.eaew/36800 |
ZoneOfInfluence | http://location.data.gov.uk/so/ef/ZoneOfInfluence/bwzoi.eaew/{eubwid}:{version} | http://location.data.gov.uk/so/ef/ZoneOfInfluence/bwzoi.eaew/ukl1702-36800:1 |
New as of v0.2 | ||
Envelope | http://location.data.gov.uk/so/common/Envelope/bwpf.eaew/{eubwid}:{version} | http://location.data.gov.uk/so/common/Envelope/bwpf.eaew/ukl1702-36800:1 |
Property Short Name | Description | Property URL |
---|---|---|
eubwidNotation | The EU bathing-water id of a bathing-water | http://environment.data.gov.uk/def/bathing-water/eubwidNotation |
samplingPoint | A property for associating something, in this case a bathing-water, with a bathing-water sampling point with something else, | http://location.data.gov.uk/def/ef/SamplingPoint/samplingPoint |
zoneOfInfluence | A property for associating something, in this case a bathing-water, with a zone of influence spatial object | http://location.data.gov.uk/def/ef/ZoneOfInfluence/zoneOfInfluence |
uriSet | The URI Set that a thing, in this case a bathing-water, is a member of. | http://reference.data.gov.uk/def/reference/uriSet |
district | A reusable property used here to associate a bathing-water with its local authority district. | http://statistics.data.gov.uk/def/administrative-geography/district |
sameAs | A property for indicating things (bathing-waters in this case) that are identical. e.g.that multiple URI that refer to the same bathing water e.g.: http://environment.data.gov.uk/id/bathing-water/spittal and http://environment.data.gov.uk/id/bathing-water/ukc2102-03600 | http://www.w3.org/2002/07/owl#sameAs |
label | One or more names, in this case for a bathing-water. | http://www.w3.org/2000/01/rdf-schema#label |
name | A property for indicating the preferred name of a thing. At most one preferred name may be given per language. English and Welsh language variants are relevant in the case of this dataset. | http://www.w3.org/2004/02/skos/core#prefLabel |
latestSampleAssessment | Associates a bathing-water with its most recent in-season sample assessment | http://environment.data.gov.uk/def/bathing-water-quality/latestSampleAssessment |
latestComplianceAssessment | Associates a bathing-water with its most recent annual compliance assessment | http://environment.data.gov.uk/def/bathing-water-quality/latestComplianceAssessment |
New as of v0.2 | ||
waterQualityImpactedByHeavyRain | A boolean valued indicator of whether (true) or not (false) bathing water quality at the bathing-water is adversely affected by heavy rainfall within the corresponding zone of influence. | http://environment.data.gov.uk/def/bathing-water/waterQualityImpactedByHeavyRain |
type | More detailed typing of bathing-waters using additional sub-classes of BathingWater (CoastalBathingWater, TransitionalBathingWater, LakeBathingWater or InlandBathingWater. | http://www.w3.org/1999/02/22-rdf-syntax-ns#type |
country | A reference to the country (eg. England, Wales or Scotland associated with the bathing-water. | http://statistics.data.gov.uk/def/administrative-geography/country |
county | A reference to the County (or Unitary Authority) associated with a bathing-water | http://statistics.data.gov.uk/def/administrative-geography/county. |
envelope | A reference to an Envelope that conveys map bounds for use in presenting a map of the locale of a bathing-water. | http://location.data.gov.uk/def/common/Geometry/envelope |
regionalOrganization | A reference to the regional organisation responsible for monitoring the water quality at a bathing-water. Typically this will refer to an Environment Agency regional office, however this is likely to vary across the UK. | http://environment.data.gov.uk/def/bathing-water/regionalOrganization |
sedimentTypesPresent | A multi-valued property that conveys an indication of the main sediment types that are to be found at a bathing-water (marsh, mud, rock, sand, shingle or other. | http://environment.data.gov.uk/def/bathing-water/sedimentTypesPresent |
yearDesignated | A reference to the CalendarYear in which a bathing-water was designated as such. | http://environment.data.gov.uk/def/bathing-water/yearDesignated |
yearDedesignated | A reference to the CalendarYear in which a bathing-water was de-designated. | http://environment.data.gov.uk/def/bathing-water/yearDedesignated |
Property Short Name | Description | Property URL |
---|---|---|
easting | The OSGB easting. | http://data.ordnancesurvey.co.uk/ontology/spatialrelations/easting |
northing | The OSGB northing. | http://data.ordnancesurvey.co.uk/ontology/spatialrelations/northing |
lat | The WGS84 latitude. | http://www.w3.org/2003/01/geo/wgs84_pos#lat |
long | The WGS84 longitude. | http://www.w3.org/2003/01/geo/wgs84_pos#long |
bathingWater | A property for associating something, in this case a sampling-point, with a bathing-water. | http://environment.data.gov.uk/def/bathing-water/bathingWater |
samplePointNotation | The Environment Agency sampling point code of a sampling point | http://location.data.gov.uk/def/ef/SamplingPoint/samplePointNotation |
uriSet | The URI Set that a thing, in this case a sampling-point, is a member of. | http://reference.data.gov.uk/def/reference/uriSet |
district | A reusable property used here to associate a sampling-point with its local authority district. | http://statistics.data.gov.uk/def/administrative-geography/district |
label | One or more names, in this case for a sampling-point. | http://www.w3.org/2000/01/rdf-schema#label |
name | A property for indicating the preferred name of a thing. At most one preferred name may be given per language. English and Welsh language variants are relevant in the case of this dataset. | http://www.w3.org/2004/02/skos/core#prefLabel |
Property Short Name | Description | Property URL |
---|---|---|
bathingWater | A property for associating something, in this case a zone-of-influence, with a bathing-water. | http://environment.data.gov.uk/def/bathing-water/bathingWater |
samplingPoint | A property for associating something, in this case a zone-of-influence, with a bathing-water sampling point. | http://location.data.gov.uk/def/ef/SamplingPoint/samplingPoint |
zoiNotation | A zone-of-influence identifier derived from the EU bathing-water id of the corresponding bathing-water. | http://location.data.gov.uk/def/ef/ZoneOfInfluence/zoiNotation |
uriSet | The URI Set that a thing, in this case a zone-of-influence, is a member of. | http://reference.data.gov.uk/def/reference/uriSet |
extent | A reusable property for associating something, a zone-of-influence with its AbstractGeometry. | http://data.ordnancesurvey.co.uk/ontology/geometry/extent |
extent.asGML | A property associated with an a GML literal with an AbstractGeometry. | http://data.ordnancesurvey.co.uk/ontology/geometry/asGML |
label | One or more names, in this case for a zone-of-influence. | http://www.w3.org/2000/01/rdf-schema#label |
name | A property for indicating the preferred name of a thing. At most one preferred name may be given per language. English and Welsh language variants are relevant in the case of this dataset. | http://www.w3.org/2004/02/skos/core#prefLabel |
The bounding box for the map extent showing the locale of a bathing water is expressed as an Envelope illustrated in the diagram below.
Geometry properties Online-version
Property Short Name | Description | Property URL |
---|---|---|
dimensions | The number of coordinate dimensions used in expressing a Geometry. | http://location.data.gov.uk/def/common/Geometry/dimensions |
srs | The spatial reference system used in teh expression of a Geometry. For example the UK Ordnace Survey National Grid (OSGB-36) is referenced as http://www.opengis.net/def/crs/EPSG/0/27700. | http://location.data.gov.uk/def/common/Geometry/srs |
Point properties Online-version
Property Short Name | Description | Property URL |
---|---|---|
x-coord | x-coordinate of a Point position in the associated spatial reference system. For OSGB-36 this corresponds to an easting | http://location.data.gov.uk/def/common/Geometry/x |
y-coord | y-coordinate of a Point position in the associated spatial reference system. For OSGB-36 this corresponds to a northing | http://location.data.gov.uk/def/common/Geometry/y |
z-coord | z-coordinate of a Point position in the associated spatial reference system. | http://location.data.gov.uk/def/common/Geometry/z |
Envelope properties Online-version
Property Short Name | Description | Property URL |
---|---|---|
lowerCorner | The corner of an Envelope where all the coordinates are at their minimum value. | http://location.data.gov.uk/def/common/Geometry/lowerCorner |
upperCorner | The corner of an Envelope where all the coordinates are at their maximum value. | http://location.data.gov.uk/def/common/Geometry/upperCorner |
asGML | A property associated with an a GML literal with an AbstractGeometry | http://data.ordnancesurvey.co.uk/ontology/geometry/asGML |
Class | URI Pattern | Example URI |
---|---|---|
SampleAssessment | http://environment.data.gov.uk/data/bathing-water-quality/in-season/sample/point/{samplePointId}/date/{sampleDate}/time/{sampleTime}/recordDate/{recordDate} | http://environment.data.gov.uk/data/bathing-water-quality/in-season/sample/point/04200/date/20080625/time/000700/recordDate/20080625 |
ComplianceAssessment | http://environment.data.gov.uk/data/bathing-water-quality/compliance/point/{samplePointId}/year/{year} | http://environment.data.gov.uk/data/bathing-water-quality/compliance/point/03600/year/1988 |
In addition to the main entities above, there are a number of dataset slices which collect in-season and annual compliance assessments into convenient groupings.
Class | URI Pattern | Example URI |
---|---|---|
In-Season LatestSampleSlice |
http://environment.data.gov.uk/data/bathing-water-quality/in-season/slice/latest | http://environment.data.gov.uk/data/bathing-water-quality/in-season/slice/latest |
In-Season ByYearSlice |
http://environment.data.gov.uk/data/bathing-water-quality/in-season/slice/year/{year} | http://environment.data.gov.uk/data/bathing-water-quality/in-season/slice/year/2010 |
In-Season BySamplingPointSlice |
http://environment.data.gov.uk/data/bathing-water-quality/in-season/slice/point/{samplePointId} | http://environment.data.gov.uk/data/bathing-water-quality/in-season/slice/point/05300 |
In-Season BySamplingPointYearSlice |
http://environment.data.gov.uk/data/bathing-water-quality/in-season/slice/point/{samplePointId}/year/{year} | http://environment.data.gov.uk/data/bathing-water-quality/in-season/slice/point/05300/year/2008 |
In-Season ByWeekSlice |
http://environment.data.gov.uk/data/bathing-water-quality/in-season/slice/week/{yearWeek} | http://environment.data.gov.uk/data/bathing-water-quality/in-season/slice/week/2000-W30 |
Annual ComplianceBySamplingPointSlice |
http://environment.data.gov.uk/data/bathing-water-quality/compliance/slice/point/{samplePointId} | http://environment.data.gov.uk/data/bathing-water-quality/compliance/slice/point/03600 |
Annual ComplianceByYearSlice |
http://environment.data.gov.uk/data/bathing-water-quality/compliance/slice/year/{year} | http://environment.data.gov.uk/data/bathing-water-quality/compliance/slice/year/2009 |
Property Short Name | Description | Property URL |
---|---|---|
abnormalWeatherException | Boolean valued indication of whether an exception waiver applies (true) or not (false) to a sample-assessment | http://environment.data.gov.uk/def/bathing-water-quality/abnormalWeatherException |
bwq_bathingWater | Link to the bathing-water from which the sample was taken. | http://environment.data.gov.uk/def/bathing-water-quality/bathingWater |
bwq_samplingPoint | Link to the sampling-point from which the sample was taken. | http://environment.data.gov.uk/def/bathing-water-quality/samplingPoint |
sampleDateTime | The date and time at which the same sample was taken. | http://environment.data.gov.uk/def/bathing-water-quality/sampleDateTime |
sampleWeek | The week for which the sample is representative. | http://environment.data.gov.uk/def/bathing-water-quality/sampleWeek |
sampleYear | The year for which the sample is representative. | http://environment.data.gov.uk/def/bathing-water-quality/sampleYear |
recordDate | The date of record for the assessment. The assessment may have a recordStatus which may be new for a first assessment of a sample, replacement for a replacement assessment of the same sample, or withdrawal which withdraws all earlier assessments of the same water sample. | http://environment.data.gov.uk/def/bathing-water-quality/recordDate |
recordStatus | The status of sample assessment record, which may be new for a first assessment of a sample, replacement for a replacement assessment of the same sample, or withdrawal which withdraws all earlier assessments of the same water sample. | http://environment.data.gov.uk/def/bathing-water-quality/recordStatus |
entrovirusCount | The number of colonies of entro virus grown per 100ml water sample. | http://environment.data.gov.uk/def/bathing-water-quality/entrovirusCount |
entrovirusQualifier | moreThan, lessThan or actual count qualifier for entrovirusCount. | http://environment.data.gov.uk/def/bathing-water-quality/entrovirusQualifier |
faecalColiformCount | The number of colonies of faecal coliform grown per 100ml water sample. | http://environment.data.gov.uk/def/bathing-water-quality/faecalColiformCount |
faecalColiformCountQualifier | moreThan, lessThan or actual count qualifier for faecalColiformCount. | http://environment.data.gov.uk/def/bathing-water-quality/faecalColiformCountQualifier |
faecalStreptococciCount | The number of colonies of faecal streptococci grown per 100ml water sample. | http://environment.data.gov.uk/def/bathing-water-quality/faecalStreptococciCount |
faecalStreptococciCountQualifier | moreThan, lessThan or actual count qualifier for faecalStreptococciCount. | http://environment.data.gov.uk/def/bathing-water-quality/faecalStreptococciCountQualifier |
salmonellaPresent | Salmonella present indicator for the sample assessement which may be: present, not-present or not-assessed . | http://environment.data.gov.uk/def/bathing-water-quality/salmonellaPresent |
totalColiformCount | The total number of colonies of coliform grown per 100ml water sample. | http://environment.data.gov.uk/def/bathing-water-quality/totalColiformCount |
totalColiformQualifier | moreThan, lessThan or actual count qualifier for totalColiformCount. | http://environment.data.gov.uk/def/bathing-water-quality/totalColiformQualifier |
sampleClassification | In season bathing water sample assessment classification:
Pre-2012 classifications C(closed), G(Higher) formerly G(Excellent), I(Minimum) formerly I(Good), F(Fail) formerly F(Poor), N(Not classified) 2012-2014 rBWD transitional classifications C(closed), G(Higher), I(Minimum), F(Fail), N(Not classified) Note that each group of classifications use different URI. |
http://environment.data.gov.uk/def/bathing-water-quality/sampleClassification |
created | The date or dateTime when the RDF record of the sample assessment was created. | http://purl.org/dc/terms/created |
source | Link source file and record for the sample assessment | http://purl.org/dc/terms/source |
dataSet | Link to the Cube DataSet that contains the sample-assessment | http://purl.org/linked-data/cube#dataSet |
New as of v0.2 | ||
intestinalEnterococciCount | The number of colonies of intenstinal enterococci grown per 100ml water sample | http://environment.data.gov.uk/def/bathing-water-quality/intestinalEnterococciCount |
intestinalEnterococciQualifier | moreThan, lessThan or actual count qualifier for intestinalEnterococciCount. | http://environment.data.gov.uk/def/bathing-water-quality/intestinalEnterococciQualifier |
escherichiaColiCount | The number of colonies of escherichia coli grown per 100ml water sample | http://environment.data.gov.uk/def/bathing-water-quality/escherichiaColiCount |
escherichiaColiQualifier | moreThan, lessThan or actual count qualifier for escherichiaColiCount. | http://environment.data.gov.uk/def/bathing-water-quality/escherichiaColiQualifier |
New as of v0.3 | ||
followingSuspension | A link to an immediately following suspension-of-monitoring record in the same assessment season, if any. | http://environment.data.gov.uk/def/bwq-som/followingSuspension |
priorSuspension | A link to an immediately previous suspension-of-monitoring record in the same assessment season, if any. | http://environment.data.gov.uk/def/bwq-som/priorSuspension |
Dataset slices have key properties whose value is the same for all observations (SampleAssessments or ComplianceAssessments) associated with the slice by the qb:observation (shortname observation) property. The key properties for each type of slice are listed by short name in the table below.
Type of Slice | Slice Key Property Short Names |
---|---|
LatestSampleSlice | none |
BySamplingPointSlice | bwq_samplingPoint, bwq_bathingWater |
ByYearSlice | sampleYear |
ByWeekSlice | sampleWeek |
BySamplingPointYearSlice | bwq_samplingPoint, bwq_bathingWater, sampleYear |
ComplianceBySamplingPointSlice | bwq_samplingPoint, bwq_bathingWater |
ComplianceByYearSlice | sampleYear |
Add for v0.3
Under the revise Bathing Water directive, during an abnormal situation normal monitoring of a bathing water may be suspended. As of v0.3 of this API such suspension of monitoring records are accessible and relate to the 2012 bathing water season.
Monitoring may be suspended for a variety of abnormal situations, not just abnormal weather conditions.
Class | URI Pattern | Example URI |
---|---|---|
SuspensionOfMonitoring | http://environment.data.gov.uk/data/bathing-water-quality/suspension/point/{bwspid}/date/{date}/time/{time}/recordDateTime/{recordDateTime} | http://environment.data.gov.uk/data/bathing-water-quality/suspension/point/12300/date/20120604/time/090000/recordDateTime/201206121700 |
For the purposes of creating unique URI for :SuspensionOfMonitoring records:
bwspid
embeds a 5 digit bathing water sampling
point code;date
embeds the date on which a suspension
started in YYYYMMdd
format;time
embeds the time of day (local) at which the
suspension started in HHmmss
format; andrecordDateTime
embeds the date and time that the
record was itself created or modified in YYYYMMddHHmm
format.Property Short Name | Description | Property URL |
---|---|---|
description | A description of the cause of the suspension-of-monitoring | http://purl.org/dc/term/description |
comment | An additional comment giving narrative details about the suspension-of-monitoring | http://www.w3.org/2000/01/rdf-schema#comment |
som_notation notation |
A coded value which common for all suspension-of-monitoring records related to a particular suspension. | http://environment.data.gov.uk/def/bwq-som/notation
http://www.w3.org/2004/02/skos/core#notation |
bathingWater | A property for associating something, in this case a suspension-of-monitoring record, with a bathing-water. | http://environment.data.gov.uk/def/bathing-water/bathingWater |
samplingPoint | A property for associating something, in this case a suspension-of-monitoring record, with a bathing-water sampling point. | http://location.data.gov.uk/def/ef/SamplingPoint/samplingPoint |
sampleYear | The assessment year of a “suspension-of-monitoring”. | http://environment.data.gov.uk/def/bathing-water-quality/sampleYear |
regionalOrganization | The regional organisation responsible for monitoring the water quality at a bathing-water associated with a suspension-of-monitoring record. Typically this will refer to an Environment Agency regional office, however this is likely to vary across the UK. | http://environment.data.gov.uk/def/bathing-water/regionalOrganization |
startOfSuspension | The date and time (xsd:dateTime ) at which the
corresponding suspension-of-monitoring started.
|
http://environment.data.gov.uk/def/bwq-som/startOfSuspension |
expectedEndOfSuspension | The date (xsd:date ) on which the corresponding
“suspension-of-monitoring” is expected to end.
|
http://environment.data.gov.uk/def/bwq-som/expectedEndOfSuspension |
endOfSuspension | The date and time (xsd:dateTime ) at which the
corresponding “suspension-of-monitoring” actually ended.
|
http://environment.data.gov.uk/def/bwq-som/endOfSuspension |
recordDateTime | The creation or modification date and time (xsd:dateTime )
at which the corresponding suspension-of-monitoring
record was created/changed.
|
http://environment.data.gov.uk/def/bwq-som/recordDateTime |
followingAssessment | An immediately following sample-assessment for the same bathing-water and assessment year, if any. | http://environment.data.gov.uk/def/bwq-som/followingAssessment |
priorAssessment | An immediately prior sample-assessment for the same bathing-water and assessment year, if any. | http://environment.data.gov.uk/def/bwq-som/followingAssessment |
relatedAssessment | Immediately prior or following sample assessments for the same bathing-water and assessment year, if any. | http://environment.data.gov.uk/def/bwq-som/relatedAssessment |
The Bathing Water Quality API is implemented as an LDA configuration.
The LDA framework provides for item and list endpoints.
Item endpoints are typically used as a way of realising linked-data URI for items of interest: vocabulary terms; things in the world – bathing waters, sampling points, zones of influence; and information items (documents, graphs, information objects) that describe those making use of vocabulary terms from one or more linked-data vocabularies.
List endpoints are used to generate pages that contain descriptions of items selected to meet particular criteria built in to the endpoint configuration and which may be augmented by parameters carried in the request URI. Request URI parameters may narrow the range of items presented in a response. A given list endpoint produces a series of pages which together traverse the set if items that meet the filter criteria for the endpoint augmented with filters from the URI.
Both item and list endpoints can be configured with one or more view. A view is a projection of some part of the RDF graph that emanates from the selected item, in the case of an item endpoint, or from each item included in a response page generated by a list endpoint.
Item and List endpoints can be configured with one or more views which
can be selected through the use of a common LDA URI parameter
_view
. Views are lists of property chains formed through the use of
‘.’ separated property short names. Pre-configured views
can also be augmented with additional property chains through the use
of the
_properties
LDA URI parameter. For example:
&_properties=samplingPoint.easting,samplingPoint.northing
will include the OSGB easting and northings (if any) associated with a sampling point (if any) associated with selected items (typically bathing waters).
&_properties=district.gssCode
will include the GSS geography code (if any) of a local authority district (if any) associated with selected items (typically bathing waters).
In the API reference below property chains associated with
pre-configured API endpoint views are listed. The
_properties
provides a way for API users to augment any of the available or
built-in views.
Built-in views that are operative for most available item and list endpoints are as follows:
View | Description |
---|---|
basic | Presents item type and label properties |
description | Presents all the properties of selected items, and of b-node objects linked to selected items and so-on following links as far URI node or Literal items. A so-called b-node closure |
all | As description, but including available labels for all objects that are mentioned. |
Note that
_view=description
and particularly
_view=all
can generate large and time consuming queries when used in conjunction
with slice listing endpoints (see below). This is because slices in
general carry a large number of observations or assessments resulting
in a large number of items to mention and/or to gather labels for
presentation. Where possible technical measures are either in place or
under development to prevent their use in circumstance where they
would be of little utility at best.
For list endpoints, the item selection can be refined through the use
of filter terms. For example, given the general bathing water list
endpoint detailed below, the following URI will list all bathing water
associated with a district whose GSS code is
E07000188
, i.e. Sedgemoor District.
http://environment.data.gov.uk/doc/bathing-water?district.gssCode=E07000188
Similarly, the following URI will list all in-season sample assessments that have been withdrawn:
http://environment.data.gov.uk/doc/bathing-water-quality/in-season/sample?recordStatus=withdrawal
or the following URI will list all in-season sample assessments that have sample assessment classification of Excellent.
http://environment.data.gov.uk/doc/bathing-water-quality/in-season/sample?sampleAssessment.name=Excellent
LDA also provides mechanisms that enable value ranges to be expressed, so for example in order to list all the latest in-season sample assessments for bathing water sampling points that fall within a given northing and eastings bounding box, URI such as the following can be used.
http://environment.data.gov.uk/doc/bathing-water-quality/in-season/latest?min-bwq_samplingPoint.easting=240209&max-bwq_samplingPoint.easting=293209&min-bwq_samplingPoint.northing=155718&max-bwq_samplingPoint.northing=212718
note the use of
min-{P}
and
max-{P}
to establish minimum and maximum filter range values for
@. In this case @{P}
stands for the property chains
bwq_samplingPoint.northing
and
bwq_samplingPoint.easting
It is also possible to filter selected items based on the presence or
absence of a property using the
exists-{P}=<boolean>
URI parameter. For example the following URI will list in-season
SampleAssessment
that have been replaced:
http://environment.data.gov.uk/doc/bathing-water-quality/in-season/sample?exists-isReplacedBy=true
Similarly, the following URI lists
SampleAssessments
that have not been replaced:
http://environment.data.gov.uk/doc/bathing-water-quality/in-season/sample?exists-isReplacedBy=false
Each LDA endpoint is also capable of delivering its responses in
several formats which can be triggered through the use of HTTP
content-negotiation or the use of an explicit
.ext
mechanism were the
.ext
is inserted at the end of the URI path and prior to any URI query
component. e.g. reusing an earlier example, a JSON response can be
generated using the following URI:
http://environment.data.gov.uk/doc/bathing-water.json?district.gssCode=E07000188
Extension | Media Type | Description |
---|---|---|
.rdf | application/rdf+xml | RDF/XML formatted data |
.ttl | text/turtle | Terse RDF Triple Language formatted data |
.xml | text/xml | LDA XML formatted data |
.json | application/json and text/javascript
|
LDA JSON formatted data. Available both as JSON objects and JSONP callback scripts. |
.html | text/html | HTML formatted data. |
.text | text/plain | JSON formatted output presented with a text/plain
media type.
|
.csv | text/csv | Comma separated value formatted data. |
LDA provides both configuration and URI parameter based mechanisms for setting the default language choices for information presented via a view and for information selected via a filter. The bathing-water quality API is configured to default to filter-on and present text literals tagged with as English or that are untaggged.
This configuration can be overridden using
_lang
and
lang-{P}
URI parameters – where
@ is a shortname for a property or a property
chain. The value of the parameter is a comma separated list of
language tag values. For this API, relevant language tag values are:
@en
for English,
cy
for Welsh and
none
for untagged values.
lang-{P}
affects the languages used in filter matches that involve the property
whose short-name is
{P}
.
URI Parameter Setting | Description |
---|---|
lang-name=en,none | Filters that involve the property whose short-name is name
match values tagged as English or that are untagged.
|
lang-mbox=none | Filters that involve the property whose short-name is mbox
match only untagged values.
|
_lang=en,cy,none | Sets the default languages for all filter properties and view projected values as English, Welsh or untagged. |
_lang=cy,none | Sets the default languages for all filter properties and view projected values as Welsh or untagged. |
In the case where there is are no values tagged with at least one of the configured languages, any available untagged values are presented instead.
The most useful values to use for the these parameters are
en,none
, the configured default, and
en,cy,none
which includes any text tagged as being Welsh in the output.
URI Parameter | Value Description |
---|---|
exists-{P} | A boolean value parameter that filters items based on
whether the given property chain, {P} , can be bound.
|
min-{P} | Sets an inclusive lower-bound filter on the value of the
given property chain, @. Selected items must
have a value for @{P} that is greater than or equal to that given
in the parameters value
|
max-{P} | Sets an inclusive upper-bound filter on the value of the
given property chain, @. Selected items must
have a value for @{P} that is less than or equal to that given in
the parameter’s value
|
minEx-{P} | Sets an exclusive lower-bound filter on the value of the
given property chain, @. Selected items must
have a value for @{P} that is greater than that given in the
parameter’s value
|
maxEx-{P} | Sets an exclusive upper-bound filter on the value of the
given property chain, @. Selected items must
have a value for @{P} that is less than that given in the
parameter’s value
|
_lang | A comma separated list of languages used for both filter
based selection and value projection in response data. Default: en,none
|
_pageSize | The requested maximum number of items to be on a requested list endpoint page. |
_page | The page number of a requested list endpoint page. |
_properties | A comma separated list of properties or property chains that are added to any default or selected views. |
_sort | A comma separated list of property shortnames or property
chains which are used to order the items returned by a list
endpoint. A leading '-' character on any property or
property chain selects a descending rather than ascending order.
|
_view | A view name that selects a pre-configured view that moderates the amount of detail presented about a given item in a resultset. |
callback | A javascript function named used when generating a JSONP response. |
More details about common LDA URI parameters can be found in the LDA Specification
It should be evident from this simple introduction that the LDA framework provides a powerful URI based mechanism for selecting and projecting information held with in an RDF store for use in implementing linked data URI pages and for building data consuming web applications.
This reference is divided into three sections, one each for API
endpoint collected at
environment.data.gov.uk
and
location.data.gov.uk
respectively and a final section that acts as a cross reference for
shortnames that can be use to build property-chains for both views (
&_properties=
) and filters (
&{P}={V}
) as part of a URI based API call. Property chains can only be
followed through items that have the corresponding properties. The Datamodel section earlier listed the properties
that may be used from each of the available entry types.
Within each of the first two sub sections below, API endpoints are organised by the item type that they return and that share configured views. Each section lists:
Item Types: various: Ontology, OWL Class, RDFS Class, RDF Property, Datatype Property, Object Property, Datatype, ConceptScheme, Concept, Cube Data Structure Definition, Cube Slice Key
Endpoint URI Template http://environment.data.gov.uk |
List or Item | Description | Views |
---|---|---|---|
/def | List | Lists vocabularies whose URI names begin http://environment.data.gov.uk/def/ | description, scheme |
/def/{vocabulary} | List | Lists vocabulary terms defined within
http://environment.data.gov.uk/def/{vocabulary}/. Currently, {vocabulary}
= "bathing-water" or "bathing-water-quality" or "bwq-cc-2012" .
|
description, scheme |
/def/{vocabulary}/ | Item | Returns data about a given vocabulary. | description, scheme |
/def/{vocabulary}/{term} | Item | Returns the definition of an individual vocabulary term. | description, definition |
/def/{vocabulary}/{term}/instance | List | For a given @ where
@http://environment.data.gov.uk/def/{vocabulary}/{term} is a class,
returns a list of instances of that class.
|
description, definition |
/def/{vocabulary}/{term}/property | List | For a given @ where
@http://environment.data.gov.uk/def/{vocabulary}/{term} is a class,
returns a list of properties used within the data by instances of
that class.
|
description, definition |
/def/{vocabulary}/{term}/subclass | List | For a given @ where
@http://environment.data.gov.uk/def/{vocabulary}/{term} is a class,
returns a list of defined subclasses of that class.
|
description, definition |
View | Properties |
---|---|
description | Built-in |
definition | name, type, definition, alias, label, note, scopeNote, topConcept, topConceptOf, broader.name, narrower.name, comment, range, domain, type.label, isDefinedBy.label, subClassOf.label, subPropertyOf.label |
scheme | name, type, alias, label, note, scopeNote, contributor.who, contributor.mbox, topConcept.name, comment, isDefinedBy.label |
BathingWater
class from the bathing-water
vocabulary presented
through the endpoint’s default view.BathingWater
class whose name
property has a value of “Spittal” presented through the
endpoint’s default view.BathingWater
.
SampleAssessment
from the bathing-water-quality
vocabulary.The previous dataset organisation has been extended in preparation for bathing-water quality data and reference information being published by multiple monitoring bodies within the UK, for example SEPA in Scotland and a future Single Environmental Body for Wales.
The top level in-season sample assessment and annual compliance assessment cube datasets are retained however, they are each formulated as an aggregation of underlying subsets with an in-season assessment subset and an annual compliance subset per monitoring body. Dataset slices remain formulated over the entire aggregation as before, however individual observations (SampleAssessments and ComplianceAssessments are linked to the per monitoring body subset. Baseline and incremental updates of per monitoring body in-season and annual compliance dataset are formulated as distinct subsets of the corresponding per monitoring body cubes.
SuspensionOfMonitoring are organised similarly as a hierarchy of VoID datasets rooted in the top-level bathing-water-quality dataset with an over all suspension-of-monitoring with per monitoring body aggregation subsets eg. http://environment.data.gov.uk/data/bathing-water-quality/eaew/suspension which collects subordinate baseline and incremental suspension of monitoring datasets.
This is illustrated in the diagram below:
In-Season,
Annual Compliance and Suspension-of-Monitoring Dataset Organisation
Item type: VoID Dataset, Cube Dataset
Endpoint URI Template http://environment.data.gov.uk |
List or Item | Description | Views |
---|---|---|---|
/data | List | Lists VoID and Cube datasets within the environment.data.gov.uk | dataset, basic, description |
/data/bathing-water-quality | Item | Top-level Bathing Water Quality dataset | dataset, basic, description |
/data/bathing-water-quality/{dataset} | Item | Top-level in-season or annual compliance data assessment
datasets {dataset} = "in-season" or "compliance" or
"suspension"
|
dataset, basic, description |
/data/bathing-water-quality/in-season/dataset-increment | List | List available in-season dataset subsets corresponding to baseline and incremental update data | dataset, basic, description |
/data/bathing-water-quality/{dataset}/dataset-increment/{increment} | Item | Describes a particular dataset subset | dataset, basic, description |
New as of v0.2 | |||
/data/bathing-water-quality/{publisher}/in-season | Item | Returns information about a particular publisher’s or monitoring body’s in-season sample assessment cube dataset (see dataset organisation ). | dataset, basic, description |
/data/bathing-water-quality/{publisher}/in-season/ | List | Lists baseline and incremental update (void) datasets that contribute to a particular publisher’s or monitoring body’s in-season sample assessment (cube) dataset (see dataset organisation ). | dataset, basic, description |
/data/bathing-water-quality/{publisher}/in-season/dataset-increment/{release} | Item | Return information about a particular publisher’s or monitoring body’s baseline or incremental release of in-season sample assessment data (see dataset organisation ). | dataset, basic, description |
/data/bathing-water-quality/{publisher}/compliance | Item | Returns information about a particular publisher’s or monitoring body’s annual compliance assessment cube dataset (see dataset organisation ). | dataset, basic, description |
/data/bathing-water-quality/{publisher}/compliance/ | List | Lists baseline and incremental update (void) datasets that contribute to a particular publisher’s or monitoring body’s annual compliance assessment (cube) dataset (see dataset organisation ). | dataset, basic, description |
/data/bathing-water-quality/{publisher}/compliance/dataset-increment/{release} | Item | Return information about a particular publisher’s or monitoring body’s baseline or incremental release of annual compliance assessment data (see dataset organisation ). | dataset, basic, description |
New as of v0.3 | |||
/data/bathing-water-quality/{publisher}/suspension | Item | Returns information about a particular publisher’s or monitoring body’s suspension of monitoring dataset (see dataset organisation ). | dataset, basic, description |
/data/bathing-water-quality/{publisher}/suspension/ | List | Lists baseline and incremental update (void) datasets that contribute to a particular publisher’s or monitoring body’s suspension-of-monitoring dataset (see dataset organisation ). | dataset, basic, description |
/data/bathing-water-quality/{publisher}/suspension/dataset-increment/{release} | Item | Return information about a particular publisher’s or monitoring body’s baseline or incremental release of suspension-of-monitoring data (see dataset organisation ). | dataset, basic, description |
View | Properties |
---|---|
basic | Built-in |
description | Built-in |
dataset | name, label, type, comment, description, created, modified, subset, subset.label, subset.name, dataDump, vocabulary, vocabulary.label, license, source, structure, uriRegexPattern |
Item Type: BathingWater
Endpoint URI Template http://environment.data.gov.uk |
List or Item | Description | Views |
---|---|---|---|
/id/bathing-water/ /doc/bathing-water/ |
Item | Describes the Environment Agency bathing-water URIset. | all, description |
/id/bathing-water /doc/bathing-water |
List | Lists designated bathing waters that are members of the bathing-water URI set. In particular, the list omits formerly designated bathing waters that have been de-designated. | all, desciption, bathing-water |
/id/bathing-water/{eubwid} /doc/bathing-water/{eubwid} |
Item | Describes a particular bathing-water. | all, desciption, bathing-water |
/doc/nearest-bathing-water/easting/{easting}/northing/{northing} | List | Lists designated bathing waters that are nearest to a location given by an OSGB easting and northing. In particular, the list omits formerly designated bathing waters that have been de-designated. | all, desciption, bathing-water |
View | Properties |
---|---|
all | Built-in |
description | Built-in |
bathing-water | name, type, envelope.label, sedimentTypesPresent, yearDesignated, yearDedesignated, district.name, zoneOfInfluence.name, county.name, country.name, regionalOrganization.name, waterQualityImpactedByHeavyRain, eubwidNotation, uriSet.name, uriSet.label, seeAlso, sameAs, samplingPoint.name, samplingPoint.lat, samplingPoint.long, samplingPoint.easting, samplingPoint.northing, latestSampleAssessment, latestSampleAssessment.sampleClassification.name, latestComplianceAssessment, latestComplianceAssessment.complianceClassification.name |
district
properties associated
with the returned bathing-water descriptions. The list page is
rendered in a default or content-negotiated format.90000<=easting<=240000
and 0<=northing<=70000
,
viewed through the default view for the endpoint.Item type: SampleAssessment
Endpoint URI Template http://environment.data.gov.uk |
List or Item | Description | Views |
---|---|---|---|
/doc/bathing-water-quality/in-season/sample | List | General listing endpoint for listing in-season sample
assessment. Beware of the use of the _sort URI
parameter without further qualifying the sample assessment being
sought. There are in-excess of 210k in-season sample assessments in
the dataset.
|
location, assessment, assessment-csv, classification, coliforms, streptococci, entrovirus, salmonella, description |
/data/bathing-water-quality/in-season/sample/point/{bwspid}/date/{date}/time/{time}/recordDate | List | List sample assessments for a given bathing-water or sampling-point with the same sampling date and time. This lists new, replacement and withdrawal sample assessment records for the same sample. | location, assessment, assessment-csv, classification, coliforms, streptococci, entrovirus, salmonella, description |
/data/bathing-water-quality/in-season/sample/point/{bwspid}/date/{date}/time/{time}/recordDate/{recDate} | Item | Describes a particular in-season sample assessment | location, assessment, assessment-csv, classification, coliforms, streptococci, entrovirus, salmonella, description |
/doc/bathing-water-quality/in-season/latest | List | List the latest, un-replaced, un-withdrawn in-season sample assessments. At most one per bathing-water. | location, assessment, assessment-csv, classification, coliforms, streptococci, entrovirus, salmonella, description |
/doc/bathing-water-quality/in-season/bathing-water/{eubwid} | List | Lists un-replaced, un-withdrawn in-season sample assessments for a given bathing-water | location, assessment, assessment-csv, classification, coliforms, streptococci, entrovirus, salmonella, description |
/doc/bathing-water-quality/in-season/bathing-water/{eubwid}/latest | List | Lists the (single) latest, un-withdrawn, un-replaced in-season sample assessment for a given bathing-water. | location, assessment, assessment-csv, classification, coliforms, streptococci, entrovirus, salmonella, description |
/doc/bathing-water-quality/in-season/point/{bwspid} | List | Lists un-replaced, un-withdrawn in-season sample assessments taken at a given sampling-point. | location, assessment, assessment-csv, classification, coliforms, streptococci, entrovirus, salmonella, description |
/doc/bathing-water-quality/in-season/point/{bwspid}/latest | List | Lists the (single) latest, un-withdrawn, un-replaced in-season sample assessment taken at a given sampling-point. | location, assessment, assessment-csv, classification, coliforms, streptococci, entrovirus, salmonella, description |
/doc/bathing-water-quality/in-season/latest-nearest/easting/{easting}/northing/{northing} | List | List the latest in-season sample assessments taken at
sampling-points closest to a location given by OSGB easting and
northing. By default list the nearest 5 sample assessments in order
of increasing distance. _pageSize can be used to vary
the number of results and further results can be obtained on
successive pages using the _page
|
location, assessment, assessment-csv, classification, coliforms, streptococci, entrovirus, salmonella, description |
View | Properties |
---|---|
description | Built-in |
location | label, type, source, dataset, bwq_samplingPoint.samplePointNotation, bwq_samplingPoint.name, bwq_samplingPoint.easting, bwq_samplingPoint.northing, bwq_samplingPoint.lat, bwq_samplingPoint.long, bwq_bathingWater.name, bwq_bathingWater.eubwidNotation, sampleDateTime.inXSDDateTime, sampleWeek.label, sampleClassification.complianceCodeNotation, sampleClassification.name, totalColiformQualifier.countQualifierNotation, totalColiformCount, faecalColiformQualifier.countQualifierNotation, faecalColiformCount, faecalStreptococciQualifier.countQualifierNotation, faecalStreptococciCount, entrovirusQualifier.countQualifierNotation, entrovirusCount, escherichiaColiCount, escherichiaColiQualifier.countQualifierNotation, intestinalEnterococciCount, intestinalEnterococciQualifier.countQualifierNotation, salmonellaPresent.name, salmonellaPresent.presenceNotation, abnormalWeatherException |
assessment | label, type, source, dataset, bwq_samplingPoint.samplePointNotation, bwq_samplingPoint.name, bwq_bathingWater.name, bwq_bathingWater.eubwidNotation, sampleDateTime.inXSDDateTime, sampleWeek.label, sampleClassification.complianceCodeNotation, sampleClassification.name, totalColiformQualifier.countQualifierNotation, totalColiformCount, faecalColiformQualifier.countQualifierNotation, faecalColiformCount, faecalStreptococciQualifier.countQualifierNotation, faecalStreptococciCount, entrovirusQualifier.countQualifierNotation, entrovirusCount, escherichiaColiCount, escherichiaColiQualifier.countQualifierNotation, intestinalEnterococciCount, intestinalEnterococciQualifier.countQualifierNotation, salmonellaPresent.name, salmonellaPresent.presenceNotation, abnormalWeatherException |
assessment-csv | type, bwq_samplingPoint.samplePointNotation, bwq_bathingWater.name, bwq_bathingWater.eubwidNotation, sampleDateTime.inXSDDateTime, sampleWeek.label, sampleClassification.complianceCodeNotation, totalColiformQualifier.countQualifierNotation, totalColiformCount, faecalColiformQualifier.countQualifierNotation, faecalColiformCount, faecalStreptococciQualifier.countQualifierNotation, faecalStreptococciCount, entrovirusQualifier.countQualifierNotation, entrovirusCount, escherichiaColiCount, escherichiaColiQualifier.countQualifierNotation, intestinalEnterococciCount, intestinalEnterococciQualifier.countQualifierNotation, salmonellaPresent.presenceNotation, abnormalWeatherException |
classification | type, label, source, dataset, bwq_samplingPoint.samplePointNotation, bwq_samplingPoint.name, bwq_bathingWater.name, bwq_bathingWater.eubwidNotation, sampleDateTime.inXSDDateTime, sampleWeek.label, sampleClassification.complianceCodeNotation, sampleClassification.name, abnormalWeatherException |
coliforms | type, label, source, dataset, bwq_samplingPoint.samplePointNotation, bwq_samplingPoint.name, bwq_bathingWater.name, bwq_bathingWater.eubwidNotation, sampleDateTime.inXSDDateTime, sampleWeek.label, totalColiformQualifier.countQualifierNotation, totalColiformCount, faecalColiformQualifier.countQualifierNotation, faecalColiformCount, abnormalWeatherException |
streptococci | type, label, source, dataset, bwq_samplingPoint.samplePointNotation, bwq_samplingPoint.name, bwq_bathingWater.name, bwq_bathingWater.eubwidNotation, sampleDateTime.inXSDDateTime, sampleWeek.label, faecalStreptococciQualifier.countQualifierNotation, faecalStreptococciCount, abnormalWeatherException |
entrovirus | type, label, source, dataset, bwq_samplingPoint.samplePointNotation, bwq_samplingPoint.name, bwq_bathingWater.name, bwq_bathingWater.eubwidNotation, sampleDateTime.inXSDDateTime, sampleWeek.label, entrovirusQualifier.countQualifierNotation, entrovirusCount, abnormalWeatherException |
salmonella | type, label, source, dataset, bwq_samplingPoint.samplePointNotation, bwq_samplingPoint.name, bwq_bathingWater.name, bwq_bathingWater.eubwidNotation, sampleDateTime.inXSDDateTime, sampleWeek.label, salmonellaPresent.name, salmonellaPresent.presenceNotation, abnormalWeatherException |
New as of v0.2 | |
intestinalEnterococci | type, label, source, dataset, bwq_samplingPoint.samplePointNotation, bwq_samplingPoint.name, bwq_bathingWater.name, bwq_bathingWater.eubwidNotation, sampleDateTime.inXSDDateTime, sampleWeek.label, intestinalEnterococciQualifier.countQualifierNotation, intestinalEnterococciCount, abnormalWeatherException |
escherichiaColi | type, label, source, dataset, bwq_samplingPoint.samplePointNotation, bwq_samplingPoint.name, bwq_bathingWater.name, bwq_bathingWater.eubwidNotation, sampleDateTime.inXSDDateTime, sampleWeek.label, escherichiaColiQualifier.countQualifierNotation, escherichiaColiCount, abnormalWeatherException |
SampleAssessment
whose recordStatus
is replacement
meaning
that they are a replacement for an earlier SampleAssessment
.SampleAssessments
whose sampleClassification
have a name
of Excellent
and whose sampleDateTime
lies between midnight on 20th
June 2011 and midnight on 30th June 2011. The page is rendered in a
content-negotiated format viewed through the endpoints default view.SampleAssessment
taken at a SamplingPoint
that lies within a box bounded
by 280000<=easting<=360000
and 150000<=northing<=190000
.
The page is viewed with the endpoints default view.SampleAssessment
nearest to a point-of-interest easting=329114
, northing=154114
that have a sampleClassification
with a name
of Good
. The list entries are ordered by increasing
straight-line distance from the point of interest. The page is
rendered in a content-negotiated format viewed using the endpoints
default view.SampleAssessments
that have been superceeded by a subsequent SampleAssessment
.
The page is rendered in a content-negotiated format viewed using the
endpoints default view.Item type: Slice, ByYearSlice, BySamplingPointSlice, BySamplingPointYearSlice, ByWeekSlice
Endpoint URI Template http://environment.data.gov.uk |
List or Item | Description | Views |
---|---|---|---|
/data/bathing-water-quality/in-season/slice | List | List all in-season dataset slices | basic |
/data/bathing-water-quality/in-season/slice/latest | Item | Describes the (singleton) latest in-season assessment slice | basic, description |
/data/bathing-water-quality/in-season/slice/point | List | List all in-season BySamplingPointSlice slices. | slice-by-point, basic |
/data/bathing-water-quality/in-season/slice/point/{point} | Item | Describes an in-season BySamplingPointSlice for a given sampling-point. | slice-by-point, description |
/data/bathing-water-quality/in-season/slice/point-year | List | List all in-season BySamplingPointYearSlice slices. | slice-by-point-year, basic |
/data/bathing-water-quality/in-season/slice/point/{point}/year/{year} | Item | Describes an in-season BySamplingPointYearSlice slice for a given sampling-point and year | slice-by-point-year, description, basic |
/data/bathing-water-quality/in-season/slice/week | List | List all in-season ByWeekSlice slices. | slice-by-week, basic |
/data/bathing-water-quality/in-season/slice/week/{week} | Item | Describes an in-season ByWeekSlice for a given week. | slice-by-week, description |
/data/bathing-water-quality/in-season/slice/year | List | List all in-season ByYearSlice slices. | slice-by-year, basic |
/data/bathing-water-quality/in-season/slice/year/{year} | Item | Describes an in-season ByYearSlice for a given year. | slice-by-year, description |
View | Properties |
---|---|
basic | Built-in |
description | Built-in |
slice-by-point (list) | name, label, bwq_samplingPoint.name, bwq_samplingPoint.easting, bwq_samplingPoint.northing, bwq_samplingPoint.lat, bwq_samplingPoint.long |
slice-by-point (item) | name, label, bwq_samplingPoint.name, bwq_samplingPoint.easting, bwq_samplingPoint.northing, bwq_samplingPoint.lat, bwq_samplingPoint.long, observation.sampleWeek.label |
slice-by-point-year (list) | name, label, sampleYear.ordinalYear, bwq_samplingPoint.name, bwq_samplingPoint.easting, bwq_samplingPoint.northing, bwq_samplingPoint.lat, bwq_samplingPoint.long |
slice-by-point-year (item) | name, label, sampleYear.ordinalYear, bwq_samplingPoint.name, bwq_samplingPoint.easting, bwq_samplingPoint.northing, bwq_samplingPoint.lat, bwq_samplingPoint.long, observation.sampleWeek.label |
slice-by-week (list) | name, label, sampleWeek.ordinalWeekOfYear, sampleWeek.ordinalWeekOfYearYear |
slice-by-week (item) | name, label, sampleWeek.ordinalWeekOfYear, sampleWeek.ordinalWeekOfYearYear, observation.bwq_samplingPoint.name |
slice-by-year (list) | name, label, sampleYear.ordinalYear |
slice-by-year (item) | name, label, sampleYear.ordinalYear, observation.bwq_samplingPoint.name, observation.sampleWeek.label |
Caution: given the large number of
SampleAssessments
associated with many slices, it is unwise to use the
built-in views,
_view=all
or
_view=description
, in conjuction with slice listing endpoints.
ByWeekSlice
slice for all SampleAssessment
taken in week 20 of 2010.
The page is rendered in a content-negotiated format viewed using the
endpoints default view.ByWeekSlice
slices for week 20 of any year, ordered by year. The page is rendered
in a content-negotiated format viewed using the endpoint’s
default view.Item Type: Annual ComplianceAssessment
Endpoint URI Template http://environment.data.gov.uk |
List or Item | Description | Views |
---|---|---|---|
/doc/bathing-water-quality/compliance | List | General listing endpoint for listing annual compliance assessments | compliance, description |
/data/bathing-water-quality/compliance/point/{bwspid}/year/{year} | Item | Describes an annual compliance assessment for samples taken at a given sampling point for a given year. | compliance, description |
/doc/bathing-water-quality/compliance/latest | List | List the most recent annual compliance assessment for each bathing water. | compliance, description |
/doc/bathing-water-quality/compliance/latest-nearest/easting/{easting}/northing/{northing} | List | List the most recent annual compliance assessment taking at
sampling points that are closest to a location given by an OSGB
easting and northing. By default list the nearest 5 compliance
assessments in order of increasing distance. _pageSize
can be used to vary the number of results and further results can be
obtained on successive pages using the _page .
|
compliance, description |
/doc/bathing-water-quality/compliance/bathing-water/{eubwid} | List | Lists annual compliance assessments for a given bathing-water. | compliance, description |
/doc/bathing-water-quality/compliance/bathing-water/{eubwid}/latest | List | Lists the single latest compliance assessment for a given bathing-water. | compliance, description |
/doc/bathing-water-quality/compliance/point/{bwspid} | List | Lists annual compliance assessments taken at a given sampling point. | compliance, description |
/doc/bathing-water-quality/compliance/point/{bwspid}/latest | List | Lists the single latest compliance assessment taken at a given sampling point. | compliance, description |
View | Properties |
---|---|
description | Built-in |
compliance | type, label, source, bwq_samplingPoint.name, bwq_samplingPoint.samplePointNotation, bwq_samplingPoint.easting, bwq_samplingPoint.northing, bwq_samplingPoint.lat, bwq_samplingPoint.long, bwq_bathingWater.name, bwq_bathingWater.eubwidNotation, sampleYear.ordinalYear, complianceClassification.complianceCodeNotation, complianceClassification.name |
ComplianceAssessment
whose complianceClassification
has a name of Poor
.
The page is rendered in a content-negotiated format viewed using the
endpoints default view.ComplianceAssessment
for bathing-waters whose SamplingPoint
is nearest to a
point-of-interest at easting=329114
, northing=154114
,
ordered by increasing straight-line distance from that point. The
page is rendered in a content-negotiated format viewed using the
endpoints default view.Item type: Annual ComplianceByYearSlice, Annual ComplianceBySamplingPointSlice
Endpoint URI Template http://environment.data.gov.uk |
List or Item | Description | Views |
---|---|---|---|
/data/bathing-water-quality/compliance/slice | List | List all annual compliance dataset slices | basic |
/data/bathing-water-quality/compliance/slice/point | List | List all annual compliance ComplianceBySamplingPointSlice slices. | slice-by-point |
/data/bathing-water-quality/compliance/slice/point/{point} | Item | Describe an annual compliance ComplianceBySamplingPointSlice for a given sampling-point. | slice-by-point, description |
/data/bathing-water-quality/compliance/slice/year | List | List all annual compliance ComplianceByYearSlice slices. | slice-by-year |
/data/bathing-water-quality/compliance/slice/year/{year} | Item | Describe an annual compliance ComplianceByYearSlice slice for a given year. | slice-by-year, description |
View | Properties |
---|---|
basic | Built-in |
description | Built-in |
slice-by-point (list) | name, label, bwq_bathingWater.name |
slice-by-point (item) | name, label, bwq_bathingWater.name, observation.sampleYear.ordinalYear, observation.complianceClassification.name |
slice-by-year (list) | name,label,sampleYear.ordinalYear |
slice-by-year (item) | name, label, sampleYear.ordinalYear, observation.bwq_bathingWater.name, observation.complianceClassification.name |
ComplianceByYearSlice
for the year 2010. This slice lists the annual ComplianceAssessments
for the calendar year 2010. The page is rendered in a
content-negotiated format viewed using the endpoints default view.Item Type: SuspensionOfMonitoring
These API endpoints are organises such that succcessive truncations of the URI for URI for a SuspensionOfMonitoring record yield lists records that a progressively less constrained by the parameters previous embedded in the URI. The table below is organised to emphasise this effects of such truncation.
For endpoints that have two similar URI patterns starting
/doc/...
and
/data/...
, the
/data/...
URI will 303 redirect to the corresponding
/doc/...
URI. T
/doc/...
pages are constructed by the API framework whereas any for
/data/...
URI that respond directly (without redirection) correspond to an item
in the datastore. Using
/data/...
URI to access the listed of endpoints below will incur an extra
network round trip that can be avoided by using the corresponding
/doc/...
URI by preference.
Endpoint URI Template http://environment.data.gov.uk |
List or Item | Description | Views |
---|---|---|---|
/data/bathing-water-quality/suspension | Item | Returns information about the top-level Suspension of Monitoring Dataset | basic, description, all |
/doc/bathing-water-quality/suspension | List | Lists the most recent SuspensionOfMonitoring record for each recorded suspension of monitoring. | basic, description, all |
/doc/bathing-water-quality/suspension/active-on/{YYYYMMdd}
/data/bathing-water-quality/suspension/point/{point}/active-on/{YYYYMMdd} |
List | Lists the most recent SuspensionOfMonitoring
record for any suspension-of-monitoring which starts on or before
the indicated date, YYYYMMdd , and either has no
recorded endOfSuspension
or ends on or after the indicated date.
|
basic, description, all |
/doc/bathing-water-quality/suspension/completed-by/{YYYYMMdd}
/data/bathing-water-quality/suspension/point/{point}/completed-by/{YYYYMMdd} |
List | Lists the most recent SuspensionOfMonitoring
record for any suspension-of-monitoring which ends on or before the
indicated date, YYYYMMdd .
|
basic, description, all |
Suspensions by SamplingPoint | |||
/data/bathing-water-quality/suspension/point/{point}/date/{YYYYMMdd}/time/{HHmmss}/recordDateTime/{YYYYMMssHHmm} | Item | Returns information about an individual SuspensionOfMonitoring record. | basic, description, all |
/doc/bathing-water-quality/suspension/point/{point}/date/{YYYYMMdd}/time/{HHmmss}
/data/bathing-water-quality/suspension/point/{point}/date/{YYYYMMdd}/time/{HHmmss} |
List | Lists of all (including updated records) SuspensionOfMonitoring
records for the SamplingPoint
indicated by point for a suspension-of-monitoring that
starts at a given date, YYYYMMdd , and time, HHmmss
.
|
basic, description, all |
/doc/bathing-water-quality/suspension/point/{point}/date/{YYYYMMdd}/time/{HHmmss}/latest
/doc/bathing-water-quality/suspension/point/{point}/date/{YYYYMMdd}/time/{HHmmss}/latest |
List | Lists the single most recent SuspensionOfMonitoring
record for the SamplingPoint
indicated by point for a suspension-of-monitoring that
starts at a given date, YYYYMMdd , and time, HHmmss
.
|
basic, description, all |
/doc/bathing-water-quality/suspension/point/{point}/date/{YYYYMMdd}
/data/bathing-water-quality/suspension/point/{point}/date/{YYYYMMdd} |
List | Lists of all (including updated records) SuspensionOfMonitoring
records for the SamplingPoint
indicated by point for suspensions-of-monitoring that
start on a given date, YYYYMMdd .
|
basic, description, all |
/doc/bathing-water-quality/suspension/point/{point}/latest
/data/bathing-water-quality/suspension/point/{point}/latest |
List | Lists the one most recent SuspensionOfMonitoring
record for the SamplingPoint
indicated by point .
|
basic, description, all |
/doc/bathing-water-quality/suspension/point/{point}
/data/bathing-water-quality/suspension/point/{point} |
List | Lists the most recent SuspensionOfMonitoring
record for each recorded suspension associated with the SamplingPoint
indicated by point .
|
basic, description, all |
/doc/bathing-water-quality/suspension/point/{point}/active-on/{YYYYMMdd}
/data/bathing-water-quality/suspension/point/{point}/active-on/{YYYYMMdd} |
List | Lists the most recent SuspensionOfMonitoring
record for any suspension-of-monitoring at the SamplingPoint
indicated by point which starts on or before the
indicated date, YYYYMMdd , and either has no recorded endOfSuspension
or ends on or after the indicated date.
|
basic, description, all |
/doc/bathing-water-quality/suspension/point/{point}/completed-by/{YYYYMMdd}
/data/bathing-water-quality/suspension/point/{point}/completed-by/{YYYYMMdd} |
List | Lists the most recent SuspensionOfMonitoring
record for any suspension-of-monitoring at the SamplingPoint
indicated by point which ends on or before the
indicated date, YYYYMMdd .
|
basic, description, all |
Suspensions by BathingWater | |||
/doc/bathing-water-quality/suspension/bathing-water/{eubwid}
/data/bathing-water-quality/suspension/bathing-water/{eubwid} |
List | Lists the most recent SuspensionOfMonitoring
record for each recorded suspension associated with the BathingWater
indicated by eubwid .
|
basic, description, all |
/doc/bathing-water-quality/suspension/bathing-water/{eubwid}/date/{YYYYMMdd}/time/{HHmmss}
/data/bathing-water-quality/suspension/bathing-water/{eubwid}/date/{YYYYMMdd}/time/{HHmmss} |
List | Lists of all (including updated records) SuspensionOfMonitoring
records for the BathingWater
indicated by eubwid for a suspension-of-monitoring that
starts at a given date, YYYYMMdd , and time, HHmmss
.
|
basic, description, all |
/doc/bathing-water-quality/suspension/bathing-water/{eubwid}/date/{YYYYMMdd}/time/{HHmmss}/latest
/data/bathing-water-quality/suspension/bathing-water/{eubwid}/date/{YYYYMMdd}/time/{HHmmss}/latest |
List | Lists the single most recent SuspensionOfMonitoring
record for the BathingWater
indicated by eubwid for a suspension-of-monitoring that
starts at a given date, YYYYMMdd , and time, HHmmss
.
|
basic, description, all |
/doc/bathing-water-quality/suspension/bathing-water/{eubwid}/date/{YYYYMMdd}
/data/bathing-water-quality/suspension/bathing-water/{eubwid}/date/{YYYYMMdd} |
List | Lists of all (including updated records) SuspensionOfMonitoring
records for the BathingWater
indicated by eubwid for suspensions-of-monitoring that
start on a given date, YYYYMMdd .
|
basic, description, all |
/doc/bathing-water-quality/suspension/bathing-water/{eubwid}/latest
/data/bathing-water-quality/suspension/bathing-water/{eubwid}/latest |
List | Lists the one most recent SuspensionOfMonitoring
record for the BathingWater
indicated by eubwid .
|
basic, description, all |
/doc/bathing-water-quality/suspension/bathing-water/{eubwid}/active-on/{YYYYMMdd}
/data/bathing-water-quality/suspension/bathing-water/{eubwid}/active-on/{YYYYMMdd} |
List | Lists the most recent SuspensionOfMonitoring
record for any suspension-of-monitoring at the BathingWater
indicated by eubwid which starts on or before the
indicated date, YYYYMMdd , and either has no recorded endOfSuspension
or ends on or after the indicated date.
|
basic, description, all |
/doc/bathing-water-quality/suspension/bathing-water/{eubwid}/completed-by/{YYYYMMdd}
/data/bathing-water-quality/suspension/bathing-water/{eubwid}/completed-by/{YYYYMMdd} |
List | Lists the most recent SuspensionOfMonitoring
record for any suspension-of-monitoring at the BathingWater
indicated by eubwid which ends the indicated date, YYYYMMdd
.
|
basic, description, all |
View | Properties |
---|---|
basic | Built-in |
description | Built-in |
all | Built-in |
ukj4210-12350
).Item Types: various: Ontology, OWL Class, RDFS Class, RDF Property, Datatype Property, Object Property, Datatype
Endpoint URI Template http://location.data.gov.uk |
List or Item | Description | Views |
---|---|---|---|
/def/{theme} | List | List the known feature type vocabularies for a given INSPIRE
theme {theme} = "ef" or "common" corresponding to
environmental facilities (ef) and common cross theme (common)
feature types.
|
definition, description, all |
/def/{theme}/{featureType} | List | List the terms defined in a given feature type vocabulary. | definition, description, all |
/def/{theme}/{featureType}/ | Item | Describe a given feature type vocabulary. | scheme, description, all |
/def/{theme}/{featureType}/{term} | Item | Describe a given {term} within a given feature
type vocabulary
|
definition, description, all |
/def/{theme}/{featureType}/{term}/subclass | List | For a given @ where
@http://location.data.gov.uk/def/{theme}/{featureType}/{term} is a
class, returns a list of subclasses of that class.
|
definition, description, all |
/def/{theme}/{featureType}/{term}/instance | List | For a given @ where
@http://location.data.gov.uk/def/{theme}/{featureType}/{term} is a
class, returns a list of instances of that class.
|
description |
/def/{theme}/{featureType}/{term}/property | List | For a given @ where
@http://location.data.gov.uk/def/{theme}/{featureType}/{term} is a
class, returns a list of properties used by instances of that class.
|
basic, description |
View | Properties |
---|---|
all | Built-in |
basic | Built-in |
description | Built-in |
scheme | name, type, seeAlso, alias, label, note, scopeNote, contributor.who, contributor.mbox, topConcept.name, comment, isDefinedBy.label |
definition | name, type, seeAlso, definition, alias, label, note, scopeNote, topConceptOf, broader.name, narrower.name, comment, range, domain, type.label, isDefinedBy.label, subClassOf.label, subPropertyOf.label |
SamplingPoint
spatial-object feature-type. This includes class and property
definitions.ZoneOfInfluence
spatial-object feature-type. This includes class and property
definitions.Item type: SamplingPoint
Endpoint URI Template http://location.data.gov.uk |
List or Item | Description | Views |
---|---|---|---|
/so/ef/SamplingPoint/{ns}/ /doc/ef/SamplingPoint/{ns}/ |
Item | Describes a Bathing Water Sampling Point Spatial-Object URI
Set. Currently {ns} = bwsp.eaew for Environment Agency
bathing water sampling point spatial objects
|
description, all |
/so/ef/SamplingPoint/{ns} /doc/ef/SamplingPoint/{ns} |
List | Lists the sampling point spatial objects that are members of
a Bathing Water Sampling Point Spatial-Object URI Set. The list
omits sampling point spatial objects for bathing waters that have
been de-designated. Currently {ns} = bwsp.eaew for
Environment Agency bathing water sampling point spatial objects.
|
sampling-point, description |
/so/ef/SamplingPoint/{ns}/{bwspid} /doc/ef/SamplingPoint/{ns}/{bwspid} |
Item | Describes a given bathing-water sampling point. | sampling-point, description |
View | Properties |
---|---|
all | Built-in |
description | Built-in |
sampling-point | name, type, samplePointNotation, district, uriSet.name, uriSet.label, seeAlso, lat, long, easting, northing, bathingWater.name |
SamplingPoint
, designated by the
Environment Agency in England and Wales. The page is rendered in a
content-negotiated format viewed using the built-in view, all
.extent
of the ZoneOfInfluence
associated with the corresponding BathingWater
using _properties=bathingWater.zoneOfInfluence.extent.asGML
to extend the default view.Item type: ZoneOfInfluence, AbstractGeometry
Endpoint URI Template http://location.data.gov.uk |
List or Item | Description | Views |
---|---|---|---|
/so/ef/ZoneOfInfluence/{ns}/ /doc/ef/ZoneOfInfluence/{ns}/ |
Item | Describes a bathing-water zone-of-influence spatial-object
URI Set. Currently {ns} = bwzoi.eaew for for
Environment Agency bathing water zone-of-influence spatial objects.
|
description, all |
/so/ef/ZoneOfInfluence/{ns} /doc/ef/ZoneOfInfluence/{ns} |
List | Lists the zone of influence spatial-objects that are members
of a bathing-water zone-of-influence spatial-object URI set. The
list omits zone-of-influence spatial objects for bathing waters that
have been de-designated. Currently {ns} = bwzoi.eaew
for Environment Agency bathing water zone-of-influence spatial
objects.
|
zone-of-influence, description |
/so/ef/ZoneOfInfluence/{ns}/{localId}:{version} /doc/ef/ZoneOfInfluence/{ns}/{localId}:{version} |
Item | Describes a particular zone of influence spatial object. | zone-of-influence, description |
/so/ef/ZoneOfInfluence/{ns}/{localId}:{version}/{part} /doc/ef/ZoneOfInfluence/{ns}/{localId}:{version}/{part} |
Item | Describes a sub-part of a zone-of-influence spatial object.
Typically {part} = "extent" which will be an AbstractGeometry
that conveys the extent of the zone of influence for a given
bathing-water.
|
description |
View | Properties |
---|---|
all | Built-in |
description | Built-in |
zone-of-influence | name, type, zoiNotation, uriSet, seeAlso, extent, bathingWater.name, bathingWater.samplingPoint.lat, bathingWater.samplingPoint.long, bathingWater.samplingPoint.easting, bathingWater.samplingPoint.northing |
ZoneOfInfluence
spatial-objects associated with designated BathingWater
in England and Wales. The page is rendered in a content-negotiated
format viewed using the endpoint’s default view.extent
of the ZoneOfInfluence
using _properties=extent.asGML
to extend the default
view. The page is rendered in a content-negotiated format.AbstractGeometry
"
representing the spatial extent of the ZoneOfInfluence
at Bamburgh
Castle. The page is rendered in in JSON.Item type: Envelope
Endpoint URI Template http://location.data.gov.uk |
List or Item | Description | Views |
---|---|---|---|
/so/common/Envelope/{ns}/ /doc/common/Envelope/{ns}/ |
Item | Describes an envelope (bounding box) spatial-object URI Set.
Currently {ns} = bwpf.eaew for the Environment Agency
URI set of envelope spatial objects that represent the map extents
for use in bathing-water profiles.
|
description, all |
/so/common/Envelope/{ns} /doc/common/Envelope/{ns} |
List | Lists the envelope spatial-objects that are members of an
envelope (bounding box) spatial-object URI Set. The list omits
envelope spatial objects for bathing waters that have been
de-designated. Currently {ns} = bwpf.eaew for the
Environment Agency URI set of envelope spatial objects that
represent the map extents for use in bathing-water profiles.
|
bounds, description |
/so/common/Envelope/{ns}/{localId}:{version} /doc/common/Envelope/{ns}/{localId}:{version} |
Item | Describes a particular envelope spatial object. | bounds, description |
/so/common/Envelope/{ns}/{localId}:{version}/{part} /doc/common/Envelope/{ns}/{localId}:{version}/{part} |
Item | Describes a sub-part of a envelope spatial object. Typically
{part} = "lowerCorner" or "upperCorner" each of which
will be a Point.
|
description |
View | Properties |
---|---|
all | Built-in |
description | Built-in |
bounds | *, lowerCorner.*, upperCorner.* |
Envelope
spatial-objects associated with the BathingWater
at Spittal.
The page is rendered in a content-negotiated format viewed using the
endpoint’s default view.lowerCorner
of the map
bounds Envelope
spatial-objects associated with the BathingWater
at Spittal.
The page is rendered in a content-negotiated format viewed using the
endpoint’s default view.Envelope
spatial-objects (map bounds)
associated with designated BathingWater
in England and
Wales. The page is rendered in a content-negotiated format viewed
using the endpoint’s default view.As of the 2012 bathing water season, monitoring of bathing waters in the England and Wales is transitioning to the use of the Revised Bathing Water Directive (2006/7/EC) - rBWD. During this transition, which last until the end of the 2014 bathing water season, bathing water quality will be reported using the codes of the Bathing Water Directive (76/0160/EEC) - (cBWD) whilst using the determinands of the rBWD.
This leads to two sets of additions to the modelling of in-season bathing-water sample assessments and annual compliance assessments.
Firstly, the following additional properties are defined for in-season bathing-water sample assessments
Property Short Name | Description | Property URL |
---|---|---|
intestinalEnterococciCount | The number of colonies of intenstinal enterococci grown per 100ml water sample | http://environment.data.gov.uk/def/bathing-water-quality/intestinalEnterococciCount |
intestinalEnterococciQualifier | moreThan, lessThan or actual count qualifier for intestinalEnterococciCount. | http://environment.data.gov.uk/def/bathing-water-quality/intestinalEnterococciQualifier |
escherichiaColiCount | The number of colonies of escherichia coli grown per 100ml water sample | http://environment.data.gov.uk/def/bathing-water-quality/escherichiaColiCount |
escherichiaColiQualifier | moreThan, lessThan or actual count qualifier for escherichiaColiCount. | http://environment.data.gov.uk/def/bathing-water-quality/escherichiaColiQualifier |
Secondly, an extended set of compliance classifications have been defined for use during transition to the rBWD. Whilst these classification deliberately share letter codings (notations) with the pre-transition classification used prior to the 2012 bathing water season, they are different classifications and are labelled differently:
Post transition categories for use in 2015 and beyond are not yet defined for in season assessments.
All these compliance categories are defined as instances of the class
Compliance,
itself a subclass of SKOS Concept
and as members of the SKOS
ConceptScheme
compliance.
These compliance categories fall in the range of sampleClassification and complianceClassification. Their complianceCodeNotation be used in API filter expressions to select sample or annual compliance assessments that bear a code of “G”, “I”, “F”, “C” or “N” eg.
sampleAssessment.complianceCodeNotation=G
Several additional fields have been added to the reference information about bathing waters in order to facilitate the publication of more detailed bathing water profiles as linked data. New properties are indicated in the table in the section on BathingWater Properties.
New envelope spatial objects are provided that convey map extent bounding boxes for use in the presentation of bathing water profiles. This leads extension of the data model described in the section on Envelope Properties and to the location API as described in the section on Envelope Endpoints.
The organistion of SampleAssessment and ComplianceAssessment datasets has been extended as describe in the section on Dataset Organisation
The dataset may contain Bathing Waters that have been de-designated. Following API list endpoints only list only items that are related to currenlt designated bathing waters, i.e. bathing waters that have not been de-designated.
http://environment.data.gov.uk/id/bathing-water http://environment.data.gov.uk/doc/bathing-water |
http://environment.data.gov.uk/doc/nearest-bathing-water/easting/{easting}/northing/{northing} |
http://location.data.gov.uk/so/ef/SamplingPoint/bwsp.eaew http://location.data.gov.uk/doc/ef/SamplingPoint/bwsp.eaew |
http://location.data.gov.uk/so/ef/ZoneOfInfluence/bwzoi.eaew http://location.data.gov.uk/doc/ef/ZoneOfInfluence/bwzoi.eaew |
De-designated bathing waters, sampling points and zones of influence for de-designated bathing waters can be located through the vocabulary listing endpoints with an appropriate filter:
The Revised Bathing Water Directive (rBWD) includes provision for the suspension of routine monitoring during abnormal situations. The changes added for v0.2 made no provison for the reporting of such suspensions of monitoring.
The changes added for v0.3 are the addition of a new class, SuspensionOfMonitoring detailed at Suspension Of Monitoring above and its associated vocabulary, dataset and “API endpoints”#somAPI.