...
parameter | required | default | value options | example value | description | status |
---|---|---|---|---|---|---|
locIDs | yes | n/a | comma-separated list of up to three locIDs | L97555,L259855 | The data summary is computed using data submitted to the given locIDs (up to three). | deployed |
locale | no | en_US | Java standard locale codes | en_US | Language/locale of common names provided in the response (when translations are available) | implemented, not deployed (as of June 27, 2008) |
daysBack | no | 0 | 0, 1, 2, 3, 4, 5, 6, 7 | 7 | How many days backwards to look in computing the summary. Zero means use observations submitted for today. One means use observations for today and yesterday. Etc. | deployed |
Result Caching
Results are cached on the server for 30 minutes, so repeated calls to the same URL will usually result in exacted the same response. The time that the response was actually computed is provided in the header time stamp.
XML Result Format
No Format |
---|
<?xml version="1.0" encoding="UTF-8"?> <response> <header> <locale country="US" language="en"/> <timestamp>2008-06-27T15:57:58.877-04:00</timestamp> <criteria> <property id="locID" value="L97555" description="Sapsucker Woods"/> <property id="daysBack" value="7"/> </criteria> </header> <result> <sighting> <species-id>cangoo</species-id> <scientific-name>Branta canadensis</scientific-name> <common-name>Canada Goose</common-name> <how-many>20</how-many> <num-checklists>2</num-checklists> <obs-dt>2008-06-27</obs-dt> </sighting> <sighting> <species-id>norbob</species-id> <scientific-name>Colinus virginianus</scientific-name> <common-name>Northern Bobwhite</common-name> <how-many>1</how-many> <num-checklists>1</num-checklists> <obs-dt>2008-06-25</obs-dt> </sighting> </result> </response> |
...