Image tile

Generate a slippy map XYZ raster tile a for a given scene. Tiles are 256x256 pixels. Tiles outside of scene’s extent are transparent by default.

Tile API

GET /(view_id)/(bands)/(z)/(x)/(y)
Parameters:
  • view_id – View id of a scene retrieved from the Search API
  • bands – band combination expression. Some band combinations are defined in the service using aliases (see Name Aliases). For available bands please refer to Supported Datasets
  • z – zoom level
  • x – tile grid x coordinate
  • y – tile grid y coordinate
Query Parameters:
 
  • api_key – (required) user’s API key
  • MIN_MAX – (optional) list of comma separated min,max values for contrast stretching. Default: calculated by cumulative count cut algorithm with 2%-98% range and cloud correction.
  • COLORS – (optional, only used in pair with THRESHOLDS) (for bandmath and grayscale only) list of comma separated color-hexes, which are used for colorization in pair with THRESHOLDS. Note: has to contain 1 more value than THRESHOLDS. (See Range colorization)
  • THRESHOLDS – (optional, only used in pair with COLORS) (for bandmath and grayscale only) list of comma separated values of color thresholds, which are used for colorization in pair with COLORS. Note: has to contain 1 less value than COLORS. (See Range colorization)
  • crs – (optional) output tile projection. Default: “EPSG:3857”
  • CALIBRATE – (optional) (for bandmath only) unique parameter for BandMath – if True (or 1), converts band data to ToA Reflectance (or to At-Satellite Brightness Temperature for TIRS) prior to performing the band math (See Radiometric Correction).
  • COLORMAP – (optional) (for bandmath and grayscale only) bandmath colorization with the specified colormap. MIN_MAX can be applied with this query param. (See Colormap API; see also Colorbar API to get the legend colorbar)
  • COLORS_LIMIT – (optional) count of colors for continuous colormaps (See Colormap API)
  • cropper_ref – (optional) AOI reference from Cropper API; any image data that does not fall into AOI is made transparent. (See Cropper API)
  • RESAMPLE – (optional) interpolation type (‘near’, ‘bilinear’, ‘cubic’, ‘cubicspline’, ‘lanczos’, ‘average’, ‘mode’, ‘max’, ‘min’, ‘med’, ‘q1’, ‘q3’)
  • mimetype – (optional) output image type (‘image/jpeg’, ‘image/png’). Default: ‘image/jpeg’ for not transparent tiles; ‘image/png’ for tiles with transparency
  • PALETTE – (optional) dictionary with bit numbers (1 bit number or 2 as a tuple) as keys and colors (in form of RGB or hex) as values. If in any given pixel some bits have value 1, it’s set to corresponding color from the palette. If bits don’t have a color tied to them in the palette, pixels are made transparent. Without this parameter BQA is colorized with default palette (See Palette)
  • PANSHARPENING – (optional) performs pansharpening of a given band combination if True (or 1). This option is supported for Landsat-8 and Landsat-7 only (see Pansharpening)

Examples

Visualize a band combination (RGB Mapping)

Landsat 8 True Color

http

GET /api/render/L8/LC80440342015304LGN00/B4,B3,B2/12/657/1589?api_key=XXX HTTP/1.1
Host: gate.eos.com

curl

curl -i 'https://gate.eos.com/api/render/L8/LC80440342015304LGN00/B4,B3,B2/12/657/1589?api_key=XXX'

Sentinel-2 True Color

http

GET /api/render/S2/36/U/XU/2016/5/2/0/B04,B03,B02/13/4894/2839?api_key=XXX HTTP/1.1
Host: gate.eos.com

curl

curl -i 'https://gate.eos.com/api/render/S2/36/U/XU/2016/5/2/0/B04,B03,B02/13/4894/2839?api_key=XXX'

Landsat 7 - False Color Image

http

GET /api/render/L7/LE07_L1TP_042036_20170405_20170501_01_T1/B4,B3,B2/11/342/815?api_key=XXX HTTP/1.1
Host: gate.eos.com

curl

curl -i 'https://gate.eos.com/api/render/L7/LE07_L1TP_042036_20170405_20170501_01_T1/B4,B3,B2/11/342/815?api_key=XXX'

Sentinel-1 - RGB Mapping of bands VV,VH,VV

http

GET /api/render/S1/S1A_IW_GRDH_1SDV_20180803T125259_20180803T125328_023082_02819A_19F1/VV,VH,VV/11/443/772?api_key=XXX HTTP/1.1
Host: gate.eos.com

curl

curl -i 'https://gate.eos.com/api/render/S1/S1A_IW_GRDH_1SDV_20180803T125259_20180803T125328_023082_02819A_19F1/VV,VH,VV/11/443/772?api_key=XXX'

Landsat 8 - Pansharpening

http

GET /api/render/L8/LC80440342015304LGN00/B4,B3,B2/12/657/1589?PANSHARPENING=1&api_key=XXX HTTP/1.1
Host: gate.eos.com

curl

curl -i 'https://gate.eos.com/api/render/L8/LC80440342015304LGN00/B4,B3,B2/12/657/1589?PANSHARPENING=1&api_key=XXX'

http

GET /api/render/L8/LC80440342015304LGN00/NDVI/12/657/1589?CALIBRATE=1&PANSHARPENING=1&api_key=XXX HTTP/1.1
Host: gate.eos.com

curl

curl -i 'https://gate.eos.com/api/render/L8/LC80440342015304LGN00/NDVI/12/657/1589?CALIBRATE=1&PANSHARPENING=1&api_key=XXX'

Visualization of spectral indices

Landsat 8 NDVI colorized with a palette:

http

GET /api/render/L8/LC80440342015304LGN00/NDVI/12/657/1589?CALIBRATE=1&COLORMAP=viridis&MIN_MAX=-1%2C1&api_key=XXX HTTP/1.1
Host: gate.eos.com

curl

curl -i 'https://gate.eos.com/api/render/L8/LC80440342015304LGN00/NDVI/12/657/1589?CALIBRATE=1&COLORMAP=viridis&MIN_MAX=-1%2C1&api_key=XXX'

Landsat 8 custom index colorized with a palette:

http

GET /api/render/L8/LC80440342015224LGN00/(B5-0.5)/11/328/794?CALIBRATE=1&COLORS=000000%2Cffffff%2Cc4baa4%2Cb4966c%2Ca4824c&THRESHOLDS=0%2C0.3%2C0.6%2C0.9&api_key=XXX HTTP/1.1
Host: gate.eos.com

curl

curl -i 'https://gate.eos.com/api/render/L8/LC80440342015224LGN00/(B5-0.5)/11/328/794?CALIBRATE=1&COLORS=000000%2Cffffff%2Cc4baa4%2Cb4966c%2Ca4824c&THRESHOLDS=0%2C0.3%2C0.6%2C0.9&api_key=XXX'

Sentinel-2 - NDVI

http

GET /api/render/S2/36/U/XU/2016/5/2/0/NDVI/13/4894/2839?CALIBRATE=1&api_key=XXX HTTP/1.1
Host: gate.eos.com

curl

curl -i 'https://gate.eos.com/api/render/S2/36/U/XU/2016/5/2/0/NDVI/13/4894/2839?CALIBRATE=1&api_key=XXX'

Visualize image inside an AOI

http

GET /api/render/L8/LC80430352016012LGN00/NDVI/11/337/799?CALIBRATE=1&cropper_ref=74f4eb541dba18bbb0d3efe63ac54d90&api_key=XXX HTTP/1.1
Host: gate.eos.com

curl

curl -i 'https://gate.eos.com/api/render/L8/LC80430352016012LGN00/NDVI/11/337/799?CALIBRATE=1&cropper_ref=74f4eb541dba18bbb0d3efe63ac54d90&api_key=XXX'

Landsat 8 - Visualize Quality Assessment band

http

GET /api/render/L8/LC80440342015224LGN00/BQA/15/5277/12696?PALETTE=%7B%22%2815%2C14%29%22%3A%22#33a02c"}&api_key=XXX HTTP/1.1
Host: gate.eos.com

curl

curl -i 'https://gate.eos.com/api/render/L8/LC80440342015224LGN00/BQA/15/5277/12696?PALETTE=%7B%22%2815%2C14%29%22%3A%22#33a02c"}&api_key=XXX'

http

GET /api/render/L8/LC80440342015224LGN00/BQA/12/672/1596?PALETTE=%7B%220%22%3A%5B85%2C0%2C0%5D%7D&api_key=XXX HTTP/1.1
Host: gate.eos.com

curl

curl -i 'https://gate.eos.com/api/render/L8/LC80440342015224LGN00/BQA/12/672/1596?PALETTE=%7B%220%22%3A%5B85%2C0%2C0%5D%7D&api_key=XXX'

Image API

Generate a raster for a given scene in given bbox. Raster shape is 256x256 by default but can be changed. Data outside of scene’s extent is transparent.

Image API description

GET /(view_id)/(bands)/(z)/(x_bounds)/(y_bounds)
Parameters:
  • view_id – View id of a scene retrieved from the Search API
  • bands – band combination expression. Some band combinations are defined in the service using aliases (see Name Aliases). For available bands please refer to Supported Datasets
  • z – zoom level according to slippy map. Different zoom provide different image quality.
  • x_bounds – x bounds. Specifies left most and right most points of bbox, and bounds projection code. Format: -120.552979;-118.278809;4326
  • y_bounds – y bounds. Specifies upper most and lower most points of bbox, and bounds projection code. Format: -120.552979;-118.278809;4326
Query Parameters:
 
  • api_key – (required) user’s API key
  • MIN_MAX – (optional) list of comma separated min,max values for contrast stretching. Default: calculated by cumulative count cut algorithm with 2%-98% range and cloud correction.
  • COLORS – (optional, only used in pair with THRESHOLDS) (for bandmath and grayscale only) list of comma separated color-hexes, which are used for colorization in pair with THRESHOLDS. Note: has to contain 1 more value than THRESHOLDS. (See Range colorization)
  • THRESHOLDS – (optional, only used in pair with COLORS) (for bandmath and grayscale only) list of comma separated values of color thresholds, which are used for colorization in pair with COLORS. Note: has to contain 1 less value than COLORS. (See Range colorization)
  • crs – (optional) output tile projection. Default: “EPSG:3857”
  • CALIBRATE – (optional) (for bandmath only) unique parameter for BandMath – if True (or 1), converts band data to ToA Reflectance (or to At-Satellite Brightness Temperature for TIRS) prior to performing the band math (See Radiometric Correction).
  • COLORMAP – (optional) (for bandmath and grayscale only) bandmath colorization with the specified colormap. MIN_MAX can be applied with this query param. (See Colormap API; see also Colorbar API to get the legend colorbar)
  • COLORS_LIMIT – (optional) count of colors for continuous colormaps (See Colormap API)
  • cropper_ref – (optional) AOI reference from Cropper API; any image data that does not fall into AOI is made transparent. (See Cropper API)
  • RESAMPLE – (optional) interpolation type (‘near’, ‘bilinear’, ‘cubic’, ‘cubicspline’, ‘lanczos’, ‘average’, ‘mode’, ‘max’, ‘min’, ‘med’, ‘q1’, ‘q3’)
  • mimetype – (optional) output image type (‘image/jpeg’, ‘image/png’). Default: ‘image/jpeg’ for not transparent tiles; ‘image/png’ for tiles with transparency
  • PALETTE – (optional) dictionary with bit numbers (1 bit number or 2 as a tuple) as keys and colors (in form of RGB or hex) as values. If in any given pixel some bits have value 1, it’s set to corresponding color from the palette. If bits don’t have a color tied to them in the palette, pixels are made transparent. Without this parameter BQA is colorized with default palette (See Palette)
  • PANSHARPENING – (optional) performs pansharpening of a given band combination if True (or 1). This option is supported for Landsat-8 and Landsat-7 only (see Pansharpening)

Examples

Visualize a band combination (RGB Mapping)

Landsat 8 True Color

http

GET /api/render/L8/LC80440342015304LGN00/B4,B3,B2/10/-123.250122;-121.942749;4326/37.720763;38.610432;4326?TILE_SIZE=800%2C600&api_key=XXX HTTP/1.1
Host: gate.eos.com

curl

curl -i 'https://gate.eos.com/api/render/L8/LC80440342015304LGN00/B4,B3,B2/10/-123.250122;-121.942749;4326/37.720763;38.610432;4326?TILE_SIZE=800%2C600&api_key=XXX'

Sentinel-2 True Color

http

GET /api/render/S2/36/U/XU/2016/5/2/0/B04,B03,B02/10/34.102936;35.397949;4326/48.074409;48.649242;4326?TILE_SIZE=800%2C400&api_key=XXX HTTP/1.1
Host: gate.eos.com

curl

curl -i 'https://gate.eos.com/api/render/S2/36/U/XU/2016/5/2/0/B04,B03,B02/10/34.102936;35.397949;4326/48.074409;48.649242;4326?TILE_SIZE=800%2C400&api_key=XXX'

Landsat 7 - False Color Image

http

GET /api/render/L7/LE07_L1TP_042036_20170405_20170501_01_T1/B4,B3,B2/11/-120.552979;-118.278809;4326/34.020795;35.626047;4326?TILE_SIZE=800%2C600&api_key=XXX HTTP/1.1
Host: gate.eos.com

curl

curl -i 'https://gate.eos.com/api/render/L7/LE07_L1TP_042036_20170405_20170501_01_T1/B4,B3,B2/11/-120.552979;-118.278809;4326/34.020795;35.626047;4326?TILE_SIZE=800%2C600&api_key=XXX'