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 |