Přeskočit na hlavní obsah

Accessing Historical Telemetry

This detailed guide will show you how to retrieve flight data from our API after completing flights with your Dronetag devices.

There are two main approaches depending on what flight details you have. You can either retrieve a list of past flights, select one, and gather all available data for that specific flight, or if you only know the general time frame and location, you can pull a segment of the airspace history. Both options are supported via our REST API.

Retrieving Telemetry for a Single Flight​

This method allows you to retrieve the full telemetry history for one specific flight from a single device. The API response will provide data collected by that device.

  1. Authenticate Your API Requests​

    Before proceeding, ensure you have access to the necessary resources. Visit the authentication guide for instructions on how to authenticate your API requests.

  2. List Available Flights​

    get/v1/flights/ see API docs »

    Retrieve a list of available flights associated with your authenticated Dronetag account. Take note of the id of the flight you’re interested in.

  3. Request the Flight's Telemetry Data​

    get/v2/airspace/telemetry/ua see API docs »

    Use the flight’s id as the operation_id query parameter. This will give you the telemetry data for the selected flight without needing to specify time ranges or geographical areas.

    Our telemetry endpoints support multiple output formats. Choose your preferred format and set it in the Accept header of your request.

    You can also access additional telemetry streams for tracking the UA operator or the RID system.
    For more details, check out the DUMP guide.

    Note

    You may notice a /v1/flights/{id}/telemetry endpoint. However, we recommend using the v2 endpoint, as v1 is planned for deprecation.

Retrieving Airspace History​

This method allows you to pull historical airspace data for a defined location and time period.

  1. Authenticate Your API Requests​

    Ensure you have access to the necessary resources. Visit the authentication guide for instructions on how to authenticate your API requests.

  2. Choose Your Parameters​

    Based on the information you have, you can retrieve airspace history by either:

    • Specifying a time range (from, to) and geographical region (bbox), or
    • Specifying a time range (from, to) and UAS ID (device serial number, uas_id).

  3. Request the Airspace Telemetry Data​

    get/v2/airspace/telemetry/ua see API docs »

    Select your preferred output format and set it in the Accept header of your request.

    You can also access additional telemetry streams for tracking the UA operator or the RID system.
    Learn more about these telemetry types in the DUMP guide.

  4. Request Operation Details​

    get/v2/airspace/operation/{operation_id} see API docs »

    While the previous request provides telemetry data, it does not include all the information about the flight, such as the UA's identification and type. To gather additional details, use the Operation API endpoint to retrieve more comprehensive operation information.