Version: 0.1
Last Modified: 13/03/2012
Contact: Environment
Agency Data Info <data.info@environment-agency.gov.uk>
Warning obsolete version Please use the current version.
This document details a web API for access the publication of Bathing Water Profile 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 revised Bathing Water Directive (76/160/EEC), a revision of the European Bathing Water Directive (76/160/EEC), requires the development of bathing water profiles for all bathing waters, and a general description based on the profile to be displayed at the bathing water location.
The Environment Agency has produced bathing water profiles for each designated bathing water that includes a description of the beach and surrounding area, rivers and streams feeding into the site and a pollution management plan. Profiles are published for a specific year. They may be updated in later years, with the frequency of update being determined by water quality at the bathing water.
The API described in this document provides access to the content of these bathing water profiles in a linked data form.
The publication of bathing water profile information as linked data requires the creation or re-use of RDFS or OWL vocabularies both for bathing water profile information and for supporting reference information such as features that may affect bathing water quality.
Vocabulary, Reference and Assessment Information
The diagram above illustrates the primary vocabularies and datasets components that comprise this linked data bathing water profile publication and their top level URI . Strictly, only the profile datasets contain bathing water profile information; the other components act as ‘infrastructure’ to enable its expression.
The diagram below shows the overall structure of the profile linked data. The properties of profiles, standard language collections and features are described in this document. For information about bathing waters, sampling points and zones of influence see the Bathing Water Quality API reference documentation.
Data Model
Bathing water profiles and information about features may change. For example, corrections may be made to spellings or the location of a feature may be corrected. In this data model, bathing water profiles and features are versioned, that is, whenever a property of one of those resources is changed, then a new version of the resource is created. Different versions of the ‘same’ bathing water profile or feature have very similar URIs, differing only in their version component. The structure of this versioning is illustrated in the diagram below.
Versioning Model
The enduring resource is, in a sense, the thing that there are
different versions of, say a bathing water profile or a feature. Each
enduring resource is linked to each of its versions by a
dcterms:hasVersion
property. Each version is in turn linked back to its enduring resource
by a
dcterms:isVersionOf
property.
Each version has a
version:versionString
property whose value is a label for the version. Conventionally this
version string will also appear in the versioned resource’s URI.
Each version also has a versionInterval property which indicates the time interval for which the version is current. The time interval must have a hasBeginning property which specifies the instant at which the versioned resource became current. If the version is no longer current, is must have a hasEnd property specifying the instant at which the versioned resource became no longer current. The interval may be thought of as closed at the beginning and open at the end, so that the end of one interval and the beginning of the next may share the same instant. In this case, the boundary instant is in the second interval but not in the first. Instants are described by inXSDDateTime properties whose values are dateTime typed literals.
The major reference entities to which bathing-water-profile information needs to refer are the bathing-waters they describe and features, such as emergency storm overflow outlets, that may affect the water quality at a bathing water. For information about bathing-waters reference data, including Environment Agency regional organizations, see the bathing-water-quality API reference documentation.
Features are versioned following the versioningModel. Resources of type Enduring Feature are the enduring resources. Resources of type Feature are their versions.
The following URI patterns is used to designate instances of a 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 |
|---|---|---|
| Feature | http://location.data.gov.uk/id/ef/BathingWaterProfileFeature/bwpf.eaew/{featureId}:{version} | http://location.data.gov.uk/id/ef/BathingWaterProfileFeature/bwpf.eaew/UKC2102-03600-ID-210.1349-1-1:1 |
| Enduring Feature | http://location.data.gov.uk/id/ef/BathingWaterProfileFeatureEndurant/bwpf.eaew/{featureId} | http://location.data.gov.uk/id/ef/BathingWaterProfileFeatureEndurant/bwpf.eaew/UKC2102-03600-ID-210_1349-1-1 |
| Property Short Name | Description | Property URL |
|---|---|---|
| type | A property for indicating the type of a resource, in this case one of disused outfall ( DO ), emergency or storm overflow ( ESO ), river or stream intersection ( RSI ), surface water outfall ( SWO ) or treated sewage works outfall ( TSO ). | http://www.w3.org/2000/01/rdf-schema#label |
| label | A property for associating a human readable label with a resource. | http://www.w3.org/2000/01/rdf-schema#label |
| bathingWater | A property for associating something, in this case a feature, with a bathing water | http://environment.data.gov.uk/def/bathing-water/bathingWater |
| easting | A property for associating something, in this case a feature, with its UK National Grid easting coordinate. | http://data.ordnancesurvey.co.uk/ontology/spatialrelations/easting |
| northing | A property for associating something, in this case a feature, with its UK National Grid northing grid coordinate. | http://data.ordnancesurvey.co.uk/ontology/spatialrelations/northing |
| lat | A property for associating something, in this case a feature, with a WGS84 latitude in decimal degrees. | http://www.w3.org/2003/01/geo/wgs84_pos#lat |
| long | A property for associating something, in this case a feature, with a WGS84 longitude in decimal degrees. | http://www.w3.org/2003/01/geo/wgs84_pos#lat |
| regionalOrganisation | A property used here to associate a feature with its responsible Environment Agency regional organisation. | http://environment.data.gov.uk/def/bathing-water/regionalOrganization |
| isVersionOf | A property used here to associate an entity, in this case a feature, with the thing it is a a version of, in this case an EnduringFeature. | http://purl.org/dc/terms/isVersionOf |
| versionInterval | A property used here to associate a versioned entity, in this case a feature, with the interval for which it was current. | http://environment.data.gov.uk/def/version/interval |
| versionString | A property used here to associate a versioned entity, in this case a feature, with a string label for the version. | http://environment.data.gov.uk/def/version/versionString |
| source | A property used here to associate a bathing water profile in linked data form with the data from which it was derived. | http://purl.org/dc/terms/source |
| uriSet | The URI Set that a thing, in this case a feature, is a member of. | http://reference.data.gov.uk/def/reference/uriSet |
| Property Short Name | Description | Property URL |
|---|---|---|
| hasVersion | A property used here to associate an enduring entity, in this case an enduring feature, with an entity that represents a version of it, in this case a feature. | http://purl.org/dc/terms/isVersionOf |
| uriSet | The URI Set that a thing, in this case an enduring feature, is a member of | http://reference.data.gov.uk/def/reference/uriSet |
Bathing water profiles are essentially a collection of natural language statements about bathing waters, published by the Environment Agency. A bathing water profile has a year of publication or applicable year. New profiles may be published about a bathing water from time to time, the frequency depending on the assessment of the water quality at the bathing water, but not more than once a year. New profiles are considered to be new publications, not new versions of the same publication. However, once published, a profile may be updated to correct errors. A corrected profile is considered to be a new version of the profile for an applicable year.
Bathing water profiles follow the versioning model. Resources of type EnduringBathingWaterProfile are the enduring profiles. Resources of type BathingWaterProfile are their versions.
Bathing water profiles contain standard language which is common across many profiles. Individual profiles are linked to a standard language collection which has properties describing the standard language.
The following URI patterns is used to designate instances of a 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 |
|---|---|---|
| BathingWaterProfile | http://environment.data.gov.uk/id/bathing-water-profile/{eubwid}/{year}:{ver} | http://environment.data.gov.uk/id/bathing-water-profile/ukc2102-03600/2012:1 |
| EnduringBathingWaterProfile | http://environment.data.gov.uk/id/bathing-water-profile-endurant/{eubwid}/{year} | http://environment.data.gov.uk/id/bathing-water-profile-endurant/ukc2102-03600/2012 |
| Standard Language | http://environment.data.gov.uk/id/bathing-water-profile-standard-language/{year}:{ver} | http://environment.data.gov.uk/id/bathing-water-profile-standard-language/2012:1 |
| Property Short Name | Description | Property URL |
|---|---|---|
| label | A property for associating a human readable label with a resource. | 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 per language, english and welsh in the case of this dataset. | http://www.w3.org/2004/02/skos/core#prefLabel |
| bathingWater | A property for associating a bathing water with something else. | http://environment.data.gov.uk/def/bathing-water/bathingWater |
| applicableYear | A property for associating a bathing water profile with the year it applies to, typically the year it was published. | http://environment.data.gov.uk/def/bathing-water-profile/applicableYear |
| standardLanguageCollection | A property for associating a bathing water profile with a collection of standard language that applies to many profiles. See standard language collection properties. | http://environment.data.gov.uk/def/bathing-water-profile/standardLanguageCollection |
| localAuthority | A property for associating something with a local authority. This property exists primarily to provide a name for the local authority. See local authority properties. | http://statistics.data.gov.uk/def/administrative-geography/localAuthority |
| countyName | A colloquial name for the county containing the bathing water. This is the name of the county used by the Environment Agency on its published profiles and may differ from the names provided in reference data such as provided by the Ordinance Survey. | http://environment.data.gov.uk/def/bathing-water-profile/countyName |
| bathingWaterDescription | A property used for associating a bathing water profile with a physical description of a bathing water. | http://environment.data.gov.uk/def/bathing-water-profile/bathingWaterDescription |
| zoiDescription | A property used for associating a bathing water profile with a physical description of the surrounding catchment impacting on a bathing water. | http://environment.data.gov.uk/def/bathing-water-profile/zoiDescription |
| streamsRiversStatement | A property used for associating a bathing water profile with a statement about details of streams and rivers that impact water quality at the bathing water. | http://environment.data.gov.uk/def/bathing-water-profile/streamsRiversStatement |
| investigationsStatement | A property used for associating a bathing water profile with a statement about details of any Environment Agency investigations into water quality which have impacted on the bathing water. | http://environment.data.gov.uk/def/bathing-water-profile/eaInvestigationsStatement |
| historyStatement | A property used for associating a bathing water profile with a statement about details of the history of any water company assets which impact a bathing water. | http://environment.data.gov.uk/def/bathing-water-profile/historyStatement |
| stwOutfallsStatement | A property used for associating a bathing water profile with a statement about details of any sewage treatment outfalls which may impact on a bathing water. | http://environment.data.gov.uk/def/bathing-water-profile/stwOutfallsStatement |
| esoOutfallsStatement | A property used for associating a bathing water profile with a statement about details of any emergency outfalls and storm overflow outfalls which may impact on a bathing water. | http://environment.data.gov.uk/def/bathing-water-profile/esoOutfallsStatement |
| localAuthorityStatement | A property used for associating a bathing water profile with a statement about details of any work or improvements to water quality undertaken with the local authority which may impact on a bathing water. | http://environment.data.gov.uk/def/bathing-water-profile/localAuthorityStatement |
| misconnectionsStatement | A property used for associating a bathing water profile with a brief statement about misconnections and any details specific to a bathing water. | http://environment.data.gov.uk/def/bathing-water-profile/misconnectionsStatement |
| workingWithFarmersStatement | A property used for associating a bathing water profile with a statement about details of any work or improvements to water quality undertaken with local farmers which may impact on a bathing water. | http://environment.data.gov.uk/def/bathing-water-profile/workingWithFarmersStatement |
| workingWithIndustryStatement | A property used for associating a bathing water profile with a statement about details of any work or improvements to water quality undertaken with local industry which may impact on a bathing water. | http://environment.data.gov.uk/def/bathing-water-profile/workingWithIndustryStatement |
| workingWithPrivateOwnersStatement | A property used for associating a bathing water profile with a statement about details of any work or improvements to water quality undertaken with private owners which may impact on a bathing water. | http://environment.data.gov.uk/def/bathing-water-profile/workingWithPrivateOwnersStatement |
| macroAlgaeStatement | A property used for associating a bathing water profile with a brief statement about Macroalgae (seaweed) at a bathing water. | http://environment.data.gov.uk/def/bathing-water-profile/macroAlgaeStatement |
| phytoplanktonStatement | A property used for associating a bathing water profile with a brief statement about Phytoplankton at a bathing water. | http://environment.data.gov.uk/def/bathing-water-profile/phytoplanktonStatement |
| webResImage | A property used for associating a bathing water profile with an image of the bathing water at a resolution suitable for displaying on a web page. | http://environment.data.gov.uk/def/bathing-water-profile/webResImage |
| isVersionOf | A property used here to associate an entity with the enduring thing it is a a version of. | http://purl.org/dc/terms/isVersionOf |
| versionInterval | A property used here to associate a versioned entity with the interval for which it was current. | http://environment.data.gov.uk/def/version/interval |
| versionString | A property used here to associate a versioned entity with a string label for the version. | http://environment.data.gov.uk/def/version/versionString |
| source | A property used here to associate a bathing water profile in linked data form with the data from which it was derived. | http://purl.org/dc/terms/source |
| Property Short Name | Description | Property URL |
|---|---|---|
| label | A property for associating a human readable label with a resource, in this case the name of the local authority. | http://www.w3.org/2000/01/rdf-schema#label |
| district | A reusable property used here to associate a local authority with the district it administers. | http://statistics.data.gov.uk/def/administrative-geography/district |
| Property Short Name | Description | Property URL |
|---|---|---|
| label | A property for associating a human readable label with a resource. | 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 per language, english and welsh in the case of this dataset. | http://www.w3.org/2004/02/skos/core#prefLabel |
| pollutionManagementGeneralStatement | A property used for associating a bathing water profile with a brief statement of how the Environment Agency manages pollution at bathing waters. | http://environment.data.gov.uk/def/bathing-water-profile/pollutionManagementGeneralStatement |
| stwOutfallsGeneralStatement | A property used for associating a bathing water profile with a brief general statement of the improvements to sewage treatment outfalls. | http://environment.data.gov.uk/def/bathing-water-profile/stwOutfallsGeneralStatement |
| esoOutfallsGeneralStatement | A property used for associating a bathing water profile with a brief statement about Emergency outfalls and Storm overflow outfalls. | http://environment.data.gov.uk/def/bathing-water-profile/esoOutfallsGeneralStatement |
| localAuthorityGeneralStatement | A property used for associating a bathing water profile with a brief statement about precipitation run-off from roads and pavements. | http://environment.data.gov.uk/def/bathing-water-profile/localAuthorityGeneralStatement |
| algaeGeneralStatement | A property used for associating a bathing water profile with a brief statement about Algae in general at bathing waters | http://environment.data.gov.uk/def/bathing-water-profile/algaeGeneralStatement |
| Property Short Name | Description | Property URL |
|---|---|---|
| hasVersion | A property used here to associate an enduring bathing water profile with a version of that profile. | http://purl.org/dc/terms/isVersionOf |
The Bathing Water Profile 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 water profiles, features, bathing waters, sampling points and zones of influence; and information items (documents, graphs, information objects) that describe them, making use of vocabulary terms from one or more linked-data vocabularies.
List endpoints are used to generate pages that contain descriptions of items that are selected to meet particular criteria that are built in to the endpoint configuration and which may be augmented by parameters carried in the request URI that may narrow the range of items presented in a response. A given list endpoint produces a series of pages that together traverse the set of 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 views. A view is a projection of some part of the RDF graph that emanates from the topic item for an item endpoint or from the topic item of each item included in a response page from a listing 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 URI parameter
_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 as URI node or Literal items; a so-called b-node closure |
| all | As description, but including available labels for all objects that are mentioned. |
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
{P}
. 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 where 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 from 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
{P}
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 anbd
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 Engish, 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 available 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, {P}. 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, {P} Selected items must have a
value for {P} that is less than or equal to that given
in the parameters value |
| minEx-{P} | Sets an exclusive lower-bound filter on the value of the
given property chain, {P}. Selected items must have a
value for {P} that is greater than that given in the
parameters value |
| maxEx-{P} | Sets an exclusive upper-bound filter on the value of the
given property chain, {P}. Selected items must have a
value for {P} that is less than to that given in the
parameters 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 select views. |
| _sort | A comma separated list of property shortnames or property
chains which are used to order the items returned by 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
| 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}/. Currenly, {vocabulary}
= "bathing-water-profile". |
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 {term} 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 {term} 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 {term} 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 |
BathingWaterProfile
class from the bathing-water-profile vocabulary
presented through the endpoint’s default view.BathingWater class whose bathingWater.name
property chain has a value of “Spittal” presented through
the endpoints default view.Item type: VoID 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 | basic, description |
| View | Properties |
|---|---|
| basic | Built-in |
| description | Built-in |
Item type: BathingWaterProfile
| Endpoint URI Template http://location.data.gov.uk |
List or Item | Description | Views |
|---|---|---|---|
| /data/bathing-water-profile-dataset | Item | Describes the Bathing Water Profile dataset. | dataset, description, all |
| /data/bathing-water-profile-dataset/eaew | Item | Describes the Enviroment Agency for England and Wales Bathing Water Profile dataset. | dataset, description, all |
| /data/bathing-water-profile-dataset/eaew/{year} | Item | Describes the Enviroment Agency Bathing Water Profile dataset for a year. | dataset, description, all |
| /doc/bathing-water-profile | List | Lists all bathing water profiles. | short-profile, description, all |
| /doc/bathing-water-profile:latest | List | Lists the latest profile for all bathing waters. | short-profile, description, all |
| /doc/bathing-water-profile/{eubwid} | List | Lists all the bathing water profile versions for the specified bathing water. | short-profile, description, all |
| /doc/bathing-water-profile/{eubwid}:latest | Item | Describes latest bathing water profile for the specified bathing water. | profile, full-profile, description, all |
| /doc/bathing-water-profile/{eubwid}/{year} | List | Lists all the bathing water profile versions for the specified bathing water and year. | short-profile, description, all |
| /doc/bathing-water-profile/{eubwid}/{year}:latest | Item | Describes the latest version of a bathing-water profile for the specified bathing water and year. | profile, full-profile, description, all |
| /data/bathing-water-profile/{eubwid}/{year}:{ver} | Item | Describes a specific version of a bathing-water profile for the specified bathing water and year. | profile, full-profile, description, all |
| View | Properties |
|---|---|
| all | Built-in |
| description | Built-in |
| short profile | name, bathingWater, bathingWaterDescription, applicableYear, versionString |
| bathingWaterProfile | bathingWater.prefLabel, bathingWater.samplingPoint.name, bathingWater.samplingPoint.easting, bathingWater.samplingPoint.northing, bathingWater.samplingPoint.lat, bathingWater.samplingPoint.long, bathingWater.country.prefLabel, countyName, localAuthority.label, standardLanguageCollection.pollutionManagementGeneralStatement, standardLanguageCollection.stwOutfallsGeneralStatement, standardLanguageCollection.esoOutfallsGeneralStatement, standardLanguageCollection.localAuthorityGeneralStatement, standardLanguageCollection.algaeGeneralStatement, bathingWaterDescription, zoiDescription, streamsRiversStatement, investigationsStatement, historyStatement, stwOutfallsStatement, esoOutfallsStatement, localAuthorityStatement, misconnectionsStatement, workingWithFarmersStatement, workingWithIndustryStatement, workingWithPrivateOwnersStatement, macroAlgaeStatement, phytoplanktonStatement, webResImage, source, versionString |
| fullBathingWaterProfile | bathingWater.prefLabel, bathingWater.samplingPoint.name, bathingWater.samplingPoint.easting, bathingWater.samplingPoint.northing, bathingWater.samplingPoint.lat, bathingWater.samplingPoint.long, bathingWater.envelope.asGML, bathingWater.envelope.lowerCorner.easting, bathingWater.envelope.lowerCorner.northing, bathingWater.envelope.lowerCorner.x, bathingWate.envelope.lowerCorner.y, bathingWater.envelope.upperCorner.easting, bathingWater.envelope.upperCorner.northing, bathingWater.envelope.upperCorner.x, bathingWater.envelope.upperCorner.y, bathingWater.zoneOfInfluence.extent.asGML, bathingWater.country.prefLabel, countyName, localAuthority.label, standardLanguageCollection.pollutionManagementGeneralStatement, standardLanguageCollection.stwOutfallsGeneralStatement, standardLanguageCollection.esoOutfallsGeneralStatement, standardLanguageCollection.localAuthorityGeneralStatement, standardLanguageCollection.algaeGeneralStatement, bathingWaterDescription, zoiDescription, streamsRiversStatement, investigationsStatement, historyStatement, stwOutfallsStatement, esoOutfallsStatement, localAuthorityStatement, misconnectionsStatement, workingWithFarmersStatement, workingWithIndustryStatement, workingWithPrivateOwnersStatement, macroAlgaeStatement, phytoplanktonStatement, webResImage, source, versionString |
| dataset | name, label, type, comment, description, created, modified, subset, subset.label, subset.name, dataDump, vocabulary, vocabulary.label, license, source, uriRegexPattern |
Item type: StandardLanguageCollection
| Endpoint URI Template http://location.data.gov.uk |
List or Item | Description | Views |
|---|---|---|---|
| /data/bathing-water-profile-standard-language/{year}:{ver} | Item | Describes a collection of standard language statements. | description, all |
| /doc/bathing-water-profile-standard-language | List | Lists all bathing water profile standard language collections. | description, all |
| View | Properties |
|---|---|
| all | Built-in |
| description | Built-in |
Item type: BathingWaterProfileEndurant
| Endpoint URI Template http://location.data.gov.uk |
List or Item | Description | Views |
|---|---|---|---|
| /data/bathing-water-profile-endurant/{eubwid}/{year} | Item | Describes the enduring bathing water profile for a bathing water for the specified year which is essentially a list of the versions of the bathing water profiles for that year. | endurant, all |
| /doc/bathing-water-profile-endurant/{eubwid} | List | Lists all the enduring bathing water profiles for a bathing water. | endurant, description, all |
| View | Properties |
|---|---|
| all | Built-in |
| description | Built-in |
| endurant | hasVersion, hasVersion.label |
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/ef | List | List the known environmental facilities (ef) feature type vocabularies. | scheme, description, all |
| /def/ef/{featureType} | List | List the terms defined in a given feature type vocabulary,
ly {featureType} = "BathingWaterProfileFeature". |
definition, description, all |
| /def/ef/{featureType}/ | Item | Describe a given feature type vocabulary. | scheme, description, all |
| /def/ef/{featureType}/{term} | Item | Describe a given term within a given feature type vocabulary | definition, description, all |
| /def/ef/{featureType}/{term}/subclass | List | For a given {term} where http://location.data.gov.uk/def/ef/{featureType}/{term} is a class, returns a list of subclasses of that class. | definition, description, all |
| /def/ef/{featureType}/{term}/instance | List | For a given {term} where http://location.data.gov.uk/def/ef/{featureType}/{term} is a class, returns a list of instances of that class. | description |
| /def/ef/{featureType}/{term}/property | List | For a given {term} where http://location.data.gov.uk/def/ef/{featureType}/{term} is a class, returns a list of 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 |
BathingWaterProfileFeature
spatial-object feature-type. This includes class and property
definitions.Item type: Feature
| Endpoint URI Template http://location.data.gov.uk |
List or Item | Description | Views |
|---|---|---|---|
| /so/ef/BathingWaterProfileFeature/bwpf.eaew/ /doc/ef/BathingWaterProfileFeature/bwpf.eaew/ |
Item | Describes the Enviroment Agency Bathing Water Profile Feature Spatial-Object URI Set | description, all |
| /so/ef/BathingWaterProfileFeature/bwpf.eaew /doc/ef/BathingWaterProfileFeature/bwpf.eaew |
List | Lists all bathing-water profile features. | feature, description |
| /so/ef/BathingWaterProfileFeature/bwpf.eaew:latest /doc/ef/BathingWaterProfileFeature/bwpf.eaew:latest |
List | Lists all latest bathing-water profile features. | feature, description |
| /so/ef/BathingWaterProfileFeature/bwpf.eaew/{featureId} /doc/ef/BathingWaterProfileFeature/bwpf.eaew/{featureId} |
List | Lists all versions of a bathing-water profile feature. | feature, description |
| /so/ef/BathingWaterProfileFeature/bwpf.eaew/{featureId}:latest /doc/ef/BathingWaterProfileFeature/bwpf.eaew/{featureId}:latest |
Item | Lists the latest version of a bathing-water profile feature. | feature, description |
| /so/ef/BathingWaterProfileFeature/bwpf.eaew/{featureId}/{ver} /doc/ef/BathingWaterProfileFeature/bwpf.eaew/{featureId}/{ver} |
Item | Describes a specific version of a bathing-water profile feature. | feature, description |
| View | Properties |
|---|---|
| all | Built-in |
| description | Built-in |
| feature | type,type.label,label,bathingWater,bathingWater.name,lat,long,easting,northing,regionalOrganization,regionalOrganization.name |
all.Item type: BathingWaterProfileEndurant
| Endpoint URI Template http://location.data.gov.uk |
List or Item | Description | Views |
|---|---|---|---|
| /so/ef/BathingWaterProfileFeatureEndurant/bwpf.eaew/{id}
/doc/ef/BathingWaterProfileFeatureEndurant/bwpf.eaew/{id} |
Item | Describes an enduring bathing water profile feature. | endurant, description, all |
| /so/ef/BathingWaterProfileFeatureEndurant/bwpf.eaew
/doc/ef/BathingWaterProfileFeatureEndurant/bwpf.eaew |
List | Lists all the enduring bathing water profile features. | endurant, description, all |
| View | Properties |
|---|---|
| all | Built-in |
| description | Built-in |
| endurant | hasVersion, hasVersion.label |
A-UKC2102_03600-ID-2101349-1-1, i.e. at Spittal.
This effectively returns a list of the versions of this feature.| Shortname | URI long-name uri | Property range |
|---|---|---|
| algaeGeneralStatement | http://environment.data.gov.uk/def/bathing-water-profile/algaeGeneralStatement | |
| applicableYear | http://environment.data.gov.uk/def/bathing-water-profile/applicableYear | http://reference.data.gov.uk/def/intervals/Year |
| beginning | http://www.w3.org/2006/time#hasBeginning | |
| BathingWaterProfile | http://environment.data.gov.uk/def/bathing-water-profile/BathingWaterProfile | |
| bathingWaterDescription | http://environment.data.gov.uk/def/bathing-water-profile/bathingWaterDescription | |
| countyName | http://environment.data.gov.uk/def/bathing-water-profile/countyName | |
| currentVersion | http://environment.data.gov.uk/def/version/currentVersion | |
| DO | http://environment.data.gov.uk/def/BathingWaterProfileFeature/DO | |
| end | http://www.w3.org/2006/time#hasEnd | |
| EnduringBathingWaterProfile | http://environment.data.gov.uk/def/bathing-water-profile/EnduringBathingWaterProfile | |
| EnduringFeature | http://environment.data.gov.uk/def/BathingWaterProfileFeature/EnduringFeature | |
| ESO | http://environment.data.gov.uk/def/BathingWaterProfileFeature/ESO | |
| esoOutfallsGeneralStatement | http://environment.data.gov.uk/def/bathing-water-profile/esoOutfallsGeneralStatement | |
| Feature | http://environment.data.gov.uk/def/BathingWaterProfileFeature/Feature | |
| esoOutfallsStatement | http://environment.data.gov.uk/def/bathing-water-profile/esoOutfallsStatement | |
| historyStatement | http://environment.data.gov.uk/def/bathing-water-profile/historyStatement | |
| interval | http://environment.data.gov.uk/def/version/interval | |
| investigationsStatement | http://environment.data.gov.uk/def/bathing-water-profile/eaInvestigationsStatement | |
| inXSDDateTime | http://www.w3.org/2006/time#inXSDDateTime | |
| isVersionOf | http://purl.org/dc/terms/isVersionOf | |
| latestProfile | http://environment.data.gov.uk/def/bathing-water-profile/latestBathingWaterProfile | http://environment.data.gov.uk/def/bathing-water-profile/BathingWaterProfile |
| localAuthority | http://statistics.data.gov.uk/def/administrative-geography/localAuthority | |
| localAuthorityGeneralStatement | http://environment.data.gov.uk/def/bathing-water-profile/localAuthorityGeneralStatement | |
| localAuthorityStatement | http://environment.data.gov.uk/def/bathing-water-profile/localAuthorityStatement | |
| macroAlgaeStatement | http://environment.data.gov.uk/def/bathing-water-profile/macroAlgaeStatement | |
| misconnectionsStatement | http://environment.data.gov.uk/def/bathing-water-profile/misconnectionsStatement | |
| pollutionManagementGeneralStatement | http://environment.data.gov.uk/def/bathing-water-profile/pollutionManagementGeneralStatement | |
| phytoplanktonStatement | http://environment.data.gov.uk/def/bathing-water-profile/phytoplanktonStatement | |
| RSI | http://environment.data.gov.uk/def/BathingWaterProfileFeature/RSI | |
| StandardLanguageCollection | http://environment.data.gov.uk/def/bathing-water-profile/StandardLanguageCollection | |
| standardLanguageCollection | http://environment.data.gov.uk/def/bathing-water-profile/standardLanguageCollection | http://environment.data.gov.uk/def/bathing-water-profile/StandardLanguageCollection |
| stwOutfallsGeneralStatement | http://environment.data.gov.uk/def/bathing-water-profile/stwOutfallsGeneralStatement | |
| stwOutfallsStatement | http://environment.data.gov.uk/def/bathing-water-profile/stwOutfallsStatement | |
| streamsRiversStatement | http://environment.data.gov.uk/def/bathing-water-profile/streamsRiversStatement | |
| SWO | http://environment.data.gov.uk/def/BathingWaterProfileFeature/SWO | |
| TSO | http://environment.data.gov.uk/def/BathingWaterProfileFeature/TSO | |
| version | http://purl.org/dc/terms/hasVersion | |
| versionString | http://environment.data.gov.uk/def/version/versionString | |
| webResImage | http://environment.data.gov.uk/def/bathing-water-profile/webResImage | |
| workingWithFarmersStatement | http://environment.data.gov.uk/def/bathing-water-profile/workingWithFarmersStatement | |
| workingWithIndustryStatement | http://environment.data.gov.uk/def/bathing-water-profile/workingWithIndustryStatement | |
| workingWithPrivateOwnersStatement | http://environment.data.gov.uk/def/bathing-water-profile/workingWithPrivateOwnersStatement | |
| zoiDescription | http://environment.data.gov.uk/def/bathing-water-profile/zoiDescription |
The property short names defined in the Bathing-Water Quality API Reference Documentation are available in this end point. A list of these is reproduced here for convenience.