v5

OpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB
Environment

Construct a NASA GIBS tile URL (string only, no proxy)

Build a tile URL for the NASA GIBS CDN by substituting time, z, x, y (and optionally format / projection) into the layer's ResourceURL template. Returns a JSON record with the constructed URL; clients must fetch the tile directly from the NASA GIBS CloudFront CDN. Sugra does NOT proxy binary tiles: tile fetches through Sugra would cost bandwidth on the Azure App Service for zero added value given NASA's global edge network. Data: NASA GIBS / NASA Earthdata (US public domain).

get/api/v1/environment/nasa-gibs/layer/{layer_id}/tile-url

Path parameters

layer_idstring required

GIBS layer identifier (case-sensitive).

GIBS layer identifier (case-sensitive).

Query parameters

timestring nullable

ISO 8601 date YYYY-MM-DD for the imagery snapshot. Required for time-enabled layers.

ISO 8601 date YYYY-MM-DD for the imagery snapshot. Required for time-enabled layers.

zinteger required

TileMatrix (zoom level), 0-12 (NASA GIBS caps 250 m imagery at z=9).

TileMatrix (zoom level), 0-12 (NASA GIBS caps 250 m imagery at z=9).

xinteger required

TileCol (column).

TileCol (column).

yinteger required

TileRow (row).

TileRow (row).

formatstring nullable

Override MIME type: image/png, image/jpeg, or application/vnd.mapbox-vector-tile. Defaults to the layer's declared Format.

Override MIME type: image/png, image/jpeg, or application/vnd.mapbox-vector-tile. Defaults to the layer's declared Format.

projectionstring

Target projection (defaults to epsg4326).

Target projection (defaults to epsg4326).

Response

Constructed tile URL record. Data: NASA GIBS / NASA Earthdata (US public domain).

Example response

{
  "data": {
    "layer_id": "MODIS_Terra_CorrectedReflectance_TrueColor",
    "time": "2025-04-18",
    "projection": "epsg4326",
    "pathway": "best",
    "tile_matrix_set": "250m",
    "format": "image/jpeg",
    "z": 6,
    "x": 36,
    "y": 13,
    "url": "https://gibs.earthdata.nasa.gov/wmts/epsg4326/best/MODIS_Terra_CorrectedReflectance_TrueColor/default/2025-04-18/250m/6/13/36.jpg",
    "attribution": "NASA GIBS / NASA Earthdata (US public domain)"
  },
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ]
  }
}