cywhale / gebco

FastAPI of GEBCO bathymetry

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.

gebco's Issues

Getting gridded data

I have been needing a python friendly way to read in GEBCO bathymetry data, and this seems to be really close to what I need.

As I see it, this command ('https://api.odb.ntu.edu.tw/gebco?lon=4,6&lat=60.0,59.0&mode=row') gives me a NE-SW slice with 15-arcsec resolution. Is there a way to get the data gridded for that area with the same 15-arcsec resolution in both lon and lat direction?

I could trivially read a lot of slices, but then I need to specify the resolution, and it seems like a bit of a hack.

Thanks!