Skip to content

Latest commit

 

History

History
22 lines (14 loc) · 1.66 KB

futres_query.md

File metadata and controls

22 lines (14 loc) · 1.66 KB

Futres DATA SERVICE query instructions

To interact with this service, elasticsearch style GET and POST requests can be sent to this endpoint. Note that most requests and all responses to this service require packaging in JSON formatted text. The ElasticSearch website offers some help on Query Syntax.

Following are some examples of interacting with the endpoint using curl. Note that the requests below mainly offer methods of retrieving results of less than 10,000 records. See the section on es2csv to retrieve more than 10,000 records or to return results as CSV.

Query examples

Note that the attribute size can be adjusted up to 10,000 records.

Can be executed from the browser or curl:

# query on genus & sex & year example
curl 'https://biscicol.org/api/v1/query/futres/_search?from=0&size=25&_source=decimalLatitude,decimalLongitude,yearCollected,scientificName,sex,measurementType,country,measurementUnit,measurementValue&q=++yearCollected:%3E=1868+AND++yearCollected:%3C=2020++AND++scientificName:Puma+concolor+AND++sex:male&pretty'


# query on yearCollected example
https://biscicol.org/api/v1/query/futres/_search?from=0&size=5&_source=decimalLatitude,decimalLongitude,yearCollected,scientificName&q=++yearCollected:>=1868+AND++yearCollected:<=2019
curl 'https://biscicol.org/api/v1/query/futres/_search?from=0&size=5&_source=decimalLatitude,decimalLongitude,yearCollected,scientificName&q=++yearCollected:>=1868+AND++yearCollected:<=2019'