How to: Create URLs that link to video at a specific time

Last modified: Wednesday April 05, 2023.

For some systems that integrate with Alta Aware, it can be useful to be able to link to video footage from a specific camera at a specific time and date.

You can achieve this by creating a specific URL that can then be used to access this video.

Prerequisites

  • The person or system that will consume this URL must be configured as an Alta Aware user with at least viewing privileges for the selected camera.
  • You need to know the device that captured the video, and the date, time and timezone for the start of the video footage of interest

Task — Locate the required information

  1. Append /api/v1/findDevices to the end of the Alta Aware deployment URL to locate device information for your cameras.
  2. Using the information for the camera from which to view the video footage, create the URL in the form: <deployment_url>/devices/<device_id>?site=<site_id>&sg=<server_group_id>
  3. Append the following string to the end of the created URL: &maximized&time=, together with the date and time stamp (in ISO8601 format) to the end of the edited URL.

    For example, to show footage from 8:20 (local time) on April 5th, 2023, use &maximized&time=2023-03-22T08:20:00.

    To show footage from 07:20 (UTC) on April 5th, 2023, use &maximized&time=2023-03-22T07:20:00Z.

  4. Use this URL to confirm that the correct video footage has been selected.
  5. Copy the edited URL, and send to the Aware user or to the integrated system that requires this link.