Point value API

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

curl -i 'https://api-connect.eos.com/api/render/<sensor>/point/<scene>/<bands>/<lat>/<lon>?CALIBRATE=1&api_key=<your_api_key>'

The above commands returns the following JSON with results

{"index_value": 0.26041478}

HTTP Request

GET https://api-connect.eos.com/api/render/<sensor>/point/<scene>/<bands>/<lat>/<lon>?CALIBRATE=1&api_key=<your_api_key>

Parameters

Parameter	Value	Description
sensor	L8	abbreviation for the name of the sensor
scene_id	LC80430352016012LGN00	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	(B5-B4)/(B5+B4)	band combination expression
lat	35.947344068	Latitude geographic coordinate that specifies the north–south position of a point on the Earth’s surface
lon	121.345009409	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

Parameter	Value	Description
api_key		(Required) Apikey retrieved from developer portal

Examples

Landsat 8 - Get value of NDVI at given point

Example request:

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

Example response:

{"index_value": 0.26041478}

---

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

Example request:

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

Example response:

{"index_value": 1023.0}

Slice

This API grants you the ability to get values of all pixels that lie on the line, defined by 2 points. For terrain and geoid datasets only line markers are required, but for other sensors, you need also to specify ‘scene’ and ‘band’ parameters.

curl -i 'https://api-connect.eos.com/api/render/L8/slice?scene=LC08_L1TP_045033_20170301_20170316_01_T1&band=B5&markers=123.635,38.83,-123.634,38.831&api_key=<your_api_key>'

The above commands returns the following JSON with results

{
   "vector":[
      5428,
      5544,
      6226,
      5463
   ],
   "points":[
      [
         -123.635,
         38.83
      ],
      [
         -123.63466666666667,
         38.830333333333336
      ],
      [
         -123.63433333333333,
         38.830666666666666
      ],
      [
         -123.634,
         38.831
      ]
   ],
   "markers":[
      [
         -123.635,
         38.83
      ],
      [
         -123.634,
         38.831
      ]
   ]
}

HTTP Request

GET https://api-connect.eos.com/api/render/<sensor>/slice?api_key=<your_api_key>

Parameters

Parameter	Value	Description
sensor	L8	abbreviation for the name of the sensor

Query parameters

Parameter	Value	Description
api_key		(Required) Apikey retrieved from developer portal
markers		(required) coordinates of the 2 points, which define the slice line (in long/lat)
scene		(optional in case of sensor - TERRAIN
band		(optional in case of sensor - TERRAIN
resolution		(optional, default - 1, positive integer) resolution for line interpolation