Note upstream API fields

main
Jeff Moe 2023-09-27 12:39:14 -06:00
parent 671c1ec295
commit 6dab374ff1
1 changed files with 43 additions and 0 deletions

View File

@ -44,6 +44,49 @@ API_URL = args.api
QUERY = args.query
'''
Upstream API https://xeno-canto.org/explore/api
also: an array with the identified background species in the recording
animal-seen: was the recorded animal seen?
auto: automatic (non-supervised) recording?
bird-seen: despite the field name (which was kept to ensure backwards compatibility), this field indicates whether the recorded animal was seen
cnt: the country where the recording was made
date: the date that the recording was made
dvc: recording device used
en: the English name of the species
file-name: the original file name of the audio file
file: the URL to the audio file
gen: the generic name of the species
group: the group to which the species belongs (birds, grasshoppers, bats)
id: the catalogue number of the recording on xeno-canto
lat: the latitude of the recording in decimal coordinates
length: the length of the recording in minutes
lic: the URL describing the license of this recording
lng: the longitude of the recording in decimal coordinates
loc: the name of the locality
method: the recording method (field recording, in the hand, etc.)
mic: microphone used
osci: an object with the urls to the three versions of oscillograms
playback-used: was playback used to lure the animal?
q: the current quality rating for the recording
rec: the name of the recordist
regnr: registration number of specimen (when collected)
rmk: additional remarks by the recordist
sex: the sex of the animal
smp: sample rate
sono: an object with the urls to the four versions of sonograms
sp: the specific name (epithet) of the species
ssp: the subspecies name (subspecific epithet)
stage: the life stage of the animal (adult, juvenile, etc.)
temperature: temperature during recording (applicable to specific groups only)
time: the time of day that the recording was made
type: the sound type of the recording (combining both predefined terms such as 'call' or 'song' and additional free text options)
uploaded: the date that the recording was uploaded to xeno-canto
url: the URL specifying the details of this recording
'''
def print_json(jsn):
print(json.dumps(json.loads(jsn), sort_keys=True, indent=4))