R: Search Catalogue of Life for taxonomic IDs

col_search {taxize} | R Documentation

## Search Catalogue of Life for taxonomic IDs

### Description

Search Catalogue of Life for taxonomic IDs

### Usage

    col_search(name = NULL, id = NULL, start = NULL, checklist = NULL,
      response = "terse", ...)

### Arguments

`name` | The string to search for. Only exact matches found the name given will be returned, unless one or wildcards are included in the search string. An * (asterisk) character denotes a wildcard; a character may also be used. The name must be at least 3 characters long, not counting wildcard characters.
`id` | The record ID of the specific record to return (only for scientific names of species or infraspecific taxa)
`start` | The first record to return. If omitted, the results are returned from the first record (start=0). This is useful if the total number of results is larger than the maximum number of results returned by a single Web service query (currently the maximum number of results returned by a single query is 500 for terse queries and 50 for full queries).
`checklist` | The year of the checklist to query, if you want a specific year's checklist instead of the lastest as default (numeric).
`response` | (character) one of "terse" or "full"
`...` | Curl options passed on to `GET`

### Details

You must provide one of name or id. The other parameters (format and start) are optional.

### Value

A list of data.frame's.

### References

http://webservice.catalogueoflife.org/

### Examples

    ## Not run:
    # A basic example
    col_search(name="Apis")
    col_search(name="Agapostemon")
    col_search(name="Poa")

    # Get full response, i.e., more data
    col_search(name="Apis", response="full")
    col_search(name="Poa", response="full")

    # Many names
    col_search(name=c("Apis","Puma concolor"))
    col_search(name=c("Apis","Puma concolor"), response = "full")

    # An example where there is no data
    col_search(id = "36c623ad9e3da39c2e978fa3576ad415")
    col_search(id = "36c623ad9e3da39c2e978fa3576ad415", response = "full")
    col_search(id = "787ce23969f5188c2467126d9a545be1")
    col_search(id = "787ce23969f5188c2467126d9a545be1", response = "full")
    col_search(id = c("36c623ad9e3da39c2e978fa3576ad415", "787ce23969f5188c2467126d9a545be1"))
    ## a synonym
    col_search(id = "f726bdaa5924cabf8581f99889de51fc")
    col_search(id = "f726bdaa5924cabf8581f99889de51fc", response = "full")

    ## End(Not run)

[Package taxize version 0.9.0 Index]