Gaggle Logo

Incoming integrations allow you to send data to Gaggle from other services. This is useful for sending live tracking data, recordings, and other information to Gaggle from other devices. Speak to your device manufacturer or app developer to see if they can integrate with Gaggle.

Live Tracking

POST: https://api.flygaggle.com/incoming/liveTracking
HEADERS:

  • Authorization - Basic access authorization with the username and password supplied by the app to the user

Body

JSON Model

  • sessionId: string - Unique identifier for the current flight/recording session
  • heading: double - The heading of the user in degrees
  • latitude: double - The latitude coordinates
  • longitude: double - The longitude coordinates
  • altitude: double - The altitude above MSL (meters)
  • speed: double - The ground speed (meters per second)
  • reportTimeUtc: string - The time in UTC for the location data (ISO format)
  • battery: double? - The battery percentage of the device (0.0-1.0)
  • windDirection: double? - The current wind direction in degrees
  • flightStatus: int - The current flight status of the user (0 = unknown, 1 = airborne, 2 = onGround)
  • status: int - Additional status that should be set for the user (0 = none, 1 = emergency, 2 = waitingForPickup, 3 = driving)

Example Request:

{
  "sessionId": "12345698",
  "heading": 180.5,
  "latitude": -28.5074,
  "longitude": 27.1278,
  "altitude": 4000.0,
  "speed": 16.5,
  "reportTimeUtc": "2024-05-21T17:00:00Z",
  "battery": 0.75,
  "windDirection": 90.0,
  "flightStatus": 1,
  "status": 0
}

Recording

POST: https://api.flygaggle.com/incoming/recordings?type=igc
HEADERS:

  • Authorization - Basic access authorization with the username and password supplied by the app to the user

Body IGC Content: text/plain - UTF-8

Example Request:

AXNA160699
HFDTEDATE:010524,01
HFPLTPILOTINCHARGE:Sean Wheller
HFCM2CREW2:NIL
HFGTYGLIDERTYPE:Ozone Geo 6
HFGIDGLIDERID:NKN
HFDTMGPSDATUM:WGS84
HFRFWFIRMWAREVERSION:3.0.3+2196
HFRHWHARDWAREVERSION:1.0
HFFTYFRTYPE:Naviter,Oudie N
HFGPSRECEIVER:UBLOX,MAX-M8Q,72,50000
HFPRSPRESSALTSENSOR:BOSCH,BMP390L,9150
HFALGALTGPS:GEO
HFALPALTPRESSURE:ISA
HFCIDCOMPETITIONID:NKN
HFCCLCOMPETITIONCLASS:NKN
HFTZNTIMEZONE:2.0
I023638FXA3940SIU
J020810WDI1113WSP
LXNA::VEHICLE:1
LXNA::ACTIVITY:fly
LXNA::LOGSTART,GSP,VARIO
LXNA::PHASE:onGround
E113616ATS101386
B1136163424129S01914571EA002230023900710
LXNA::AVGSATSNR:33
LXNA::BAT:discharging,84%,3.973V,-882mA
B1136173424129S01914571EA002230023900710
B1136183424129S01914571EA002230023900710
B1136193424129S01914571EA002230023800710
B1136203424129S01914572EA002230023800710
B1136213424129S01914571EA002230023800710
B1136223424129S01914571EA002230023800710
<...rest of IGC>