Acquiring Transfer Meta-data

The GeoView Server REST API enables acquiring transfer meta-data used to describe file recording being uploaded. Accessing this method requires either Read permissions.

Request API method URI definition:

HTTP GET http://api.geoview.be/geoservice/v1/transfers/metadata

Request HTTP URI parameters:

Parameter	Description
token	Access token (returned by this API method).
client	Client type identifier (based on predefined constraints).This value is optional. If omitted, assumes 0.

Example HTTP request URI for Web client:

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

Example HTTP request URI for Mobile client:

HTTP GET http://api.geoview.be/geoservice/v1/transfers/metadata?token=3dc718f2-ab20-4f41-86e1-72abcc1810c1&client=1

Possible resulting HTTP status codes:

Value	Description
200	API request succeeded and result(s) were returned.
401	Supplied API request access token not valid.

Resulting meta-data structure and example of JSON response:

[

{

"category":"Transfer",

"constraints":null,

"editable":false,

"id":"location",

"text":"",

"title":"Location",

"type":"String",

"value":"",

"visible":true

"view":0

},{

...

}

]

Description of possible resulting recording properties:

Parameter	Type	Description
accuracy	Double	Positional GPS accuracy at the time of recording (meters). This value is optional.
altitude	Double	Altitude (elevation) value at the time of recording (meters). This value is optional.
azimuth	Integer	Azimuth (compass) value at the time of recording (degrees). This value is optional.
cid	String	Device/camera ID used to record this file (returned by this API method). This value is optional. If omitted, server will try to recognize device based on recording meta-data.
created	String	Date recording was created. Date format is: yyyy-MM-dd HH:mm:ss. This value is optional. If omitted, server will try to recognize creation date based on recording meta-data.
daytime	Integer	Time of day at the time of recording. This value is optional. If omitted, server will try to recognize daytime based on recording meta-data.
description	String	Arbitrary description related to this recording. This value is optional.
latitude	Double	Latitude GPS value at the time of recording. This value is optional. If omitted, server will try to recognize recording latitude based on recording meta-data.
longitude	Double	Longitude GPS value at the time of recording. This value is optional. If omitted, server will try to recognize recording longitude based on recording meta-data.
location	String	Location/address where recording was taken. This value is optional. If omitted, server will try to reverse geo-code location based on recording meta-data.
maker	String	Device/camera maker identifier. This value is optional. If omitted, server will try to recognize device maker based on recording meta-data.
model	String	Device/camera model identifier. This value is optional. If omitted, server will try to recognize device model based on recording meta-data.
orientation	Integer	Device orientation at the time of recording (based on predefined constraints). This value is optional. If omitted, server will try to recognize device orientation on recording meta-data.
pid	String	Project ID being recorded (returned by this API method). This value is optional.
precision	Integer	GPS precision at the time of the recording (based on predefined constraints). This value is optional. If omitted, server will try to recognize precision based on recording meta-data.
rotation	Integer	User-imposed image rotation of the recording (based on predefined constraints). This value is optional.
site	String	Site name being recorded. This value is optional.
transport	Integer	Method of transportation used while recording (based on predefined constraints). This value is optional.
weather	Integer	Weather conditions during recording (based on predefined constraints). This value is optional.