Skip to content

Commit

Permalink
Merge pull request #128 from sebpardo/update-readme
Browse files Browse the repository at this point in the history
Update README vignette and DESCRIPTION
  • Loading branch information
sebpardo committed Mar 24, 2024
2 parents b4fd821 + f89f11b commit c8b253f
Show file tree
Hide file tree
Showing 7 changed files with 805 additions and 712 deletions.
2 changes: 1 addition & 1 deletion DESCRIPTION
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Authors@R: c(
person("Guy", "Babineau", role = "ctb", email = "guy.babineau@gmail.com"),
person("Marianna", "Foos", role = "ctb", email = "marianna.foos@gmail.com"),
person("David", "Bradnum", role = "ctb", email = "david.bradnum@gmail.com"),
person("Dave", "Slager", role = "ctb"),
person("Dave", "Slager", role = "ctb", comment = c(ORCID = "0000-0003-2525-2039")),
person("Sebastian", "Pardo", role = c("aut", "cre"), email = "sebpardo@gmail.com", comment = c(ORCID = "0000-0002-4147-5796"))
)
URL: https://docs.ropensci.org/rebird/, https://github.com/ropensci/rebird
Expand Down
14 changes: 10 additions & 4 deletions README.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -53,9 +53,7 @@ library("rebird")
```

The [eBird API server](https://documenter.getpostman.com/view/664302/S1ENwy59?version=latest)
has been updated and thus there are a couple major changes in the way `rebird` works.
API requests to eBird now require users to provide an API key, which is linked to your
eBird user account.
requires users to provide an API key, which is linked to your eBird user account.
You can pass it to the 'key' argument in `rebird` functions, but we highly recommend
storing it as an environment variable called EBIRD_KEY in your .Renviron file.
If you don't have a key, you can obtain one from <https://ebird.org/api/keygen>.
Expand Down Expand Up @@ -205,6 +203,14 @@ Obtain a list of checklists submitted on a given date at a region or hotspot
ebirdchecklistfeed(loc = "L207391", date = "2020-03-24", max = 5)
```

## View Checklist

Obtain all information on a specific checklist

```{r ebirdchecklist}
ebirdchecklist("S139153079")
```

## Hotspots in a region or nearby coordinates

Obtain a list of hotspots within a region
Expand Down Expand Up @@ -251,7 +257,7 @@ The 2.0 APIs have considerably been expanded from the previous version, and `reb
- [x] Checklist feed on a date: `ebirdchecklistfeed()`
- [ ] Regional statistics on a date
- [x] Species list for a region: `ebirdregionspecies()`
- [ ] View Checklist BETA
- [x] View Checklist: `ebirdchecklist()`

### ref/geo
- [ ] Adjacent Regions
Expand Down
543 changes: 284 additions & 259 deletions README.md

Large diffs are not rendered by default.

12 changes: 9 additions & 3 deletions inst/vign/rebird_vignette.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -35,9 +35,7 @@ library("rebird")
## Usage

The [eBird API server](https://documenter.getpostman.com/view/664302/S1ENwy59?version=latest)
has been updated and thus there are a couple major changes in the way `rebird` works.
API requests to eBird now require users to provide an API key, which is linked to your
eBird user account.
requires users to provide an API key, which is linked to your eBird user account.
You can pass it to the 'key' argument in `rebird` functions, but we highly recommend
storing it as an environment variable called EBIRD_KEY in your .Renviron file.
If you don't have a key, you can obtain one from <https://ebird.org/api/keygen>.
Expand Down Expand Up @@ -187,6 +185,14 @@ Obtain a list of checklists submitted on a given date at a region or hotspot
ebirdchecklistfeed(loc = "L207391", date = "2020-03-24", max = 5)
```

## View Checklist

Obtain all information on a specific checklist

```{r ebirdchecklist}
ebirdchecklist("S139153079")
```

## Hotspots in a region or nearby coordinates

Obtain a list of hotspots within a region
Expand Down
472 changes: 250 additions & 222 deletions inst/vign/rebird_vignette.md

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion man/rebird-package.Rd

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

0 comments on commit c8b253f

Please sign in to comment.