Get preview image

Get scene preview with watermarks.

GET /(sensor)/preview/(scene_id)/(bands)/(zoom)/(lat)/(lon)
Parameters:
  • sensor – short name of the sensor (See Table of sensor name abbreviations)
  • scene_id – scene’s identificator. scene_id is constructed by removing the short-name-of-the-sensor prefix from the view_id returned by the Search API. Examples: “10/S/EG/2017/3/1/0”, “LE70420362017095EDC00”, “115/S1A_IW_GRDH_1SDV_20161201T141548_20161201T141617_014187_016EBB_F627” etc
  • bands – band combination
  • zoom – zoom value
  • lat – latitude value
  • lon – longitude value
Query Parameters:
 
  • api_key – (required) user’s API key

Examples

Example Landsat 8

http

GET /api/render/L8/preview/LC80440342017021LGN00/B4,B3,B2/12/37.49801/-122.18737?api_key=XXX HTTP/1.1
Host: gate.eos.com

curl

curl -i 'https://gate.eos.com/api/render/L8/preview/LC80440342017021LGN00/B4,B3,B2/12/37.49801/-122.18737?api_key=XXX'

Example Landsat 7

http

GET /api/render/L7/preview/LE70420362017095EDC00/B3,B2,B1/11/34.51781/-120.0426?api_key=XXX HTTP/1.1
Host: gate.eos.com

curl

curl -i 'https://gate.eos.com/api/render/L7/preview/LE70420362017095EDC00/B3,B2,B1/11/34.51781/-120.0426?api_key=XXX'

Example Sentinel-2

http

GET /api/render/S2/preview/10/S/EG/2017/3/1/0/B04,B03,B02/12/37.51408/-122.09124?api_key=XXX HTTP/1.1
Host: gate.eos.com

curl

curl -i 'https://gate.eos.com/api/render/S2/preview/10/S/EG/2017/3/1/0/B04,B03,B02/12/37.51408/-122.09124?api_key=XXX'

Example Sentinel-1

http

GET /api/render/S1/preview/115/S1A_IW_GRDH_1SDV_20161201T141548_20161201T141617_014187_016EBB_F627/VH,VH,VV/11/37.86939/-122.27187?api_key=XXX HTTP/1.1
Host: gate.eos.com

curl

curl -i 'https://gate.eos.com/api/render/S1/preview/115/S1A_IW_GRDH_1SDV_20161201T141548_20161201T141617_014187_016EBB_F627/VH,VH,VV/11/37.86939/-122.27187?api_key=XXX'

Example MODIS

http

GET /api/render/MODIS/preview/08/05/2017067/2017076074010/B01,B04,B03/11/37.86939/-120.27187?api_key=XXX HTTP/1.1
Host: gate.eos.com

curl

curl -i 'https://gate.eos.com/api/render/MODIS/preview/08/05/2017067/2017076074010/B01,B04,B03/11/37.86939/-120.27187?api_key=XXX'