Flight information API

Przegląd

Ten punkt końcowy zwraca publiczne podsumowanie pojedynczego lotu, w tym odnośniki do miniatur wykresów we wszystkich rozmiarach. Wyszukaj lot po jego identyfikatorze w chmurze albo po hashu podpisu, który weryfikator zwraca jako flight_unique_id (ta sama wartość, którą pilot może odczytać z samego pliku dziennika).

To pojedyncze zapytanie indeksowane i nie zwraca żadnych informacji identyfikujących użytkownika: brak konta, numeru seryjnego urządzenia, adresu przesyłania, notatek, obrazów czy współrzędnych startu. Etykieta urządzenia i etykieta zawodnika są dołączane, ponieważ identyfikują wpis, a nie osobę.

Punkt końcowy

Podaj liczbowy id albo hash podpisu. Jeśli podano oba, id ma pierwszeństwo. Zwracane są tylko loty widoczne publicznie.

Parametry

Odpowiedź

API zwraca JSON. Podstawowe pola barometryczne są obecne dla każdego lotu. Loty z IMU (Mercury lub Nano w wersji sprzętowej 4 i nowszej) zawierają też obiekt imu z danymi przyspieszenia, orientacji, obrotu, stabilności i podwójnego wyrzutu. Loty Mercury zawierają dodatkowo obiekt mercury z dodatkowymi danymi czujników i otoczenia (zewnętrzna sonda temperatury, bateria, temperatura płytki), które rejestruje tylko ta płytka. Loty wyłącznie barometryczne pomijają bloki IMU i Mercury.

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

Lot wyłącznie barometryczny (na przykład Nano poniżej wersji 4) zwraca te same podstawowe pola z has_imu równym 0 i 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"
  }
}

Jeśli żaden lot publiczny nie pasuje do podanego id lub hasha:

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

Pola odpowiedzi

Wszystkie pomiary są zwracane w podstawowych jednostkach SI: wysokości w metrach, prędkości w metrach na sekundę, przyspieszenia w g, kąty w stopniach, obrót i tempa w stopniach na sekundę, a czasy w milisekundach, o ile nie zaznaczono inaczej. Strona lotu może je wyświetlać przeliczone na wybrane jednostki, ale API zawsze używa SI.

Podstawowe (każdy lot)

imu (tylko loty z IMU)

Obecne tylko, gdy has_imu wynosi 1. Nieobecne w lotach wyłącznie barometrycznych.

mercury (tylko loty Mercury)

Obecne tylko dla Mercury, który rejestruje dodatkową warstwę czujników i otoczenia, której Nano nie ma. Odczytywane najlepszą metodą z pliku danych lotu, więc starsze oprogramowanie Mercury może zwracać mniej pól, a każde brakujące pole jest po prostu pomijane.

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

Środowisko testowe API

Wpisz publiczny identyfikator lotu (lub hash podpisu) i kliknij Uruchom, aby pobrać jego podsumowanie.