Frequency Histograms
Parameters
parameter group |
description |
parameter name |
values |
example |
default |
|---|---|---|---|---|---|
location |
exactly one location parameter is required |
subnational1 |
eBird standard subnational1 codes |
US-FL |
n/a |
|
|
country |
2-letter ISO codes |
CA |
n/a |
|
|
bcr |
integers 1-64? |
14 |
n/a |
|
|
subnational2 |
eBird standard subnational2 codes |
|
n/a |
|
|
|
|
|
|
period |
|
|
|
|
|
|
|
beginYear |
defines beginning of period of interest, in YYYY format |
2000 |
???? |
|
|
endYear |
defines end of period of interest, in YYYY format |
2000 |
???? |
|
|
|
|
|
|
collection |
|
collection |
AKN collection codes, eBird project IDs; initially there will be no away to request the entirety of AKN data as a collection |
EBIRD_PR |
n/a |
|
|
|
|
|
|
species |
|
species |
either "all" or scientific name of single species of interest; we will handle lists of species at a later date |
Sialia sialis |
all |
|
|
|
|
|
|
output |
|
output |
"f" = returns frequency (float, 0.0-1.0) |
f |
f |
|
|
|
|
|
|
locale |
|
locale |
Java standard locale codes |
en_US |
en_US |
|
|
|
|
|
|
Supporting web services needed
- Species list
- Species search
- Collection codes list
- Subnational2Code list and/or search
CSV Format Output (or tab delimited)
- if S species are returned, the response has S+1 rows
- row 1 contains N for each of 48 "weeks"
- rows 2 through S+1 contain species name and frequency (0 <= frequency <= 1)
- the response contains 50 columns
- column 1 :: sci. name
- column 2 :: common name
- columns 3-50 :: frequency or category