Supported web service versions
To make new functionality available to web service users and still be able to support applications based on old versions of the NBN Gateway web service, the NBN Gateway provides different versions of the web services.
Older versions of the web service will still be available for 12 months after the release of a newer version,
but we advise users to move to a new version as soon as possible to make use of new functionality and bug fixes.
Latest Web Services Release is Version 3.4 (March 25th 2010)
Url to WSDL: http://www.nbnws.net/ws_3_4/ws/WSDL
Url to WSDL with digest authentication: http://www.nbnws.net/ws_3_4/ws/secure/WSDL
Url to designation discovery service WSDL: http://www.nbnws.net/ws_3_4/ws/resources/Resources?WSDL
Url to habitat service WSDL: http://www.nbnws.net/HabitatPolygonWebservices/HabitatWebserviceService?WSDL
Url to designation discovery service WSDL: http://www.nbnws.net/ws_3_4/ws/resources/Resources?WSDL
Release Notes
- Taxonomy web service: return taxa with no records on NBN Gateway - Taxonomy web service now returns taxonomic information for taxa even when that the taxon does not have any records for the on the NBN Gateway.
- New One Species Location web service - This new web service retrieves unique squares in which a single species’ records occurs. This service aggregates data from multiple data sets available for a species and provides data for the entire UK and Ireland.
- New Polygon-in Polygon Habitat web services - Two new webservices to allow the discovery and query of the new habitat datasets have been created. The Habitat Discovery webservice allows the retrieval of a list of all queryable habitat layers. The Habitat Query webservice allows the determination of the shape and coverage of any habitats within a user defined polygon for the habitat layers.
- Dataset Summary tag extended to return Access Privileges - For all NBN webservices the dataset summary portion of the response now includes the access privileges to the dataset(s).
- Improvement to Dataset Summary List web service - This webservice now allows the application of a filter to the returned list of species datasets. For example a filter can be applied to list datasets to which have View Sensitive or View Attributes access.
- Improvement to Species List web service - This web service now returns several species level attributes. These attributes are record count and temporal range. As long as the dataset has download access then these attributes are returned based on the requested filters.
- GeographicalFilter element - Enumeration value for polygon parameter now includes EPSG-4326 and WGS-84 coordinate projection systems.
- SpeciesRecord element - SpeciesRecord element now returns attribute data for record provided access to attributes is given to dataset.
Deprecated Versions
NBN Gateway Web Services 3.2
Url to WSDL: http://www.nbnws.net/ws/WSDL
Url to WSDL with digest authentication: http://www.nbnws.net/ws/secure/WSDL
Supported until 1st September 2010
NBN Gateway Web Services 3.3
Url to WSDL: http://www.nbnws.net/ws_3_3/ws/WSDL
Url to WSDL with digest authentication: http://www.nbnws.net/ws_3_3/ws/secure/WSDL
Supported until 1st April 2011