REST: Camera File API

Have more questions? Submit a request

The Camera File API can be used to fetch information about camera position, sensors, reference and transformation. First, you will need an API Key

Get Camera Information

GET /v1/camfile/<session_or_plan_id>

  • The session_id/plan_id can be obtained by listing your plans (log/id properties)

Returns JSON - Information from camera file

curl "https://public-api.dronedeploy.com/v1/camfile/580fd790d5d264a5d8515a73?api_key={api_key}"
{
    "sensors": [
        {
            "id": 0,
            "label": "DJI - FC300X",
            "type": "frame",
            "model": 2,
            "pixel_width": 0.01263496,
            "pixel_height": 0.01263496,
            "focal_length": 3.610000134,
            "resolution": {
                "width": 500,
                "height": 375
            },
            "calibration": {
                "fx": 282.7244117,
                "fy": 282.7244117,
                "cx": 248.238593,
                "cy": 186.1479231,
                "k1": -0.003484606466,
                "k2": 0.006244951394,
                "k3": 0.006887074802,
                "p1": -0.001797974714,
                "p2": -0.001902062335
            }
        }
    ],
    "cameras": [
        {
            "id": 0,
            "sensor_id": 0,
            "enabled": true,
            "image": "9f322a0d11e77a95288f152a3e48fc21.jpg",
            "reference": {
                "x": -122.4073757,
                "y": 37.771785,
                "z": 51.8,
                "yaw": 3.14159,
                "pitch": -2.18505e-17,
                "roll": -2.17293,
                "enabled": 1.0
            },
            "transform": "-0.5277127357 -0.8448213234 -0.08829609283 4.71166813 -0.8424134819 0.5338493019 -0.07310573368 -5.654401336 0.1088980902 0.03580299228 -0.9934079483 0.7155290009 0 0 0 1",
            "depth": 54.35087585
        },
        {
            "id": 1,
            "sensor_id": 0,
            "enabled": true,
            "image": "dce9c93c9835661e6968f125fb5cd537.jpg",
            "reference": {
                "x": -122.4072513,
                "y": 37.77171964,
                "z": 51.6,
                "yaw": 3.14159,
                "pitch": -2.20594e-17,
                "roll": -2.17468,
                "enabled": 1.0
            },
            "transform": "-0.5367118941 -0.8388475673 -0.09096758481 4.063725897 -0.8371113237 0.5428888279 -0.06720381163 5.598462595 0.1057590394 0.0400809103 -0.9935836886 0.1463723952 0 0 0 1",
            "depth": 53.85559082
        },
        {
            "id": 2,
            "sensor_id": 0,
            "enabled": true,
            "image": "a1b90a0230f6850ee7c476577e90d732.jpg",
            "reference": {
                "x": -122.4070509,
                "y": 37.77161853,
                "z": 51.5,
                "yaw": -3.1406,
                "pitch": -0.00143837,
                "roll": -2.17294,
                "enabled": 1.0
            },
            "transform": "-0.5394024045 -0.83669226 -0.09482145371 3.4221742 -0.8356288769 0.5457636812 -0.06218025734 26.04479669 0.1037758457 0.04569536454 -0.9935504554 -0.9486739827 0 0 0 1",
            "depth": 53.04673386
        },
        {
            "id": 3,
            "sensor_id": 0,
            "enabled": true,
            "image": "158232b091f352d585f7c62d5943f5e0.jpg",
            "reference": {
                "x": -122.406963,
                "y": 37.77156953,
                "z": 51.5,
                "yaw": 3.14159,
                "pitch": -2.01771e-17,
                "roll": -2.15897,
                "enabled": 1.0
            },
            "transform": "-0.5278425188 -0.84432699 -0.09216403526 1.628806522 -0.8427750068 0.5341364041 -0.06654765015 39.65568262 0.1054161435 0.04254686617 -0.9935175896 -1.641433452 0 0 0 1",
            "depth": 52.65577698
        },
        {
            "id": 4,
            "sensor_id": 0,
            "enabled": true,
            "image": "2021cc17c8a75ecc77725d34a9e7a960.jpg",
            "reference": {
                "x": -122.4069086,
                "y": 37.77154194,
                "z": 51.1,
                "yaw": 3.14159,
                "pitch": -1.55561e-17,
                "roll": -2.12058,
                "enabled": 1.0
            },
            "transform": "-0.499769114 -0.86235182 -0.08111825451 0.5466809341 -0.8599955396 0.5051844097 -0.07208594937 42.05779296 0.1031431272 0.03373500601 -0.9940942836 -3.984763606 0 0 0 1",
            "depth": 50.35983658
        },
        {
            "id": 5,
            "sensor_id": 0,
            "enabled": true,
            "image": "58404edd65e98ab5167889aab0cfb177.jpg",
            "reference": {
                "x": -122.4069224,
                "y": 37.77156236,
                "z": 48.3,
                "yaw": 3.14159,
                "pitch": 8.13306e-17,
                "roll": 0.417134,
                "enabled": 1.0
            },
            "transform": "0.9480300453 0.3055834688 0.08864410143 -27.91278405 0.3070222455 -0.9516983897 -0.002741504143 -26.92302973 0.08352469024 0.02981473937 -0.9960595903 -4.258062803 0 0 0 1",
            "depth": 49.56679916
        }
    ],
    "transform": {
        "rotation": "0.8442592077 0.3282693645 -0.4236338213 -0.5359350615 0.5171231619 -0.6673509161 4.665071145e-17 0.7904573738 0.612517053",
        "translation": "-2705415.5851 -4261844.73136 3885478.07418",
        "scale": "1",
        "origin": "-122.407347228,37.7717256521,50.7386885723"
    }
}

Articles in this section

Was this article helpful?
0 out of 0 found this helpful