Point value

Get value of a spectral index or a band combination at given coordinates.

GET /(sensor)/point/(scene_id)/(bands)/(lat)/(lon)
Parameters:
  • sensor – abbreviation for the 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 expression
  • lat – Latitude geographic coordinate that specifies the north–south position of a point on the Earth’s surface
  • lon – Longitude is a geographic coordinate that specifies the east-west position of a point on the Earth’s surface. It is an angular measurement
Query Parameters:
 
  • api_key – (required) user’s API key
  • CALIBRATE – (optional) if True (or 1), converts band data to ToA reflectance (or to at-satellite brightness temperature for thermal bands) prior to performing the band math (see Radiometric Correction)

Examples

Landsat 8 - Get value of NDVI at given point

Example request:

http

GET /api/render/L8/point/LC80430352016012LGN00/(B5-B4)/(B5+B4)/35.947344068/-121.345009409?CALIBRATE=1&api_key=XXX HTTP/1.1
Host: gate.eos.com

curl

curl -i 'https://gate.eos.com/api/render/L8/point/LC80430352016012LGN00/(B5-B4)/(B5+B4)/35.947344068/-121.345009409?CALIBRATE=1&api_key=XXX'

Example response:

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8

{"index_value": 0.26041478}

Sentinel-2 - Get DN value of the red band at given point

Example request:

http

GET /api/render/S2/point/55/G/EP/2016/7/19/0/B04/-42.026067/147.824152?api_key=XXX HTTP/1.1
Host: gate.eos.com

curl

curl -i 'https://gate.eos.com/api/render/S2/point/55/G/EP/2016/7/19/0/B04/-42.026067/147.824152?api_key=XXX'

Example response:

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8

{"index_value": 1023.0}

Sentinel-2 - Get ToA reflectance value of the red band at given point

Example request:

http

GET /api/render/S2/point/55/G/EP/2016/7/19/0/B04/-42.026067/147.824152?CALIBRATE=1&api_key=XXX HTTP/1.1
Host: gate.eos.com

curl

curl -i 'https://gate.eos.com/api/render/S2/point/55/G/EP/2016/7/19/0/B04/-42.026067/147.824152?CALIBRATE=1&api_key=XXX'

Example response:

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8

{"index_value": 0.1023}