Flight information API

Overzicht

Dit eindpunt geeft een openbare samenvatting van een enkele vlucht terug, inclusief links naar de grafiekminiaturen in elk formaat. Zoek een vlucht op via het cloud-vlucht-id of via de signature-hash die de verifier teruggeeft als flight_unique_id (dezelfde waarde die een piloot uit het logbestand zelf kan aflezen).

Het is een enkele geïndexeerde zoekopdracht en geeft geen gebruikersidentificerende informatie terug: geen account, geen apparaatserienummer, geen uploadadres, geen notities, afbeeldingen of lanceercoördinaten. Het apparaatlabel en het deelnemerslabel zijn wel opgenomen, omdat ze een vermelding identificeren en niet een persoon.

Eindpunt

Geef ofwel het numerieke id of de signature-hash op. Als beide worden gegeven, heeft id voorrang. Alleen openbaar zichtbare vluchten worden teruggegeven.

Parameters

Antwoord

De API geeft JSON terug. Barometrische kernvelden zijn voor elke vlucht aanwezig. Vluchten met IMU (Mercury, of Nano hardwarerevisie 4 en later) bevatten ook een imu-object met versnellings-, oriëntatie-, rotatie-, stabiliteits- en dual-deploy-gegevens. Mercury-vluchten bevatten daarnaast een mercury-object met extra sensor- en omgevingsgegevens (externe temperatuursonde, batterij, boardtemperatuur) die alleen dat board registreert. Alleen-barometrische vluchten laten de IMU- en Mercury-blokken weg.

{
  "success": true,
  "flight": {
    "id": 1234,
    "url": "https://www.altimetercloud.com/nl/flights/1234/",
    "csv_url": "https://www.altimetercloud.com/nl/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/nl/flightdata/4/1234.webp",
      "meters_large": "https://www.altimetercloud.com/nl/flightdata/4/1234_l.webp",
      "feet_small":   "https://www.altimetercloud.com/nl/flightdata/4/1234_ft.webp",
      "feet_large":   "https://www.altimetercloud.com/nl/flightdata/4/1234_l_ft.webp",
      "miles_small":  "https://www.altimetercloud.com/nl/flightdata/4/1234_mi.webp",
      "miles_large":  "https://www.altimetercloud.com/nl/flightdata/4/1234_l_mi.webp",
      "km_small":     "https://www.altimetercloud.com/nl/flightdata/4/1234_km.webp",
      "km_large":     "https://www.altimetercloud.com/nl/flightdata/4/1234_l_km.webp"
    }
  }
}

Een alleen-barometrische vlucht (bijvoorbeeld een Nano onder revisie 4) geeft dezelfde kernvelden terug met has_imu op 0 en zonder imu-blok:

{
  "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"
  }
}

Als geen enkele openbare vlucht overeenkomt met het opgegeven id of de hash:

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

Antwoordvelden

Alle metingen worden teruggegeven in SI-basiseenheden: hoogtes in meters, snelheden in meters per seconde, versnellingen in g, hoeken in graden, rotatie en snelheden in graden per seconde, en tijden in milliseconden tenzij anders vermeld. De vluchtpagina kan deze omgerekend naar uw gekozen eenheden tonen, maar de API is altijd SI.

Kern (elke vlucht)

imu (alleen vluchten met IMU)

Alleen aanwezig wanneer has_imu 1 is. Afwezig bij alleen-barometrische vluchten.

mercury (alleen Mercury-vluchten)

Alleen aanwezig voor Mercury, die een extra sensor- en omgevingslaag registreert die de Nano niet heeft. Wordt met de beste inspanning gelezen uit het databestand van de vlucht, dus oudere Mercury-firmware kan minder velden teruggeven, en elk ontbrekend veld wordt gewoon weggelaten.

"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
}

API-speeltuin

Voer een openbaar vlucht-id (of een signature-hash) in en klik op Uitvoeren om de samenvatting op te halen.