Flight information API

Přehled

Tento koncový bod vrací veřejný souhrn jednoho letu, včetně odkazů na náhledy grafů ve všech velikostech. Let vyhledejte buď podle jeho cloudového ID letu, nebo podle hashe podpisu, který ověřovač vrací jako flight_unique_id (stejná hodnota, kterou si pilot může přečíst přímo ze souboru záznamu).

Jde o jediný indexovaný dotaz, který nevrací žádné údaje identifikující uživatele: žádný účet, sériové číslo zařízení, adresu nahrání, poznámky, obrázky ani souřadnice startu. Štítek zařízení a štítek soutěžícího jsou zahrnuty, protože identifikují záznam, nikoli osobu.

Koncový bod

Zadejte buď číselné id, nebo hash podpisu. Pokud zadáte obojí, má přednost id. Vracejí se pouze veřejně viditelné lety.

Parametry

Odpověď

API vrací JSON. Základní barometrická pole jsou přítomna u každého letu. Lety s IMU (Mercury nebo Nano s hardwarovou revizí 4 a novější) navíc obsahují objekt imu s daty zrychlení, orientace, rotace, stability a dvojitého vypuštění. Lety Mercury navíc obsahují objekt mercury s dalšími daty senzorů a prostředí (externí teplotní sonda, baterie, teplota desky), která zaznamenává pouze tato deska. Pouze barometrické lety bloky IMU a Mercury vynechávají.

{
  "success": true,
  "flight": {
    "id": 1234,
    "url": "https://www.altimetercloud.com/cz/flights/1234/",
    "csv_url": "https://www.altimetercloud.com/cz/flightdata/4/1234.csv",
    "device": "nanov1",
    "firmware": "1.52",
    "revision": "4",
    "has_imu": 1,
    "tag": "MY-NANO",
    "competitor_tag": "C-07",
    "uploaddate": "10/06/26-14:22:01",
    "uploadstamp": 1781453721,
    "samples": 3210,
    "sps": 100,
    "apogee": 246.4,
    "apogee_time": 5210,
    "max_velocity": 98.3,
    "max_velocity_down": -12.4,
    "velocity_landing": 4.8,
    "landing_ms": 41800,
    "landing_m": 1.2,
    "flight_time": 41.8,
    "total_time": 44.2,
    "lockouts": 0,
    "not_real_flight": 0,
    "settings": {
      "sealevel": 1013.25,
      "samplerate": 100,
      "recordingstop": 1,
      "oversampling": 1,
      "iirfilter": 0,
      "pressurefilter": 1,
      "startuplock": 0,
      "usetemp": 1,
      "fixedtemp": 15,
      "launchdetect": 1,
      "sampleratio": 1,
      "maintainpower": 0,
      "maxsamples": 0,
      "recording_alt": 0,
      "units": 0,
      "units_velocity": 0,
      "units_acceleration": 0,
      "lockout_time": 0,
      "lockout_change": 0,
      "output_enable": 0,
      "orientation": 0,
      "launchprotection": 1
    },
    "imu": {
      "burnout": 1400,
      "ejection": 5600,
      "max_acceleration": 11.6,
      "acceleration": {
        "max_ascent": 11.6,
        "max_descent": 2.3,
        "max_burn": 11.6,
        "avg_ascent": 4.2,
        "avg_burn": 9.8
      },
      "velocity": {
        "burnout": 96.2,
        "descent": 5.1,
        "up_imu": 96.2,
        "down_imu": -11.8
      },
      "orientation": {
        "launch_pitch": 2,
        "launch_roll": 1,
        "launch_yaw": 0,
        "launch_tilt": 3,
        "max_tilt": 7
      },
      "spin": {
        "max": 540.5,
        "average": 120.2,
        "roll_rate": 33,
        "coning_rate": 4,
        "coning_power": 2
      },
      "stability": {
        "score": 92,
        "launch": 88,
        "coning": 95,
        "straight": 90,
        "confidence": 1,
        "thrust_straight": 97,
        "launch_tilt": 3
      },
      "dual_deploy": {
        "detected": 1,
        "drogue_velocity": 18.2,
        "main_velocity": 6.4,
        "main_altitude": 120.5,
        "main_time": 30200
      }
    },
    "thumbnails": {
      "meters_small": "https://www.altimetercloud.com/cz/flightdata/4/1234.webp",
      "meters_large": "https://www.altimetercloud.com/cz/flightdata/4/1234_l.webp",
      "feet_small":   "https://www.altimetercloud.com/cz/flightdata/4/1234_ft.webp",
      "feet_large":   "https://www.altimetercloud.com/cz/flightdata/4/1234_l_ft.webp",
      "miles_small":  "https://www.altimetercloud.com/cz/flightdata/4/1234_mi.webp",
      "miles_large":  "https://www.altimetercloud.com/cz/flightdata/4/1234_l_mi.webp",
      "km_small":     "https://www.altimetercloud.com/cz/flightdata/4/1234_km.webp",
      "km_large":     "https://www.altimetercloud.com/cz/flightdata/4/1234_l_km.webp"
    }
  }
}

Pouze barometrický let (například Nano pod revizí 4) vrací stejná základní pole s has_imu rovným 0 a bez bloku imu:

{
  "success": true,
  "flight": {
    "id": 980,
    "device": "nanov1",
    "firmware": "1.52",
    "revision": "2",
    "has_imu": 0,
    "apogee": 312.7,
    "apogee_time": 6120,
    "max_velocity": 104.5,
    "...": "core fields and settings, but no imu block"
  }
}

Pokud žádný veřejný let neodpovídá zadanému id nebo hashi:

{
  "success": false,
  "error": {
    "code": "404",
    "message": "No public flight found for that id or signature hash"
  }
}

Pole odpovědi

Všechny hodnoty se vracejí v základních jednotkách SI: výšky v metrech, rychlosti v metrech za sekundu, zrychlení v g, úhly ve stupních, rotace a tempa ve stupních za sekundu a časy v milisekundách, není-li uvedeno jinak. Stránka letu je může zobrazit převedené do vámi zvolených jednotek, ale API vždy používá SI.

Základní (každý let)

imu (pouze lety s IMU)

Přítomné pouze, když je has_imu rovno 1. U pouze barometrických letů chybí.

mercury (pouze lety Mercury)

Přítomné pouze u Mercury, který zaznamenává další vrstvu senzorů a prostředí, kterou Nano nemá. Čteno s nejlepším úsilím z datového souboru letu, takže starší firmware Mercury může vrátit méně polí a jakékoli chybějící pole je jednoduše vynecháno.

"mercury": {
  "mt1_temp_c": 16,
  "battery_start_pct": 98,
  "battery_end_pct": 95,
  "board_temp_start_c": 13.02,
  "board_temp_end_c": 12.25,
  "recovered": 0
}

Testovací prostředí API

Zadejte veřejné ID letu (nebo hash podpisu) a kliknutím na Spustit načtěte jeho souhrn.