Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 4.0

...

Deployed URLs

Expected Response

http://wwwebird.avianknowledge.netorg/ws1.0/ref/covar/list

The entire list of active COVAR layers in CSV format

http://wwwebird.avianknowledge.netorg/ws1.0/ref/covar/list?format=xml

The entire list of active COVAR layers in XML format

http://wwwebird.avianknowledge.netorg/ws1.0/ref/covar/metadata?match=caus_prec0101&format=csv

The metadata for the CAUS_PREC0101 layer in CSV format

http://wwwebird.avianknowledge.netorg/ws1.0/ref/covar/metadata?match=caus_prec0101&format=xml

The metadata for the CAUS_PREC0101 layer in XML format

...

Example Value

Description

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE response PUBLIC "-//Avian Knowledge Network//DTD COVAR_SPAT 1.0//EN" "http://akn.ornith.cornell.edu/dtd/covar_spat_1_0.dtd">
<response>
<header>
<locale country="US" language="en"/>
<timestamp>2009-05-06T07:48:23.346-04:00</timestamp>
<criteria/>
<copyright>Copyright 2009 Cornell Lab of Ornithology - http://www.birds.cornell.edu</copyright>
<data-policy>AKN Data Sharing Policy - http://www.avianknowledge.net/content/about/akn-data-sharing-policy</data-policy>
<comment>COVAR_SPAT metadata response</comment>
</header>
<result>
<covar-spat>
<covar-spat-metadata>
<data-record>
<attribute-data>
<field-name>PLAND</field-name>
<descriptive-name>Percentage of landscape (Fragstats)</descriptive-name>
<description>PLAND = the sum of the areas of all patches of the corresponding patch type, divided by total landscape area, multiplied by 100</description>
<data-type>NUMBER</data-type>
<units>Number</units>
<min-value>Not Described</min-value>
<max-value>Not Described</max-value>
<min-value-description>Not Described</min-value-description>
<max-value-description>Not Described</max-value-description>
<nodata-value>-9999</nodata-value>
</attribute-data>
</data-record>
</covar-spat-metadata>
</covar-spat>
</result>
</response>

Header information includes the AKN COVAR_SPAT DTD
The timestamp of the response
A copyright element
The AKN data sharing policy element
A comment element

The data listing is a series of single <data-record> elementselement. Each <data-record> contains 1 contains 1 <attribute-data> element containing the <field-name>, <descriptive-name>, <description>, <data-type>, <units>, <min-value>, <max-value>, <min-value-description>, <max-value-description>, and the <nodata-value> elements.   

This particular example is for a Fragstats attribute. There are no set maximum or minimum values for this statistic so the values are set to "Not Described." The "Not Described" value should be treated as NULL.

Some COVAR_SPAT values represent a value range. Many of the climate layers like such as precipitation and mean temperature will have both <min-value>, <max-value>, and <min-value-description> and <max-value-description> data elements. In these cases where the data for a particular point is a data range the <min-value>, and <max-value> are discrete numeric values and the <min-value-description> and <max-value-description> describe the actual value range for the attribute.


Reference DTD for XML schema details http://akn.ornith.cornell.edu/dtd/covar_spat_1_0.dtd

...