{"id":13638007,"url":"https://github.com/sckott/gbifrb","last_synced_at":"2025-09-15T14:06:19.726Z","repository":{"id":24864300,"uuid":"102630424","full_name":"sckott/gbifrb","owner":"sckott","description":"GBIF Ruby client; docs: http://www.rubydoc.info/gems/gbifrb/0.1.0","archived":false,"fork":false,"pushed_at":"2023-03-22T13:58:28.000Z","size":499,"stargazers_count":4,"open_issues_count":3,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-09-10T18:19:01.405Z","etag":null,"topics":["biodiversity","data","ecology","gbif","gbif-api"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sckott.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2017-09-06T16:09:22.000Z","updated_at":"2023-03-02T10:30:29.000Z","dependencies_parsed_at":"2022-08-07T11:01:24.922Z","dependency_job_id":null,"html_url":"https://github.com/sckott/gbifrb","commit_stats":{"total_commits":97,"total_committers":5,"mean_commits":19.4,"dds":0.5979381443298969,"last_synced_commit":"4d21b9b2fd24c3497f87105756605c04cdeef56d"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/sckott/gbifrb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sckott%2Fgbifrb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sckott%2Fgbifrb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sckott%2Fgbifrb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sckott%2Fgbifrb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sckott","download_url":"https://codeload.github.com/sckott/gbifrb/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sckott%2Fgbifrb/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275267381,"owners_count":25434616,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-15T02:00:09.272Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["biodiversity","data","ecology","gbif","gbif-api"],"created_at":"2024-08-02T01:00:38.422Z","updated_at":"2025-09-15T14:06:19.707Z","avatar_url":"https://github.com/sckott.png","language":"Ruby","funding_links":[],"categories":["Species Distribution"],"sub_categories":[],"readme":"gbifrb\n======\n\n[![gem version](https://img.shields.io/gem/v/gbifrb.svg)](https://rubygems.org/gems/gbifrb)\n[![Ruby](https://github.com/sckott/gbifrb/actions/workflows/ruby.yml/badge.svg)](https://github.com/sckott/gbifrb/actions/workflows/ruby.yml)\n[![codecov.io](http://codecov.io/github/sckott/gbifrb/coverage.svg?branch=main)](http://codecov.io/github/sckott/gbifrb?branch=main)\n\n`gbifrb` is a low level client for the GBIF API\n\nOther GBIF API clients:\n\n- Python: [pygbif](https://github.com/sckott/pygbif)\n- R: [rgbif](https://github.com/ropensci/rgbif)\n- PHP: [php-gbif](https://gitlab.res-telae.cat/restelae/php-gbif)\n\n## Changes\n\nFor changes see the [Changelog][changelog]\n\n## API\n\nMethods in relation to [GBIF API][gbifapi] routes\n\nregistry\n\n* `/node` - `Gbif::Registry.nodes`\n* `/network` - `Gbif::Registry.networks`\n* `/installations` - `Gbif::Registry.installations`\n* `/organizations` - `Gbif::Registry.organizations`\n* `/dataset_metrics` - `Gbif::Registry.dataset_metrics`\n* `/datasets` - `Gbif::Registry.datasets`\n* `/dataset_suggest` - `Gbif::Registry.dataset_suggest`\n* `/dataset_search` - `Gbif::Registry.dataset_search`\n\nspecies\n\n* `/species/match` - `Gbif::Species.name_backbone`\n* `/species/suggest` - `Gbif::Species.name_suggest`\n* `/species/search` - `Gbif::Species.name_lookup`\n* `/species` - `Gbif::Species.name_usage`\n\noccurrences\n\n* `/search` - `Gbif::Occurrences.search`\n* `/get` - `Gbif::Occurrences.get`\n* `/get_verbatim` - `Gbif::Occurrences.get_verbatim`\n* `/get_fragment` - `Gbif::Occurrences.get_fragment`\n\n\n## Install\n\n### Release version\n\n```\ngem install gbifrb\n```\n\n### Development version\n\n```\ngit clone git@github.com:sckott/gbifrb.git\ncd gbifrb\nrake install\n```\n\n## Examples, in Ruby repl\n\n### Registry module\n\nNodes\n\n```ruby\nrequire 'gbifrb'\nregistry = Gbif::Registry\nregistry.nodes(limit: 5)\n```\n\nNetworks\n\n```ruby\nregistry.networks(uuid: '16ab5405-6c94-4189-ac71-16ca3b753df7')\n```\n\n### Species module\n\nGBIF backbone\n\n```ruby\nspecies = Gbif::Species\nspecies.name_backbone(name: \"Helianthus\")\n```\n\nSuggester\n\n```ruby\nspecies.name_suggest(q: \"Helianthus\")\n```\n\nLookup\n\n```ruby\nspecies.name_lookup(q: \"Helianthus\")\n```\n\nLookup example with more parameters: name usages of plants where accepted scientific name includes 'reptans':\n\n```ruby\nspecies.name_lookup(q: 'reptans', higherTaxonKey: 6, nameType: 'SCIENTIFIC', status: 'ACCEPTED')\n```\n\nName usage (`/species`)\n\n```ruby\nspecies.name_usage(name: \"Helianthus\")\n```\n\nName usage example with more parameters: name usages of 'Andropogon' in Database of Vascular Plants of Canada (VASCAN) checklist:\n\n```ruby\nspecies.name_usage(name: 'Andropogon', datasetKey: '3f8a1297-3259-4700-91fc-acc4170b27ce')\n```\n\n### Occurrences\n\n```ruby\nocc = Gbif::Occurrences\nocc.search(taxonKey: 3329049)\nocc.search(taxonKey: 3329049, limit: 2)\nocc.search(scientificName: 'Ursus americanus')\n```\n\n### curl options\n\n```ruby\nspecies = Gbif::Species\nspecies.name_backbone(\"Helianthus\", verbose: true)\n```\n\n### Todo\n\n* CLI interface\n* occurrence metrics methods\n* occurrence downloads methods\n* OAI-PMH interface\n\n## Meta\n\n* Please note that this project is released with a [Contributor Code of Conduct](CONDUCT.md). By participating in this project you agree to abide by its terms.\n* License: MIT\n\n[gbifapi]: https://www.gbif.org/developer/summary\n[changelog]: https://github.com/sckott/gbifrb/blob/main/CHANGELOG.md\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsckott%2Fgbifrb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsckott%2Fgbifrb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsckott%2Fgbifrb/lists"}