Sea Around Us API Wrapper

R wrapper for the Sea Around Us API.

The Sea Around Us data are licensed to the public under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International Public License.

Please read the data use policy described in the DATA_USE file.

This software is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version. See the LICENSE file for a full statement of the License.

A note on usage

When querying the API, please be respectful of the resources required to provide this data. We recommend you retain the results for each request so you can avoid repeated requests for duplicate information.

IMPORTANT MESSAGE: Please do not attempt to download the entire Sea Around Us database. This has the effect of overloading our systems and will cause outage of our website. We will be pleased to provide access to the entirety of our data to any colleague interested in a collaboration. Thank you for your cooperation.

Installation

CRAN version

install.packages("seaaroundus")

Dev version

install.packages("devtools")
devtools::install_github("ropensci/seaaroundus")
library(seaaroundus)

Example usage

list available eezs

get species data for Brazil as a data frame

use alternative API environment (available on all functions)

NOTE: alternative API environments may not always be publically accessible or stable

get top 3 species data for Brazil as a data frame

get reporting status data by value for Brazil as a data frame

get species data for Brazil as a chart

catchdata("eez", 76, chart=TRUE)

eez vs high seas percent catch data frame

NOTE: data not available until SeaAroundUs global paper is released

eez vs high seas percent catch graph

eezsvshighseas(chart=TRUE)

marine trophic index for Brazil as a data frame

marine trophic index for Brazil as graph

marinetrophicindex("eez", 76, chart=TRUE)

get cells for a shape in WKT format

get datagrid of cell data for a given year and list of cells

Available parameters

Regions:

  • eez
  • lme
  • rfmo
  • eez-bordering
  • taxon

Measures:

  • tonnage
  • value

Dimensions:

  • taxon (not available for taxon region)
  • commercialgroup
  • functionalgroup
  • country (fishing country)
  • sector
  • catchtype
  • reporting-status
  • eez (only available for eez-bordering and taxon regions)
  • highseas (only available for taxon region)

Meta

ropensci