MarLIN Example NBN Web Services

Get Species List

This service returns a list of species. In this example, x,y coordinates and a buffer distance are specified. The list of species returned is restricted by a Taxon Group Key (in this case NHMSYS0000080051 - Echinoderms), a list of current keys can be viewed by clicking 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.

Taxon Group	Scientific name	Common Name
Echinoderm	Amphipholis squamata ((Chiaje, 1829))
Echinoderm	Amphiura (Forbes, 1843)
Echinoderm	Amphiura brachiata ((Montagu, 1804))
Echinoderm	Echinocardium cordatum ((Pennant, 1777))
Echinoderm	Ophiura (Lamarck, 1816)
Echinoderm	Ophiura ophiura ((Linnaeus, 1758))
Echinoderm	Ophiuridae ()
Echinoderm	Echinocyamus pusillus ((O. F. MÁller, 1776))	Green Sea Urchin
Echinoderm	Thyone fusus ((O. F. MÁller, 1776))
Echinoderm	Amphiura filiformis ((O. F. MÁller, 1776))
Echinoderm	Echinocardium (J. E. Gray, 1825)
Echinoderm	Holothuria forskali (Chiaje, 1841)	Cotton Spinner
Echinoderm	Marthasterias glacialis ((Linnaeus, 1758))
Echinoderm	Echinus esculentus (Linnaeus, 1758)	Edible Sea Urchin
Echinoderm	Ophiuroidea ()
Echinoderm	Aslia lefevrei ((Barrois, 1882))	Brown Sea Cucumber
Echinoderm	Asterias rubens (Linnaeus, 1758)
Echinoderm	Asterina gibbosa ((Pennant, 1777))
Echinoderm	Henricia oculata ((Pennant, 1777))	Bloody Henry Starfish
Echinoderm	Neopentadactyla mixta ((Ostergren, 1898))	Gravel Sea Cucumber
Echinoderm	Ophiocomina nigra ((Abildgaard, 1789))
Echinoderm	Ophiothrix fragilis ((Abildgaard, 1789))	Common Brittlestar
Echinoderm	Pawsonia saxicola ((Brady & Robertson, 1871))	Sea Gherkin
Echinoderm	Thyone (Jaeger, 1833)
Echinoderm	Henricia (J. E. Gray, 1840)
Echinoderm	Asteroidea ()
Echinoderm	Echinoidea ()
Echinoderm	Astropecten irregularis ((Pennant, 1777))	Sand Star
Echinoderm	Psolus phantapus ((Strussenfeldt, 1765))
Echinoderm	Asterinidae ()
Echinoderm	Holothuroidea ()

Data Providers

Title	Provider	Description
DASSH Data Archive Centre volunteer survey data	Marine Biological Association	A collection of marine life surveys collated by the Marine Life Information Network (<i>MarLIN</i>) as part of their data access program and now incoporated into the DASSH Data Archive Centre. Although this data is freely available Data ownership remains with the original data provider and permission must be saught to use this data for academic or commercial purposes. This data is released under DASSH Terms and Conditions available from www.dassh.ac.uk.
Seasearch Marine Surveys	Marine Conservation Society	This dataset consists of habitat and species records made by volunteer scuba divers. The data from 1978-1987 comprises sub-littoral surveys carried out by members of the Marine Conservation Society. The data from 1988-2000 comprises data using the initial Seasearch methodology by members of the Marine Conservation Society and associated organisations, including Sussex Seasearch. The data from 2001 onwards has been collected using the revised Seasearch methodology which has two main levels of detail. The Observation Form level provides a single sample containing habitat and species data from each site. The Survey Form level provides multiple habitat and species lists. This data has been collected from dives organised by the Marine Conservation Society, County Wildlife Trusts, Sussex Seasearch, dive clubs and individuals. Data has been entered by MCS and partner organisations and is freely available.
Marine Nature Conservation Review (MNCR) and associated benthic marine data held and managed by English Nature	Natural England	This dataset includes the survey data that were commissioned and collected by English Nature. Note these data complement other datasets held by JNCC and the other country agencies that used the same methodology. However, this dataset comprises those data that were paid for by EN directly. The data contributed to the MNCR programme which was initiated to provide a comprehensive baseline of information on marine habitats and their associated species around the coast of Britain which would aid coastal zone and sea-use management and to contribute to the identification of areas of marine natural heritage importance. The focus of MNCR work was on benthic habitats (often referred to as 'biotopes') in intertidal and inshore (typically within 3nm) subtidal areas.
Marine Nature Conservation Review (MNCR) and associated benthic marine data held and managed by JNCC	Joint Nature Conservation Committee	This dataset includes the survey data that were collected during the Marine Nature Conservation Review (MNCR) between 1987 and 1998, together with data from surveys commissioned by the Nature Conservancy Council in the 1970s and 1980s and data collected subsequently by JNCC. The MNCR was initiated to provide a comprehensive baseline of information on marine habitats and their associated species around the coast of Britain which would aid coastal zone and sea-use management and to contribute to the identification of areas of marine natural heritage importance. The focus of MNCR work was on benthic habitats (often referred to as 'biotopes') in intertidal and inshore (typically within 3nm) subtidal areas.

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/GetSpeciesList" Content-Length: 754 <?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><SpeciesListRequest xmlns="http://webservices.searchnbn.net/query"> <GeographicalFilter> <Buffer xmlns="http://webservices.searchnbn.net/data"> <Point srs="osgb_BNG" x="247500" y="50500" /> <Distance>1000</Distance></Buffer> </GeographicalFilter> <TaxonReportingCategoryKey>NHMSYS0000080051</TaxonReportingCategoryKey> </SpeciesListRequest></SOAP-ENV:Body></SOAP-ENV:Envelope>

Back to the top

The Returned XML File

<?xml version="1.0" encoding="utf-8"?><SpeciesListResponse 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">
<SpeciesList><Species taxonVersionKey="NBNSYS0000173758"><ScientificName>Amphipholis squamata</ScientificName><CommonName/><Authority>(Chiaje, 1829)</Authority><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NBNSYS0000173776"><ScientificName>Amphiura</ScientificName><CommonName/><Authority>Forbes, 1843</Authority><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NBNSYS0000173777"><ScientificName>Amphiura brachiata</ScientificName><CommonName/><Authority>(Montagu, 1804)</Authority><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NBNSYS0000175060"><ScientificName>Echinocardium cordatum</ScientificName><CommonName/><Authority>(Pennant, 1777)</Authority><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NBNSYS0000176874"><ScientificName>Ophiura</ScientificName><CommonName/><Authority>Lamarck, 1816</Authority><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NBNSYS0000176877"><ScientificName>Ophiura ophiura</ScientificName><CommonName/><Authority>(Linnaeus, 1758)</Authority><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NBNSYS0000176881"><ScientificName>Ophiuridae</ScientificName><CommonName/><Authority/><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NHMSYS0001908729"><ScientificName>Echinocyamus pusillus</ScientificName><CommonName>Green Sea Urchin</CommonName><Authority>(O. F. M&amp;#193;ller, 1776)</Authority><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NHMSYS0001908754"><ScientificName>Thyone fusus</ScientificName><CommonName/><Authority>(O. F. M&amp;#193;ller, 1776)</Authority><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NHMSYS0001908759"><ScientificName>Amphiura filiformis</ScientificName><CommonName/><Authority>(O. F. M&amp;#193;ller, 1776)</Authority><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NHMSYS0001908809"><ScientificName>Echinocardium</ScientificName><CommonName/><Authority>J. E. Gray, 1825</Authority><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NBNSYS0000175800"><ScientificName>Holothuria forskali</ScientificName><CommonName>Cotton Spinner</CommonName><Authority>Chiaje, 1841</Authority><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NBNSYS0000176382"><ScientificName>Marthasterias glacialis</ScientificName><CommonName/><Authority>(Linnaeus, 1758)</Authority><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NBNSYS0000188576"><ScientificName>Echinus esculentus</ScientificName><CommonName>Edible Sea Urchin</CommonName><Authority>Linnaeus, 1758</Authority><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NBNSYS0000160573"><ScientificName>Ophiuroidea</ScientificName><CommonName/><Authority/><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NBNSYS0000173982"><ScientificName>Aslia lefevrei</ScientificName><CommonName>Brown Sea Cucumber</CommonName><Authority>(Barrois, 1882)</Authority><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NBNSYS0000174000"><ScientificName>Asterias rubens</ScientificName><CommonName/><Authority>Linnaeus, 1758</Authority><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NBNSYS0000174002"><ScientificName>Asterina gibbosa</ScientificName><CommonName/><Authority>(Pennant, 1777)</Authority><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NBNSYS0000175727"><ScientificName>Henricia oculata</ScientificName><CommonName>Bloody Henry Starfish</CommonName><Authority>(Pennant, 1777)</Authority><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NBNSYS0000176670"><ScientificName>Neopentadactyla mixta</ScientificName><CommonName>Gravel Sea Cucumber</CommonName><Authority>(Ostergren, 1898)</Authority><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NBNSYS0000176861"><ScientificName>Ophiocomina nigra</ScientificName><CommonName/><Authority>(Abildgaard, 1789)</Authority><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NBNSYS0000176873"><ScientificName>Ophiothrix fragilis</ScientificName><CommonName>Common Brittlestar</CommonName><Authority>(Abildgaard, 1789)</Authority><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NBNSYS0000177038"><ScientificName>Pawsonia saxicola</ScientificName><CommonName>Sea Gherkin</CommonName><Authority>(Brady &amp;amp; Robertson, 1871)</Authority><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NBNSYS0000178383"><ScientificName>Thyone</ScientificName><CommonName/><Authority>Jaeger, 1833</Authority><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NHMSYS0001908824"><ScientificName>Henricia</ScientificName><CommonName/><Authority>J. E. Gray, 1840</Authority><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NBNSYS0000159457"><ScientificName>Asteroidea</ScientificName><CommonName/><Authority/><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NBNSYS0000159900"><ScientificName>Echinoidea</ScientificName><CommonName/><Authority/><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NBNSYS0000174007"><ScientificName>Astropecten irregularis</ScientificName><CommonName>Sand Star</CommonName><Authority>(Pennant, 1777)</Authority><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NBNSYS0000177571"><ScientificName>Psolus phantapus</ScientificName><CommonName/><Authority>(Strussenfeldt, 1765)</Authority><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NBNSYS0000179494"><ScientificName>Asterinidae</ScientificName><CommonName/><Authority/><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
<Species taxonVersionKey="NHMSYS0000066195"><ScientificName>Holothuroidea</ScientificName><CommonName/><Authority/><TaxonReportingCategory>echinoderm</TaxonReportingCategory></Species>
</SpeciesList><DatasetSummaryList><DatasetSummary id="GA000189">
<ProviderMetadata datestamp="" exchangeFormatVersion="1.0">
<DatasetTitle><![CDATA[DASSH Data Archive Centre volunteer survey data]]></DatasetTitle>
<DatasetProvider><![CDATA[Marine Biological Association]]></DatasetProvider>
<Abstract>
<Description><![CDATA[ A collection of marine life surveys collated by the Marine Life Information Network (&lt;i&gt;MarLIN&lt;&#47;i&gt;) as part of their data access program and now incoporated into the DASSH Data Archive Centre.   Although this data is freely available Data ownership remains with the original data provider and permission must be saught to use this data for academic or commercial purposes. This data is released under DASSH Terms and Conditions available from www.dassh.ac.uk. ]]></Description>
<DataCaptureMethod><![CDATA[ Various]]></DataCaptureMethod>
<Purpose><![CDATA[ ]]></Purpose>
<GeographicalCoverage><![CDATA[ UK]]></GeographicalCoverage>
<TemporalCoverage><![CDATA[ ]]></TemporalCoverage>
<DataQuality><![CDATA[ Collected by volunteers but QA&#39;d ]]></DataQuality>
<AdditionalInformation><![CDATA[ www.dassh.ac.uk]]></AdditionalInformation>
</Abstract>
<AccessConstraints><![CDATA[ Released under DASSH terms and Conditions]]></AccessConstraints>
<UseConstraints><![CDATA[ Released under DASSH terms and Conditions]]></UseConstraints></ProviderMetadata></DatasetSummary><DatasetSummary id="GA000194">
<ProviderMetadata datestamp="" exchangeFormatVersion="1.0">
<DatasetTitle><![CDATA[Seasearch Marine Surveys ]]></DatasetTitle>
<DatasetProvider><![CDATA[Marine Conservation Society]]></DatasetProvider>
<Abstract>
<Description><![CDATA[ This dataset consists of habitat and species records made by volunteer scuba divers.  The data from 1978&#45;1987 comprises sub&#45;littoral surveys carried out by members of the Marine Conservation Society.  The data from 1988&#45;2000 comprises data using the initial Seasearch methodology by members of the Marine Conservation Society and associated organisations, including Sussex Seasearch.  The data from 2001 onwards has been collected using the revised Seasearch methodology which has two main levels of detail. The Observation Form level provides a single sample containing habitat and species data from each site. The Survey Form level provides multiple habitat and species lists. This data has been collected from dives organised by the Marine Conservation Society, County Wildlife Trusts, Sussex Seasearch, dive clubs and individuals. Data has been entered by MCS and partner organisations and is freely available.     ]]></Description>
<DataCaptureMethod><![CDATA[ Data is obtained from visual observations by divers. Most participating recorders have been through a training process and some are professional marine biologists. Records are validated before entry into Marine Recorder.]]></DataCaptureMethod>
<Purpose><![CDATA[ To provide baseline information on marine habitats and species throughout the UK]]></Purpose>
<GeographicalCoverage><![CDATA[ Whole of the UK. Limited records from Eire, Isle of Man and Channel Islands]]></GeographicalCoverage>
<TemporalCoverage><![CDATA[ 1978 to present time]]></TemporalCoverage>
<DataQuality><![CDATA[ Data is provided by volunteers who have a wide range of species knowledge. Most have been through a training programme. Records are validated before entry into Marine Recorder.]]></DataQuality>
<AdditionalInformation><![CDATA[ All data is held in marine Recorder both centrally and at a local level. Additional functionality is available in Marine Recorder, particularly as far as survey and habitat data are concerned. Users wishing to access the fuller data should email info&#64;seasearch.org.uk in the first instance.]]></AdditionalInformation>
</Abstract>
<AccessConstraints><![CDATA[ There are no access constraints]]></AccessConstraints>
<UseConstraints><![CDATA[ None. Seasearch&#47;MCS should be acknowledged as the source of data as appropriate]]></UseConstraints></ProviderMetadata></DatasetSummary><DatasetSummary id="GA000171">
<ProviderMetadata datestamp="" exchangeFormatVersion="1.0">
<DatasetTitle><![CDATA[Marine Nature Conservation Review (MNCR) and associated benthic marine data held and managed by English Nature]]></DatasetTitle>
<DatasetProvider><![CDATA[Natural England]]></DatasetProvider>
<Abstract>
<Description><![CDATA[ This dataset includes the survey data that were commissioned and collected by English Nature. Note these data complement other datasets held by JNCC and the other country agencies that used the same methodology. However, this dataset comprises those data that were paid for by EN directly. The data contributed to the MNCR programme which was initiated to provide a comprehensive baseline of information on marine habitats and their associated species around the coast of Britain which would aid coastal zone and sea&#45;use management and to contribute to the identification of areas of marine natural heritage importance. The focus of MNCR work was on benthic habitats (often referred to as &#39;biotopes&#39;) in intertidal and inshore (typically within 3nm) subtidal areas. ]]></Description>
<DataCaptureMethod><![CDATA[ The majority of data were collected using methods described in the MNCR Rational and Methods report (Hiscock 1996). Broadly, this encompassed surveying a range of sites within a geographical area to sample and describe the variety of habitats present (sampling habitats in different substrata, depths, wave exposures, current regimes, salinity regimes and so on). Each habitat was sampled using semi&#45;quantitative recording techniques (SACFOR abundance scales) for recording epibiota on rocky habitats]]></DataCaptureMethod>
<Purpose><![CDATA[ ]]></Purpose>
<GeographicalCoverage><![CDATA[ This dataset relates to England. Note however that the dataset ?Marine Nature Conservation Review (MNCR) and associated benthic marine data held and managed by JNCC? also includes equivalent and complementary data from England. ]]></GeographicalCoverage>
<TemporalCoverage><![CDATA[ The data were collected post 1992.]]></TemporalCoverage>
<DataQuality><![CDATA[ The data have been extensively checked during the course of the creation of the various reports produced by the MNCR programme. This included the MNCR Area Summary report series which describes the marine habitats in particular regions around the UK and the creation of the national marine habitat (biotope) classification system. Through this work the vast majority of the anomalies and errors in the data should have been identified but some may still remain.     ]]></DataQuality>
<AdditionalInformation><![CDATA[ ]]></AdditionalInformation>
</Abstract>
<AccessConstraints><![CDATA[ There are no access constraints to this dataset. All data are fully publicly available. Note that access has not been granted to data flagged as sensitive but currently there are no data within this dataset flagged in this way.]]></AccessConstraints>
<UseConstraints><![CDATA[ There are no constraints on how these data may be used other than those covered by the standard Gateway Terms and Conditions.]]></UseConstraints></ProviderMetadata></DatasetSummary><DatasetSummary id="GA000190">
<ProviderMetadata datestamp="" exchangeFormatVersion="1.0">
<DatasetTitle><![CDATA[Marine Nature Conservation Review (MNCR) and associated benthic marine data held and managed by JNCC]]></DatasetTitle>
<DatasetProvider><![CDATA[Joint Nature Conservation Committee]]></DatasetProvider>
<Abstract>
<Description><![CDATA[ This dataset includes the survey data that were collected during the Marine Nature Conservation Review (MNCR) between 1987 and 1998, together with data from surveys commissioned by the Nature Conservancy Council in the 1970s and 1980s and data collected subsequently by JNCC. The MNCR was initiated to provide a comprehensive baseline of information on marine habitats and their associated species around the coast of Britain which would aid coastal zone and sea&#45;use management and to contribute to the identification of areas of marine natural heritage importance. The focus of MNCR work was on benthic habitats (often referred to as &#39;biotopes&#39;) in intertidal and inshore (typically within 3nm) subtidal areas.]]></Description>
<DataCaptureMethod><![CDATA[ The majority of data were collected using methods described in the MNCR Rationale and Methods report (Hiscock 1996). Broadly, this encompassed surveying a range of sites within a geographical area to sample and describe the variety of habitats present (sampling habitats in different substrata, depths, wave exposures, current regimes, salinity regimes and so on). Each habitat was sampled using semi&#45;quantitative recording techniques (SACFOR abundance scales) for recording epibiota on rocky habitats.]]></DataCaptureMethod>
<Purpose><![CDATA[ The main purpose of the MNCR programme was to advance the basic knowledge of the near shore benthos. This included:   &#45; identifying sites and species of nature conservation importance.    &#45; extend our knowledge of benthic marine habitats, communities and species in Great Britain, particularly through description of their characteristics, distribution and extent.    &#45; provide information through the data collected to support more general measures required to minimize adverse effects of development. ]]></Purpose>
<GeographicalCoverage><![CDATA[ This dataset relates to Great Britain. Note that other equivalent datasets exist which include data which JNCC are not responsible for. These have additional coverage for Great Britain and equivalent data for Ireland.]]></GeographicalCoverage>
<TemporalCoverage><![CDATA[ The bulk of the data were collected during the 1980s and 1990s, but some data are from the 1970s or earlier. ]]></TemporalCoverage>
<DataQuality><![CDATA[ The data have been extensively checked during the course of the creation of the various reports produced by the MNCR programme. This included the MNCR Area Summary report series which describes the marine habitats in particular regions around the UK and the creation of the national marine habitat (biotope) classification system. Through this work the vast majority of the anomalies and errors in the data should have been identified but owing to the size of the dataset some may still remain.]]></DataQuality>
<AdditionalInformation><![CDATA[ ]]></AdditionalInformation>
</Abstract>
<AccessConstraints><![CDATA[ There are no access constraints to this dataset. All data are fully publicly available.]]></AccessConstraints>
<UseConstraints><![CDATA[ There are no constraints on how these data may be used other than those covered by the standard Gateway Terms and Conditions. ]]></UseConstraints></ProviderMetadata></DatasetSummary></DatasetSummaryList></SpeciesListResponse>

Back to the top

Source code for this page

/*
 *    NBN Gateway SOAP Client Sample: 
 *    Author: James Perrins, 
 *    exeGesIS SDM
 *    3rd March 2006
 */
//pass in details of any proxy server
$proxyhost = isset($_POST['proxyhost']) ? $_POST['proxyhost'] : '';
$proxyport = isset($_POST['proxyport']) ? $_POST['proxyport'] : '';
$proxyusername = isset($_POST['proxyusername']) ? $_POST['proxyusername'] : '';
$proxypassword = isset($_POST['proxypassword']) ? $_POST['proxypassword'] : '';

$client = new soapclient("http://212.219.37.104/NBNWebServices/ws/WSDL", 'true', $proxyhost, $proxyport, $proxyusername, $proxypassword);
//Increase default timeout.
$client->timeout=500;
$client->response_timeout=500;
$err = $client->getError();
if ($err) {
	echo '<h2>Constructor error</h2><pre>' . $err . '</pre>';
}
	$query1 = '<SpeciesListRequest xmlns="http://webservices.searchnbn.net/query">
			<GeographicalFilter>
				<Buffer xmlns="http://webservices.searchnbn.net/data">
				<Point srs="osgb_BNG" x="247500" y="50500" />
				<Distance>1000</Distance></Buffer>
			</GeographicalFilter>
			<TaxonReportingCategoryKey>NHMSYS0000080051</TaxonReportingCategoryKey>
		</SpeciesListRequest>';
	$result = $client->call("GetSpeciesList", $query1);
	$debug = $client->getDebug();
	$obj = simplexml_load_string(fixupxml($client->response));
	print ("<hr><table><thead><tr><th>Taxon Group</th><th>Scientific name</th><th>Common Name</th></tr></thead>");
	foreach ($obj->SpeciesList->Species as $Species) {
	   echo '<tr><td>', ucfirst($Species->TaxonReportingCategory), '</td><td><i>', $Species->ScientificName, ' (', $Species->Authority, ')</i></td><td>', $Species->CommonName, '</td></tr>';
	}
	print ("</table><hr>");

echo "<h2>Data Providers</h2>";
	echo "<table><thead><tr><th>Title</th><th>Provider</th><th>Description</th></tr></thead>";
	foreach ($obj->DatasetSummaryList->DatasetSummary as $DataSet) {
	   echo '<tr><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>");
	//Debugging code
	if(isset($_GET["debug"])){
		print '<h2>Fixed up XML</h2>';
		echo '<xmp>'.fixupxml($client->response).'</xmp>';
		
		print '<h2>Request</h2>';
		echo '<xmp>'.$client->request.'</xmp>';
		print ("<hr>");
		print '<h2>Response</h2>';
		echo '<xmp>'.$client->response.'</xmp>';
		echo '<hr><h2>Debug</h2><pre>' . $debug . '</pre><hr>';
	}

echo "<h2>The Returned XML File</h2><pre>";
	print htmlspecialchars(fixupxml($client->response));
	echo "</pre>";

NBN Web Services

Example PHP Implementations

Get Species List

Data Providers

Request to Server

The Returned XML File

Source code for this page