GBIF API feature: faceted search

[sckott]

quoted:

• The GBIF portal now supports faceted navigation by: basis of record, type status, data set, country, year and month. Please, see this example: http://www.gbif.org/occurrence/search?basis_of_record=FOSSIL_SPECIMEN .
• The GBIF API supports faceted results by: basisOfRecord, catalogNumber, classKey, collectionCode, country, datasetKey, decimalLatitude, decimalLongitude, depth, elevation, establishmentMeans, familyKey, genusKey, hasCoordinate, hasGeospatialIssue, institutionCode, issue, kingdomKey, mediaType, month, occurrenceID, orderKey, phylumKey, publishingCountry, recordedBy, recordNumber, repatriated, scientificName, speciesKey, subgenusKey, taxonKey, typeStatus and year.
• The occurrence API supports pagination request in facets using the parameters facetLimit and facetOffset, see this example:
  • First three country counts/facets: http://api.gbif.org/v1/occurrence/search?facet=COUNTRY&COUNTRY.facetLimit=3&COUNTRY.facetOffset=0&limit=0
  • Next three country counts/facets: http://api.gbif.org/v1/occurrence/search?facet=COUNTRY&COUNTRY.facetLimit=3&COUNTRY.facetOffset=3&limit=0