iNaturalist identification goal progress
Intended for tracking statistics for ID-a-thons, this widget uses the iNaturalist
identifications/categories API to construct a progress bar of identifications for a certain period of time. For example, the following parameters restrict the stats to identifications of other people's observations of vascular plants in Oregon on 11/09/24 and compares it to the identifications from the previous day. This code can be copied and pasted into an iNaturalist journal post.
<iframe src="https://mickley.github.io/iNat-Tools/id-progress.html?own_observation=false&taxon_id=211194&place_id=10&d1=2024-11-09T00:00-08:00&d2=2024-11-09T23:59-08:00&goal=3000&mindisp=4000&name=ID-A-Thon 2024&d1comp=2024-11-08T00:00-08:00&d2comp=2024-11-08T23:59-08:00&namecomp=Previous Day" height="300" width="700" frameborder="0"></iframe>
Any variables from the
api reference can be added as link parameters to constrain the progress bar, and this help text will disappear when embedded in an iframe within a journal post. The following iNaturalist variables are especially relevant:
- own_observation=false: Include this if you do not want to include identifications of a users own observations in the statistics.
- d1 & d2: start and end dates. To account for timezones, use ISO 8601 format: 2024-11-09T00:00-08:00, where -08:00 is the offset from UTC. (YYYY-MM-DDTHH:mm:ss+/-HH:mm
Additionally, the following variables can be specified:
- goal: Set to a number to track progress towards a goal for number of identifications (e.g., 20000)
- name: A name to display for the progress bar (e.g., ID-A-Thon 2024)
- mindisp: Minimum x-axis number to include for the progress bar. If the number of identifications is less than this number, the graph will be resized to include it. This can help prevent text from being cutoff
- d1comp & d2comp: Optionally, these are start and end dates for a second comparison progress bar (e.g., previous ID-A-Thon or time period)
- namecomp: An optional name for the comparison progress bar (e.g. previous 9 days)