1. iDigBio API Hackathon ‘15 Introductory Webinar
Matthew Collins
Alex Thompson
Greg Traub
Dan Stoner
Advanced Computing and Information Systems Laboratory (ACIS)
University of Florida
Welcome everyone….

2. Today’s agenda
Welcome and overview of the event
API inventory
Walkthrough of Search and Mapping APIs
Simple examples of Search and Mapping
Libraries available
Dissemination of hackathon ideas
Questions

3. iDigBio: http://www.idigbio.org

4. Hackathon Event Agenda
June 3, Wednesday 8:30am - 9:45am Welcome and introductions 10:15am - 11:15am Pitch your idea, set your goal, choose a partner 11:15am - 12:00am Report on team goals 1:00pm - 5:00pm Code! June 4, 2015 – Thursday 8:30am - 9:15am Brief reports on progress (10 min per team) 9:15am - 5:00pm Code! June 5, 2015 – Friday 8:30am - 12:00am Code! 1:00pm - 3:00pm Final product report (30 min per team)

5. Web Portal Interface: Search across all data, all/individual fields, customize, use autocompletion, synonyms,…
Portal provides an easy search interface for all indexed data in iDigBio
A user can search across all fields (full-text search)
A user can search individual fields (advanced search fields)
Advanced search fields provide progressive autocompletion (meaning any used fields are taken into account when providing suggestions)
Lower taxonomy search fields (Family, Genus, Specific Epithet) provide an “Add EOL Synonyms” button for adding synonyms to a users entries utilizing the Encyclopedia Of Life API.

6. API Inventory
There are several “APIs” for several purposes:
Search API (provides access to records, what we’ll talk about today)
Mapping (a subset of the search API)
Download API (provides DwCA files asynchronously)
Media ingestion API (used by the appliance, requires authentication)
Ingestion API (used internally)

7. Search API Development Status
Beta status today (publically available but functionality might change)
Production status June 1, 2015

8. Search API Documentation
(Alex Thompson)

9. Search API Examples
(Greg Traub)

10. Search API Examples – jQuery records
Basic search using a JSON object for finding Genus ‘Acer’ with Images:
{"rq":{"genus": “acer”, "hasImage": true}} $.ajax(‘       dataType: 'json',       contentType: 'application/json',       type: ‘POST’,       data: JSON.stringify({"rq":{"genus": “acer”, "hasImage": true}}) });

11. Search API Examples – jQuery maps
Building a map:
$.ajax(‘       dataType: 'json',       contentType: 'application/json',       type: ‘POST’,       ​data: JSON.stringify({"rq":{"genus": “acer”, "hasImage": true}}) });

13. Libraries and Hackathon Ideas
(Dan Stoner)

14. iDigBio Client Libraries
R Project
ridigbio R Package for Search API
Python
Library for Search API

15. ridigbio (R Package)
Not yet in The Comprehensive R Archive Network (CRAN), but hopefully soon. In the meantime…

16. idigbio (Python Library)
Available in the Python Package Index (PyPI).

17. Hackathon GitHub resources
Main:
Wiki:

18. Hackathon GitHub resources (cont’d)
Use Issues to submit and comment on ideas...

19. Hackathon Resources Summary
Github organization for hackathon:
HackathonCentral project has all information
Your projects will go here
iDigBio API repository w/ documentation:
API overviews:
API users mailing list:

20. Questions?
Deer mouse / Missouri Department of Conservation