Acquiring Image Content

Arkance Systems Benelux

GeoView Server REST API enables acquiring image content based on specified image identifier and resulting file format. Accessing this method requires Read permissions.


Request API method URI definition:


HTTP GET http://api.geoview.be/geoservice/v1/images/<id>/<format>


Request HTTP URI parameters:


Parameter

Description

token

Access token (returned by this API method).

id

Image identifier (returned by i.e. this API method).

format

One of the available raster-based or vector-based data formats.

width

Image width in pixels. This parameter is optional. If omitted, original image width will be used. Used only in raster context. If you use only width parameter and not height parameter, then image will be resized while keeping aspect ratio based on specified image width.

height

Image height in pixels. This parameter is optional. If omitted, original image height will be used. Used only in raster context. If you use only height parameter and not width parameter, then image will be resized while keeping aspect ratio based on specified image height.

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. Used only in vector context, for file formats enabling arbitrary coordinate reference systems.


Example HTTP request URI using "jpg" raster format:


HTTP GET http://api.geoview.be/geoservice/v1/images/6e39547d-aed2-4e60-9e01-5d5c0921953a/jpg?token=3dc718f2-ab20-4f41-86e1-72abcc1810c1


Example HTTP request URI returning image in JPG format resized to 300 pixels in width, while preserving image aspect ratio:


HTTP GET http://api.geoview.be/geoservice/v1/images/6e39547d-aed2-4e60-9e01-5d5c0921953a/jpg?width=300&token=3dc718f2-ab20-4f41-86e1-72abcc1810c1


Example HTTP request URI returning image in JPG format resized to 300 x 200 pixels, not preserving image aspect ratio:


HTTP GET http://api.geoview.be/geoservice/v1/images/6e39547d-aed2-4e60-9e01-5d5c0921953a/jpg?width=300&height=200&token=3dc718f2-ab20-4f41-86e1-72abcc1810c1


Possible resulting HTTP status codes:


Value

Description

200

API request succeeded and result was returned.

204

API request succeeded but query didn't produce any results (i.e. image raw data is missing on server).

401

Supplied API request access token not valid.


Example JPEG response stream:


Sample bitmap response stream