Acquiring Data Store Extents

GeoCrew

The GeoView Server REST API enables acquiring spatial extents of all recordings in a data store. Accessing this method requires Read permissions.


Request API method URI definition:


HTTP GET http://api.geoview.be/geoservice/v1/images/extents


Request HTTP URI parameters:


Parameter

Description

token

Access token (returned by this API method).

srs

Spatial reference system identifier (returned by this API method), being an EPSG code value. This parameter is optional. If omitted, default GeoView Server spatial reference system will be used.


Example HTTP request URI using default GeoView Server coordinate system:


HTTP GET http://api.geoview.be/geoservice/v1/images/extents?token=3dc718f2-ab20-4f41-86e1-72abcc1810c1


Example HTTP request URI using WGS84 coordinate system:


HTTP GET http://api.geoview.be/geoservice/v1/images/extents?srs=4326&token=3dc718f2-ab20-4f41-86e1-72abcc1810c1


Possible resulting HTTP status codes:


Value

Description

200

API request succeeded and result(s) were returned.

400

API request failed due to wrong parameter value(s).

401

Supplied API request access token not valid.


Response JSON structure for a single recording (please note that API method may return array of recordings):


Field

Description

minx

Min. X-ordinate value of envelope in specified SRS (longitude value in WGS84).

miny

Min. Y-ordinate value of recording in specified SRS (latitude value in WGS84).

maxx

Max. X-ordinate value of envelope in specified SRS (longitude value in WGS84).

maxy

Max. Y-ordinate value of recording in specified SRS (latitude value in WGS84).


Example JSON response using default GeoView Server coordinate system:


{

  "maxx":282768.5293400872,

  "maxy":318596.64129402675,

  "minx":15572.085855374171,

  "miny":38580.251677417196

}


Example JSON response using WGS84 coordinate system:


{

  "maxx":6.30842630663741,

  "maxy":52.160266218928079,

  "minx":2.5073758293786503,

  "miny":49.643761343510761

}