Set Camera

Set or update the viewing perspective of the scene to a specified position.

Request URL

<baseUrl>/arcgisearth/camera(PUT ONLY)

Request parameters

ParameterDescription

position

(required)

The position of the camera defined by a map point. It defines the JSON formats of the point and spatial reference objects.

  • x
    • x-coordinate measured along the east–west axis.
    • Type: double
  • y
    • y-coordinate measured along the north–south axis.
    • Type: double
  • z
    • z-coordinate measures height or elevation.
    • Type: double
  • spatialReference

JSON syntax:

{
    "x": <x>,
    "y": <y>,
    "z": <z>,
    "spatialReference": {
        <spatialReference>
    }
}

heading

(optional)

Set or update the camera heading property. Values range from 0 to 360 degrees, starting from north in the East, North, Up (ENU) reference system.

Type: double

tilt

(optional)

Set or update the camera tilt property, which is the rotation angle around the y-axis of the ENU reference system (rotating along the axis that passes through the plane's wings). Values range from 0 to 180 degrees. 0 is looking directly down and 180 is looking directly up.

Type: double

roll

(optional)

Set or update the camera roll property, which is the rotation angle around the x-axis of the ENU reference system (rotating along the axis that passes through the center of the plane from front to back). Values range from 0 to 360 degrees. A zero value is perfectly horizontal.

Type: double

Example usage

{
    "position": {
        "x": -92,
        "y": 41,
        "z": 11000000,
        "spatialReference": {
            "wkid": 4326
        }
    },
    "heading": 2.3335941892764884E-17,
    "tilt": 6.144145559063083E-15,
    "roll": 0
}