Query Image Meta-data
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 |
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. |
