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 Bathymetric Compilation Group 2026(2026). The GEBCO_2026 Grid - a continuous terrain model for oceans and land at 15 arc-second intervals. NERC EDS British Oceanographic Data Centre NOC. doi:10.5285/4f68d5c7-45eb-f999-e063-7086abc036fa

  https://www.gebco.net/data-products-gridded-bathymetry-data/gebco2026-grid

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.1.0.