NBN Web Services

Example PHP Implementations

• Direct calls using PHP
• Simple .NET wrapper calls

Get Site Data

View datasets with records of Zostera (Eel Grass, NHMSYS0000465247) recorded in Vice County: West Cornwall & Scillies (1) East Cornwall (2) South Devon (3) North Devon (4) South Somerset (5) North Somerset (6) North Wiltshire (7) South Wiltshire (8) Dorset (9) Isle of Wight (10)

The green squares on the map indicate where Zostera has been recorded in 10km squares.
To get a list of all vice counties, click here.

Click here to view the source code.

Click here to view the request to the server.

Click here to view the returned XML file.

Results

---

Data Providers with Zostera records

Click on the Dataset Key to filter records by Dataset Providers, or click here to remove Dataset Providers from the query.

Dataset Key	Title	Provider	Abstract
GA000617	HBIC and partners species records	Hampshire Biodiversity Information Centre	Description Vascular plant and other species records to June 2009 owned and managed by the Hampshire Biodiversity Information Centre (HBIC) Partnership or held by HBIC on behalf of an individual partner organisation. Method This data has been collected mainly by professional ecologists working for HBIC and previously a number of HBIC partners. It includes records of all vascular plants recorded through Hampshire's Habitat Survey Partnership Project plus a small number of records for a range of taxonomic groups provided through various other survey programmes. Purpose Geographical Coverage The dataset covers Hampshire and the surrounding area. The majority of records in this dataset are collated with 8-figure grid references, but these grid references refer the approximate central location of sites and hence do not represent the actual location of each species occurrence. Geographical Coverage The dataset covers Hampshire and the surrounding area. The majority of records in this dataset are collated with 8-figure grid references, but these grid references refer the approximate central location of sites and hence do not represent the actual location of each species occurrence. Temporal Coverage The dataset contains records using a variety of date styles and ranges. Some are recorded by year or season but the majority of records have a full date (e.g. DD/MM/YYYY). Data Quality The majority of this dataset has been recorded by experienced field ecologists and local experts. Some records of protected or notable taxa have been verified by the relevant County Recorders but this process is ongoing. Older data have not been reassessed in light of recent taxonomic splits or aggregations. All records should therefore be checked against original sources before being used in any circumstances. For further information please contact HBIC via email: enquiries.hbic@hants.gov.uk Additional Information HBIC offers a comprehensive enquiry service, also known as Data Requests. The information that is provided is made as reader-friendly as possible, and is accompanied by explanatory notes and definitions of terminology used. More information can be found at <a href??www.hants.gov.uk/biodiversity/hbic/hbic-datarequests.htm?>www.hants.gov.uk/biodiversity/hbic/hbic-datarequests.htm</a>.

---

Request to Server

POST /ws/webservice HTTP/1.0 Host: www.nbnws.net User-Agent: NuSOAP/0.7.2 (1.94) Content-Type: text/xml; charset=UTF-8 SOAPAction: "http://webservices.searchnbn.net/service/GetGridMap" Content-Length: 794 <?xml version="1.0" encoding="UTF-8"?><SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:nbnq="http://webservices.searchnbn.net/query"><SOAP-ENV:Body><GridMapRequest xmlns="http://webservices.searchnbn.net/query"> <TaxonVersionKey>NHMSYS0000465247</TaxonVersionKey> <Resolution>_10km</Resolution> <DatasetList><DatasetKey>GA000617</DatasetKey></DatasetList> <GridMapSettings> <Width>400</Width> <Height>400</Height> <Background>OSMap</Background> <ViceCounty>1</ViceCounty> <Region>GB</Region> </GridMapSettings> </GridMapRequest></SOAP-ENV:Body></SOAP-ENV:Envelope>

---

Back to the top

---

The Returned XML File

<?xml version="1.0" encoding="utf-8"?><GridMap xmlns="http://webservices.searchnbn.net/data" xmlns:xsd="http://www.w3.org/2001/XMLSchema" NBNLogo="http://data.nbn.org.uk/images/NBNPower.gif" attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="http://webservices.searchnbn.net/data" termsAndConditions="http://data.nbn.org.uk/help/popups/generalTerms.jsp" version="1.1">
<Map>
<Url>http://data.nbn.org.uk/output/gridGBv4_nbnims-243643632448.gif</Url>
<Width>400</Width>
<Height>400</Height>
<Format>image/gif</Format>
<BoundingBox maxx="199100.15" maxy="100173.275" minx="82643.5999999996" miny="-16283.2750000002" srs="osgb_BNG"/>
</Map>
<Species taxonVersionKey="NHMSYS0000465247"><ScientificName>Zostera</ScientificName><CommonName>Eelgrass</CommonName><Authority>L.</Authority><TaxonReportingCategory>flowering plant</TaxonReportingCategory></Species>
<DatasetSummaryList><DatasetSummary id="GA000617">
<ProviderMetadata datestamp="" exchangeFormatVersion="1.0">
<DatasetTitle><![CDATA[HBIC and partners species records]]></DatasetTitle>
<DatasetProvider><![CDATA[Hampshire Biodiversity Information Centre]]></DatasetProvider>
<Abstract>
<Description><![CDATA[ Vascular plant and other species records to June 2009 owned and managed by the Hampshire Biodiversity Information Centre (HBIC) Partnership or held by HBIC on behalf of an individual partner organisation.]]></Description>
<DataCaptureMethod><![CDATA[ This data has been collected mainly by professional ecologists working for HBIC and previously a number of HBIC partners. It includes records of all vascular plants recorded through Hampshire&#39;s Habitat Survey Partnership Project plus a small number of records for a range of taxonomic groups provided through various other survey programmes.]]></DataCaptureMethod>
<Purpose><![CDATA[ Most of the records were collected as part of the ongoing surveying and monitoring of Hampshire&#39;s habitats carried out by field ecologists based at HBIC and it&#39;s predecessors for the purposes of development control, land management planning and the monitoring of wildlife sites. This is part of a survey programme which has been running in Hampshire since the late 1970&#39;s.]]></Purpose>
<GeographicalCoverage><![CDATA[ The dataset covers Hampshire and the surrounding area.  The majority of records in this dataset are collated with 8&#45;figure grid references, but these grid references refer the approximate central location of sites and hence do not represent the actual location of each species occurrence.]]></GeographicalCoverage>
<TemporalCoverage><![CDATA[ The dataset contains records using a variety of date styles and ranges.  Some are recorded by year or season but the majority of records have a full date (e.g. DD&#47;MM&#47;YYYY).]]></TemporalCoverage>
<DataQuality><![CDATA[ The majority of this dataset has been recorded by experienced field ecologists and local experts. Some records of protected or notable taxa have been verified by the relevant County Recorders but this process is ongoing. Older data have not been reassessed in light of recent taxonomic splits or aggregations. All records should therefore be checked against original sources before being used in any circumstances.  For further information please contact HBIC via email: enquiries.hbic&#64;hants.gov.uk]]></DataQuality>
<AdditionalInformation><![CDATA[ HBIC offers a comprehensive enquiry service, also known as Data Requests. The information that is provided is made as reader&#45;friendly as possible, and is accompanied by explanatory notes and definitions of terminology used.  More information can be found at &lt;a href??www.hants.gov.uk&#47;biodiversity&#47;hbic&#47;hbic&#45;datarequests.htm?&gt;www.hants.gov.uk&#47;biodiversity&#47;hbic&#47;hbic&#45;datarequests.htm&lt;&#47;a&gt;.]]></AdditionalInformation>
</Abstract>
<AccessConstraints><![CDATA[ Access to this dataset is restricted for the following reason. Disclosure of this information at full resolution would adversely affect the interests of the Hampshire Biodiversity Information Centre (HBIC) and its partners. HBIC is not under any legal obligation to supply the information to the public through the NBN Gateway and has not consented to its wider release because either: &lt;br &#47;&gt;&lt;br &#47;&gt;  a) Wider release may adversely affect the free flow of volunteered information from HBIC&#39;s partners and third parties &lt;br &#47;&gt;&lt;br &#47;&gt;  b) Wider release may adversely affect financial support required to sustain the ongoing recording of species and habitat data, the support of partnership recording activities, or the collation and management of these records.&lt;br &#47;&gt;&lt;br &#47;&gt;  Access to records in this dataset may be made available through HBIC&#39;s Data Request service or under licence to approved individuals and organisations through a Data Supply Agreement.  You may be required to either pay a one&#45;off service charge or enter into a longer term funding arrangement with the data provider.  ]]></AccessConstraints>
<UseConstraints><![CDATA[ ]]></UseConstraints></ProviderMetadata></DatasetSummary></DatasetSummaryList></GridMap>

---

Source code for this page

/* * NBN Gateway SOAP Client Sample: * Author: James Perrins, * exeGesIS SDM * 3rd March 2006 */ $client = new soapclient("http://212.219.37.104/NBNWebServices/ws/WSDL", 'true', $proxyhost, $proxyport, $proxyusername, $proxypassword); // Set timeouts, nusoap default is 30 $client->timeout = 500; $client->response_timeout = 500; $err = $client->getError(); if ($err) { echo '<h2>Constructor error</h2><pre>' . $err . '</pre>'; }?> <form action="<? echo $_SERVER['PHP_SELF']; ?>" method="post"> View datasets with records of <em>Zostera</em> (Eel Grass, NHMSYS0000465247) recorded in Vice County: <SELECT NAME="vice"> <option VALUE=1>West Cornwall & Scillies (1)</option> <option VALUE=2>East Cornwall (2)</option> <option VALUE=3>South Devon (3)</option> <option VALUE=4>North Devon (4)</option> <option VALUE=5>South Somerset (5)</option> <option VALUE=6>North Somerset (6)</option> <option VALUE=7>North Wiltshire (7)</option> <option VALUE=8>South Wiltshire (8)</option> <option VALUE=9>Dorset (9)</option> <option VALUE=10>Isle of Wight (10)</option> </SELECT> <input name="x" type="submit"> </form> <? //Check to see if a vice county has been selected from the form or in the query string. if(isset($_GET["vice"])){ $_POST["vice"]=$_GET["vice"]; } if(isset($_POST["vice"])){ $vc = $_POST["vice"]; }else{ $vc="1"; } if(isset($_GET["gid"])){ $gid="<DatasetList><DatasetKey>".$_GET["gid"]."</DatasetKey></DatasetList>"; }else{ $gid=""; } $query1 = '<GridMapRequest xmlns="http://webservices.searchnbn.net/query"> <TaxonVersionKey>NHMSYS0000465247</TaxonVersionKey> <Resolution>Any</Resolution> '.$gid.' <GridMapSettings> <Width>400</Width> <Height>400</Height> <Background>OSMap</Background> <ViceCounty>'.$vc.'</ViceCounty> <Region>GB</Region> </GridMapSettings> </GridMapRequest>'; $result = $client->call("GetGridMap", $query1); $debug = $client->getDebug(); print '<h2>Results</h2>'; //the xml returned from the gateway appears to be missing the xml header which upsets PHP - so fix it first $obj = simplexml_load_string(fixupxml($client->response)); //drop in returned values as image source echo '<img src="',$obj->Map->Url,'"</>'; print ("<hr>"); echo "<h2>Data Providers with <em>Zostera</em> records</h2>"; echo "<p>Click on the Dataset Key to filter records by Dataset Providers, or <a href=\"/NBNServices/GetGridMapExample.php\">click here to remove Dataset Providers</a> from the query.</p>"; echo "<table><thead><tr><th>Dataset Key</th><th>Title</th><th>Provider</th><th>Description</th></tr></thead>"; foreach ($obj->DatasetSummary as $DataSet) { echo '<tr><td valign="top"><a href="?gid='.$DataSet->ProviderMetadata["gatewayId"].'&vice='.$vc.'">', $DataSet->ProviderMetadata["gatewayId"],'</a></td><td valign="top">', $DataSet->ProviderMetadata->DatasetTitle,'</td><td valign="top">',$DataSet->ProviderMetadata->DatasetProvider, '</td><td>',$DataSet->ProviderMetadata->Abstract->Description, '</td></tr>'; } echo "</table>"; print ("<hr>"); print '<a name="req"></a><h2>Request to Server</h2>'; echo '<xmp>'.$client->request.'</xmp>'; print "<hr><a href=\"#top\">Back to the top</a><hr>"; echo "<a name='xml'></a><h2>The Returned XML File</h2><pre>"; print htmlspecialchars(fixupxml($client->response)); echo "</pre>";