Query Image Meta-data

Arkance Systems Benelux

The GeoView Server REST API enables querying a single recording by identifier. A query filters feature data store by specified identifier, returning recording meta-data associated with image (if any). Accessing this method requires Read permissions.


Request API method URI definition:


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


Request HTTP URI parameters:


Parameter

Description

token

Access token (returned by this API method).

id

Image identifier (returned by i.e. 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:


HTTP GET http://api.geoview.be/geoservice/v1/images/6e39547d-aed2-4e60-9e01-5d5c0921953a?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.


Resulting meta-data structure and example of JSON response:


[

  {

     "category":"Photo",

     "constraints":null,

     "editable":false,

     "id":"id",

     "text":"382be5e5-b538-4093-a825-522467ddb540",

     "title":"Identifier",

     "type":"String",

     "value":"382be5e5-b538-4093-a825-522467ddb540",

     "visible":true

     "view":0

  },{

     ...

  }

]


Description of possible resulting image properties:


Name

Description

id

Image unique identifier.

id_next

Next image identifier if image belongs to a track. If null, there is no next image.

id_previous

Previous image identifier if image belongs to a track. If null, there is no previous image.

tid

Image track's unique identifier. If not present, image has no associated track.

uid

User's (author's) identifier.

cid

Image recording device (camera) unique identifier. If not present, image has no associated camera device.

pid

Project identifier if image was associated with a project. If not present, image was not associated with a project.

created

Date and time (in UTC format) the image was created.

processed

Date and time (in UTC format) the image was processed.

updated

Date and time (in UTC format) the image meta-data was last updated.

location

Image location in terms of address, city and/or region.

description

Description associated with specific image.

position

Formatted X and Y ordinate values of recording in specified SRS (longitude/latitude in WGS84).

x

X ordinate value of recording in specified SRS (longitude in WGS84).

y

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

elevation

Height above ground of recording (meters).

yaw

Yaw angle (azimuth) of recording device at the time of shooting (radians). If zero, value is unknown.

pitch

Pitch angle of recording device at the time of shooting (radians). If zero, value is unknown.

roll

Roll angle of recording device at the time of shooting (radians). If zero, value is unknown.

hfov

Horizontal field of view of camera taking specific image (radians). If zero, value is unknown.

vfov

Vertical field of view of camera taking specific image (radians). If zero, value is unknown.

precision

Formatted geometric dilution of precision of recording device taking an image. See property constraints for more info.

dop

Geometric dilution of precision of recording device taking an image. If zero, value is unknown.

speed

Speed of recording device at the time of shooting (m/s). If zero, value is either unknown or camera was still.

orientation

Camera orientation.See property constraints for more info.

type

Image type (directional or panoramic). See property constraints for more info.

transport

Mean of transportation used during taking an image. If zero, value is unknown. See property constraints for more info.

weather

Weather conditions during taking an image. If zero, value is unknown. See property constraints for more info.

source

Type of raw data source used to produce image. See property constraints for more info.

daytime

Represents a time of the day when recording was taken. See property constraints for more info.