Skip to content
URL:
https://<root>/services/serviceName/layerID/update/camera
Methods:
POST
Version Introduced:
12.0

Description

The update/camera operation is utilized to provide additional information regarding the camera used to record video files. This includes the camera's starting position, field of view, etc.

Request parameters

ParameterDetails

farDistance

(Optional)

The farDistance parameter can be utilized to establish the farthest usable distance of the footage from the camera position.

heading

(Optional)

The Heading parameter requires an integer representing the direction faced by the camera.

position

(Required)

The X and Y coordinates representing the location of a camera. This parameter requires "x" and "y" properties to create the footprint of the viewed area.

tilt

(Optional)

The tilt parameter requires an integer which represents the angle at which a camera is tilted/positioned in. This should be a negative value.

fov

(Optional)

Represents the field of view (FOV) value with which the video in a given layer was recorded. Accepted value is an integer representing the FOV degree.

height

(Optional)

Sets a height value for the camera. Accepted value is an integer representing the height in meters.

f

(Required)

The output format for this operation. The default value is html.

Values: html | json | pjson

token

(Required)

Users interacting programmatically with this endpoint must generate a token that must be included as a request parameter. A token can be obtained using the Generate Token operation.

Example usage

The following is a sample POST request for the /update/camera operation:

Use dark colors for code blocksCopy
1
2
3
4
5
6
POST /arcgis/rest/services/sampleService/VideoServer/01/update/camera HTTP/1.1
Host: organization.example.com:21443
Content-Type: application/x-www-form-urlencoded
Content-Length: []

token=videoServerToken&height=50&heading=17&position={"x":0,"y":0}&tilt=-50&fov=90&farDistance=400true&f=pjson

JSON Response syntax

Use dark colors for code blocksCopy
1
2
3
4
5
{
    "jobId": "<jobId>",
    "success": <true | false>
    "message": <message string>
}

JSON Response example

Use dark colors for code blocksCopy
1
2
3
4
5
{
    "jobId": "j566f2357-6902-4074-b805-1bf335c147e2",
    "success": true,
    "message": null
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.