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

GET

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

Last modified:2026-05-10 09:22:39

Maintainer:Not configured

OperationId:environment_nasa_gibs_layer_layer_id_tile_url

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

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Path Params

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/environment/nasa-gibs/layer/MODIS_Terra_CorrectedReflectance_TrueColor/tile-url?time=2025-04-18&z=6&x=36&y=13&format=image%2Fjpeg&projection=epsg4326' \
--header 'x-api-key: <api-key>'

Responses

🟢200

application/json

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

Bodyapplication/json

Example

{
    "data": {
        "layer_id": "MODIS_Terra_CorrectedReflectance_TrueColor",
        "time": "string",
        "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)",
        "proxy_note": "string"
    },
    "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": "string",
        "fallback_used": true,
        "fallback_chain": [
            "string"
        ],
        "cached": true
    }
}

🟠401

🟠422

🟠429

🔴503

Modified at 2026-05-10 09:22:39

Available time intervals for a NASA GIBS layer

List NASA GIBS colormap XML documents