31:Tf69,arrayParams = [ // cumulative totals over a period of time (based on observation date) {string:'d2=2020-01-31', description:'thru Jan 2020'}, {string:'d2=2020-02-29', description:'thru Feb 2020'}, {string:'d2=2020-03-31', description:'thru Mar 2020'}, {string:'d2=2020-04-30', description:'thru Apr 2020'}, {string:'d2=2020-05-31', description:'thru May 2020'}, {string:'d2=2020-06-30', description:'thru Jun 2020'}, {string:'d2=2020-07-31', description:'thru Jul 2020'}, {string:'d2=2020-08-31', description:'thru Aug 2020'}, {string:'d2=2020-09-30', description:'thru Sep 2020'}, {string:'d2=2020-10-31', description:'thru Oct 2020'}, {string:'d2=2020-11-30', description:'thru Nov 2020'}, {string:'d2=2020-12-31', description:'thru Dec 2020'}, /* // months of the year {string:'month=1', description:'January'}, {string:'month=2', description:'February'}, {string:'month=3', description:'March'}, {string:'month=4', description:'April'}, {string:'month=5', description:'May'}, {string:'month=6', description:'June'}, {string:'month=7', description:'July'}, {string:'month=8', description:'August'}, {string:'month=9', description:'September'}, {string:'month=10', description:'October'}, {string:'month=11', description:'November'}, {string:'month=12', description:'December'}, */ /* // USA states, plus DC {string:'place_id=19', description:'Alabama'}, {string:'place_id=6', description:'Alaska'}, {string:'place_id=40', description:'Arizona'}, {string:'place_id=36', description:'Arkansas'}, {string:'place_id=14', description:'California'}, {string:'place_id=34', description:'Colorado'}, {string:'place_id=49', description:'Connecticut'}, {string:'place_id=4', description:'Delaware'}, {string:'place_id=5', description:'District of Columbia'}, {string:'place_id=21', description:'Florida'}, {string:'place_id=23', description:'Georgia'}, {string:'place_id=11', description:'Hawaii'}, {string:'place_id=22', description:'Idaho'}, {string:'place_id=35', description:'Illinois'}, {string:'place_id=20', description:'Indiana'}, {string:'place_id=24', description:'Iowa'}, {string:'place_id=25', description:'Kansas'}, {string:'place_id=26', description:'Kentucky'}, {string:'place_id=27', description:'Louisiana'}, {string:'place_id=17', description:'Maine'}, {string:'place_id=39', description:'Maryland'}, {string:'place_id=2', description:'Massachusetts'}, {string:'place_id=29', description:'Michigan'}, {string:'place_id=38', description:'Minnesota'}, {string:'place_id=37', description:'Mississippi'}, {string:'place_id=28', description:'Missouri'}, {string:'place_id=16', description:'Montana'}, {string:'place_id=3', description:'Nebraska'}, {string:'place_id=50', description:'Nevada'}, {string:'place_id=41', description:'New Hampshire'}, {string:'place_id=51', description:'New Jersey'}, {string:'place_id=9', description:'New Mexico'}, {string:'place_id=48', description:'New York'}, {string:'place_id=30', description:'North Carolina'}, {string:'place_id=13', description:'North Dakota'}, {string:'place_id=31', description:'Ohio'}, {string:'place_id=12', description:'Oklahoma'}, {string:'place_id=10', description:'Oregon'}, {string:'place_id=42', description:'Pennsylvania'}, {string:'place_id=8', description:'Rhode Island'}, {string:'place_id=43', description:'South Carolina'}, {string:'place_id=44', description:'South Dakota'}, {string:'place_id=45', description:'Tennessee'}, {string:'place_id=18', description:'Texas'}, {string:'place_id=52', description:'Utah'}, {string:'place_id=47', description:'Vermont'}, {string:'place_id=7', description:'Virginia'}, {string:'place_id=46', description:'Washington'}, {string:'place_id=33', description:'West Virginia'}, {string:'place_id=32', description:'Wisconsin'}, {string:'place_id=15', description:'Wyoming'}, */ ];32:T6b7,apiResponse = { //if JWT is provided, add it to request options to make an authenticated request let reqOptions = {}; if (input.jwt) { let hdr = new Headers(); hdr.append('Content-Type','application/json'); hdr.append('Authorization',('Bearer '+input.jwt)); reqOptions = {method:endpoint.method,headers:hdr}; }; // get a single page of results only, or else get multiple pages (up to max total record limit) if (!arrayParams||arrayParams.length<=0||!arrayParams[0].string) { return 'Need to define a series.' } else { let combinedResults = []; let paramString = new URLSearchParams(input.params); paramString.delete('page'); paramString.set('per_page','0'); endpoint['reqURL'] = endpoint.baseURL+(paramString?'?'+paramString:''); let cumDelay = 0; let aryPromises = []; for (let item of arrayParams) { if (item.string) { let prom = new Promises.delay(cumDelay,{ url:endpoint.baseURL+(paramString?'?'+paramString:'')+"&"+item.string, options:reqOptions, item:item.description, }) .then(async req=>{ let count = await fetch(req.url,req.options) .then(response=>{return response.json()}) .then(data=>{return data.total_results}); return {item:req.item, count:count} }); aryPromises.push(prom); cumDelay+=apiRequestDelay; }; } return Promise.all(aryPromises).then(results=>{ if (input.sort==="countDesc") { results.sort(function(a, b){return b.count-a.count}); } else if (input.sort==="countAsc") { results.sort(function(a, b){return a.count-b.count}); }; return results; }) } }33:[] 2f:{"title":"iNaturalist API Example #2","cells":[{"id":0,"value":"md`# iNaturalist API Example #2`","pinned":false,"hidden":false,"mode":"ojs"},{"id":240,"value":"html`

${endpoint.method} a set of counts via the ${endpoint.description} endpoint

This notebook is intended to provide some basic ideas for getting data from the iNaturalist API, in a plaform that (hopefully) is relatively easy to use and offers a lot of options for customizations. This isn't really intended to walk you through how to get data from scratch, but hopefully there's enough stuff here to inspire and help you to make something interesting and useful for yourself.

`","pinned":false,"hidden":false,"mode":"ojs"},{"id":649,"value":"md`---\n### Define Set \nSet up an array of parameters to define which observations to count. Each parameter string in the array will be combined additional common parameters input in the next section. Note that there will be a delay of ${apiRequestDelay/1000} sec between each request. Since there are ${arrayParams.length} items in your array, you will need to wait at least ${apiRequestDelay*arrayParams.length/1000-1} second(s) for the complete set of results to be returned.`","pinned":false,"hidden":false,"mode":"ojs"},{"id":659,"value":"$31","pinned":true,"hidden":false,"mode":"ojs"},{"id":521,"value":"md`---\n### Input Additional (Common) Parameters`","pinned":false,"hidden":false,"mode":"ojs"},{"id":519,"value":"html`

Input your parameter string in the field below, and then click the Get Results button. (Expand for more info.)

See API documentation for a list of available parameters.

Example Parameters:

\n \n \n ${exampleParams.map(p=>``)}\n

Parameter String	Description
`+p.string+`	`+p.description+`

In the \"more options\" section, you can also input a JWT, which will allow you to make authenticated requests to get, say, private coordinates. There's also a dropdown list that will allow you to select how the results will be ordered.

`","pinned":false,"hidden":false,"mode":"ojs"},{"id":112,"value":"viewof input = formWithSubmit(html``)","pinned":false,"hidden":false,"mode":"ojs"},{"id":294,"value":"md`---\n### Basic Results`","pinned":false,"hidden":false,"mode":"ojs"},{"id":506,"value":"md`|Summary Item|Value|\n|---|---|\n|Base API Request URL|${endpoint.reqURL}|\n|Total Records|${apiResponse.length}|`","pinned":false,"hidden":false,"mode":"ojs"},{"id":62,"value":"$32","pinned":false,"hidden":false,"mode":"ojs"},{"id":501,"value":"md`--- \n### Formatted Results`","pinned":false,"hidden":false,"mode":"ojs"},{"id":732,"value":"viewof simpleBar = vl.markBar() // Make a bar chart\n .width(\"container\")\n .data(apiResponse)\n .encode(\n vl.x().fieldN(\"item\").sort(null), // nominal field, unsorted\n vl.y().fieldQ(\"count\") // quantitative field\n )\n .render()","pinned":false,"hidden":false,"mode":"ojs"},{"id":560,"value":"viewof resultsTable = table(apiResponse,\n { // table options\n title: 'iNaturalist Observation Counts',\n pageSize: 15,\n }\n)","pinned":false,"hidden":false,"mode":"ojs"},{"id":396,"value":"md`---\n### More Information\n* [Recommended practices](https://www.inaturalist.org/pages/api+recommended+practices)\n* Node.js API v1 [documentation](https://api.inaturalist.org/v1/docs/) (current)\n* Node.js API v2 [documentation](https://api.inaturalist.org/v2/docs/) (in development as of Jan 2021)\n* Ruby API [documentation](https://www.inaturalist.org/pages/api+reference) (deprecated)\n* API Github [Repo](https://github.com/inaturalist/iNaturalistAPI)\n* [Forum](https://forum.inaturalist.org/)\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":165,"value":"md`-----\n### Configurations & Dependencies`","pinned":false,"hidden":false,"mode":"ojs"},{"id":11,"value":"endpoint = ({\n description:'v1 Observations Search',\n method:'GET',\n baseURL:'https://api.inaturalist.org/v1/observations',\n docURL:'https://api.inaturalist.org/v1/docs/#!/Observations/get_observations',\n})","pinned":true,"hidden":false,"mode":"ojs"},{"id":256,"value":"// Target a 1 sec (1000 ms) delay between requests, to remain below iNaturalist's API request limits.\n// For more info, see API Recommended Practices\napiRequestDelay = 1000","pinned":true,"hidden":false,"mode":"ojs"},{"id":282,"value":"// These are example parameter strings.\n// You could also save your own set of strings here for easy future reference.\nexampleParams = [\n {string:'quality_grade=needs_id&taxon_id=47126',description:'plant observations needing ID'},\n {string:'year=2020&verifiable=true',description:'verifiable observations in 2020'},\n]","pinned":true,"hidden":false,"mode":"ojs"},{"id":102,"value":"// Normally, actions would be triggered with each keystroke in a standard input box.\n// This provides a way for the entire set of parameters to be typed in before taking any action.\n// An alternative to using an input box like this would be to just set the string as a cell value.\nimport {formWithSubmit} from \"@forresto/form-input-with-submit\"","pinned":true,"hidden":false,"mode":"ojs"},{"id":555,"value":"// used for displaying data in a table\nimport {table} from \"@tmcw/tables/2\"","pinned":true,"hidden":false,"mode":"ojs"},{"id":733,"value":"// used for charts and graphs\nimport { vl } from \"@vega/vega-lite-api\"","pinned":true,"hidden":false,"mode":"ojs"}],"files":"$W33","stdlib":"1","titling":"auto"}