README.md

FastAPI of GEBCO bathymetry

Swagger API doc

GEBCO API manual/online try-out

Usage

1. Records-output (in JSON) of z-profile (and distances) between longitude/latitude points with 15-arcsec resolutions

   e.g: https://api.odb.ntu.edu.tw/gebco?lon=120,120.1,120.1&lat=25.0,25.1,24.9&mode=row

2. Output only endpoints: &mode=row,point

3. Polygon mode by jsonsrc parameter (default down-sampling every 5 points, see sample parameter in manual) e.g

   https://api.odb.ntu.edu.tw/gebco?mode=zonly&jsonsrc={"type": "Polygon", "coordinates": [[[121, 22.5], [121, 23.5], [122, 23.5], [122, 22.5], [121, 22.5]]]}

• Parmeter mode=zonly means pairwise distance evaluation/output is disabled, only evaluates z data. Multiple values separated by comma in mode is allowed.
• Multiple features are allowed:

   https://api.odb.ntu.edu.tw/gebco?mode=zonly&jsonsrc={"type": "FeatureCollection", "features": [{"type": "Feature", "properties": {}, "geometry": { "type": "Polygon", "coordinates": [[[121, 22.5], [121, 23.5], [122, 23.5], [122, 22.5], [121, 22.5]]]}}]}

Demo polygon-mode data by plotly on Ocean APIverse

Given the polygon in GeoJSON, the 15 arc-seconds gridded GEBCO data can be obtained to present the 3D terrain of this area.

Attribution

• Data source

  GEBCO Compilation Group (2023) GEBCO 2023 Grid (doi:10.5285/f98b053b-0cbc-6c23-e053-6c86abc0af7b)

  https://www.gebco.net/data_and_products/gridded_bathymetry_data/

Citation

• This API is compiled by Ocean Data Bank (ODB), and can be cited as:

  Ocean Data Bank, National Science and Technology Council, Taiwan. https://doi.org/10.5281/zenodo.7512112. Accessed DAY/MONTH/YEAR from api.odb.ntu.edu.tw/gebco. v1.0.