{
"apiVersion": "1.0.0",
"swaggerVersion": "1.2",
"basePath": "http://www.marine-geo.org/",
"resourcePath":"/tools",
"produces": [
"application/json",
"text/xml",
"text/plain",
"application/octet-stream"
],
"authorizations": {},
"apis": [
{
"path": "services/GridServer",
"operations": [
{
"method": "GET",
"summary": "Get GMRT grids",
"notes": "Requests are limited to 2GB. (This corresponds to approximately a 20° by 20° grid at 100 m resolution.)
Base URL:
http://www.marine-geo.org/services/GridServer?
", "produces": [ "application/octet-stream", "application/json", "text/xml", "text/plain" ], "nickname": "getGMRTGrid", "authorizations": {}, "parameters": [ { "name": "minlongitude", "description": "The westernmost longitude", "required": true, "defaultValue": "-90", "type": "double", "paramType": "query" }, { "name": "maxlongitude", "description": "The easternmost longitude", "required": true, "defaultValue": "-69.2578", "type": "double", "paramType": "query" }, { "name": "minlatitude", "description": "The southernmost latitude", "required": true, "defaultValue": "-19.4825", "type": "double", "paramType": "query" }, { "name": "maxlatitude", "description": "The northernmost latitude", "required": true, "defaultValue": "-2.9928", "type": "double", "paramType": "query" }, { "name": "format", "description": "The file format of the returned file. (Supported formats are netcdf, coards, esriascii, and geotiff)", "type": "string", "defaultValue": "netcdf", "enum": ["netcdf","coards","esriascii","geotiff"], "paramType": "query" }, { "name": "resolution", "description": "Resolution Keyword (low/default, med, high, max)", "type": "string", "defaultValue": "default", "paramType": "query" }, { "name": "mresolution", "description": "Desired resolution in meters per pixel. If mresolution is specified, the resolution parameter is ignored", "type": "double", "paramType": "query" }, { "name": "layer", "description": "topo - Gridded data with GEBCO 2014 filled in; topo-mask - Gridded data with NaN elsewhere", "defaultValue": "topo", "type": "string", "paramType": "query" } ], "responseMessages": [ { "code": 404, "message": "No Data Returned" }, { "code": 404, "message": "Invalid Output Format Specified" }, { "code": 404, "message": "Invalid Layer Specified" }, { "code": 404, "message": "Invalid W/E/S/N bounds specified" }, { "code": 404, "message": "Invalid Resolution" }, { "code": 413, "message": "Request Too Large" } ] } ] }, { "path": "services/GridServer/north", "operations": [ { "method": "GET", "summary": "Get GMRT grids in North Polar Stereographic EPGS:3995", "notes": "Requests are limited to 2GB.Examples:
http://www.marine-geo.org/services/GridServer?north=-2.9928&west=-90.0000&east=-69.2578&south=-19.4825&layer=topo-mask&format=netcdf&resolution=high
http://www.marine-geo.org/services/GridServer?north=-2.9928&west=-90.0000&east=-69.2578&south=-19.4825&layer=topo&format=geotiff
", "produces": [ "application/octet-stream", "application/json", "text/xml", "text/plain" ], "nickname": "getGMRTGrid", "authorizations": {}, "parameters": [ { "name": "west", "description": "The westernmost point in EPSG:3995", "required": true, "defaultValue": "-8200000", "type": "double", "paramType": "query" }, { "name": "east", "description": "The easternmost point in EPSG:3995", "required": true, "defaultValue": "8200000", "type": "double", "paramType": "query" }, { "name": "south", "description": "The southernmost point in EPSG:3995", "required": true, "defaultValue": "-8200000", "type": "double", "paramType": "query" }, { "name": "north", "description": "The northernmost point in EPSG:3995", "required": true, "defaultValue": "8200000", "type": "double", "paramType": "query" }, { "name": "format", "description": "The file format of the returned file. (North polar currently only supports geotiff)", "type": "string", "defaultValue": "geotiff", "enum": ["geotiff"], "paramType": "query" }, { "name": "resolution", "description": "Resolution Keyword (low/default, med, high, max)", "type": "string", "defaultValue": "default", "paramType": "query" }, { "name": "mresolution", "description": "Desired resolution in meters per pixel. If mresolution is specified, the resolution parameter is ignored", "type": "double", "paramType": "query" }, { "name": "layer", "description": "topo - Gridded data with GEBCO 2014 filled in; topo-mask - Gridded data with NaN elsewhere; metadata - Return grid metadata", "defaultValue": "topo", "type": "string", "paramType": "query" }, { "name": "mformat", "description": "Return format of metadata layer if layer is set to metadata. (xml or json)", "defaultValue": "xml", "type": "string", "enum": ["xml","json"], "paramType": "query" } ], "responseMessages": [ { "code": 404, "message": "No Data Returned" }, { "code": 404, "message": "Invalid Output Format Specified" }, { "code": 404, "message": "Invalid Layer Specified" }, { "code": 404, "message": "Invalid W/E/S/N bounds specified" }, { "code": 404, "message": "Invalid Resolution" }, { "code": 413, "message": "Request Too Large" } ] } ] }, { "path": "services/GridServer/south", "operations": [ { "method": "GET", "summary": "Get GMRT grids in South Polar Stereographic EPGS:3031", "notes": "Requests are limited to 2GB.Examples:
http://www.marine-geo.org/services/GridServer/north?north=8200000&west=-8200000.0000&east=8200000&south=-8200000&layer=topo&format=geotiff&resolution=high
", "produces": [ "application/octet-stream", "application/json", "text/xml", "text/plain" ], "nickname": "getGMRTGrid", "authorizations": {}, "parameters": [ { "name": "west", "description": "The westernmost point in EPSG:3031", "required": true, "defaultValue": "-8200000", "type": "double", "paramType": "query" }, { "name": "east", "description": "The easternmost point in EPSG:3031", "required": true, "defaultValue": "8200000", "type": "double", "paramType": "query" }, { "name": "south", "description": "The southernmost point in EPSG:3031", "required": true, "defaultValue": "-8200000", "type": "double", "paramType": "query" }, { "name": "north", "description": "The northernmost point in EPSG:3031", "required": true, "defaultValue": "8200000", "type": "double", "paramType": "query" }, { "name": "format", "description": "The file format of the returned file. (North polar currently only supports geotiff)", "type": "string", "defaultValue": "netcdf", "enum": ["geotiff"], "paramType": "query" }, { "name": "resolution", "description": "Resolution Keyword (low/default, med, high, max)", "type": "string", "defaultValue": "default", "paramType": "query" }, { "name": "mresolution", "description": "Desired resolution in meters per pixel. If mresolution is specified, the resolution parameter is ignored", "type": "double", "paramType": "query" }, { "name": "layer", "description": "topo - Gridded data with GEBCO 2014 filled in; topo-mask - Gridded data with NaN elsewhere; metadata - Return grid metadata", "defaultValue": "topo", "type": "string", "paramType": "query" }, { "name": "mformat", "description": "Return format of metadata layer if layer is set to metadata. (xml or json)", "defaultValue": "xml", "type": "string", "enum": ["xml","json"], "paramType": "query" } ], "responseMessages": [ { "code": 404, "message": "No Data Returned" }, { "code": 404, "message": "Invalid Output Format Specified" }, { "code": 404, "message": "Invalid Layer Specified" }, { "code": 404, "message": "Invalid W/E/S/N bounds specified" }, { "code": 404, "message": "Invalid Resolution" }, { "code": 413, "message": "Request Too Large" } ] } ] }, { "path": "services/GridServer/metadata", "operations": [ { "method": "GET", "summary": "Get GMRT grid metadata", "notes": "You can use the grid metadata service to return relevant information about a grid without downloading the grid itself.Examples:
http://www.marine-geo.org/services/GridServer/south?north=8200000&west=-8200000.0000&east=8200000&south=-8200000&layer=topo&format=geotiff&resolution=high
", "produces": [ "application/json", "text/xml", "text/plain" ], "nickname": "getGMRTGridMetadata", "authorizations": {}, "parameters": [ { "name": "minlongitude", "description": "The westernmost longitude", "required": true, "defaultValue": "-90", "type": "double", "paramType": "query" }, { "name": "maxlongitude", "description": "The easternmost longitude", "required": true, "defaultValue": "-69.2578", "type": "double", "paramType": "query" }, { "name": "minlatitude", "description": "The southernmost latitude", "required": true, "defaultValue": "-19.4825", "type": "double", "paramType": "query" }, { "name": "maxlatitude", "description": "The northernmost latitude", "required": true, "defaultValue": "-2.9928", "type": "double", "paramType": "query" }, { "name": "format", "description": "The file format for which metadata is requested.", "type": "string", "defaultValue": "netcdf", "enum": ["netcdf","coards","esriascii","geotiff"], "paramType": "query" }, { "name": "resolution", "description": "Resolution Keyword (low/default, med, high, max) or integer power of 2 zoom level (<=1024)", "type": "string", "defaultValue": "default", "paramType": "query" }, { "name": "mresolution", "description": "Nearest resolution in meters per pixel.", "type": "double", "paramType": "query" }, { "name": "mformat", "description": "Return format of metadata itself.", "defaultValue": "xml", "type": "string", "paramType": "query" } ], "responseMessages": [ { "code": 404, "message": "No Data Returned" }, { "code": 404, "message": "Invalid W/E/S/N bounds specified" }, { "code": 404, "message": "Invalid Resolution" } ] } ] }, { "path": "services/GridServer/attribution/{attributiontype}", "operations": [ { "method": "GET", "summary": "Get GMRT grid metadata", "notes": "You can use the grid attribution service to return specific attribution information about all cruises and contributed grids in a given area.Examples:
http://www.marine-geo.org/services/GridServer/metadata?north=-2.9928&west=-90.0000&east=-69.2578&south=-19.4825&format=netcdf&mformat=xml
http://www.marine-geo.org/services/GridServer/metadata?north=-2.9928&west=-90.0000&east=-69.2578&south=-19.4825&format=arcascii&mformat=json&resolution=high
", "produces": [ "text/xml" ], "nickname": "getGMRTGridAttribution", "authorizations": {}, "parameters": [ { "name": "attributiontype", "description": "Specific attribution information to retrieve.Examples:
http://www.marine-geo.org/services/GridServer/attribution?north=-2.9928&west=-90.0000&east=-69.2578&south=-19.4825&format=netcdf&mformat=xml
http://www.marine-geo.org/services/GridServer/attribution?north=-2.9928&west=-90.0000&east=-69.2578&south=-19.4825&format=arcascii&resolution=high