Skip to main content

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

ParameterValueDescription
sensorL8abbreviation for the name of the sensor
scene_idLC80430352016012LGN00scene’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
lat35.947344068Latitude geographic coordinate that specifies the north–south position of a point on the Earth’s surface
lon121.345009409Longitude 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

ParameterValueDescription
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

ParameterValueDescription
sensorL8abbreviation for the name of the sensor

Query parameters

ParameterValueDescription
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