Skip to content

DroneRef

Read-only drone snapshot. Returned by: fleet.drones()

MemberReturnsMeaning
.categorystringAlways "drone"
.idstringStable component id; use with get_component(id) and station/recovery APIs
.namestringDisplay name at snapshot time
.kindstring"drone_small" / "drone_medium" / "drone_large"
.enginestring"electric", "heli", or "" if no thruster mounted
.statusstringSame value set as Drone .status() at snapshot time
.x / .y / .position()number / PositionCoordinates at snapshot time
.current_stationstringStation id, or empty string
.is_dockedbooleanParked at a drone station at snapshot time
.battery_level / .battery_wh / .battery_capacitynumber or NoneElectric charge (fraction / Wh / max Wh); None for heli drones
.oil_level / .oil_tons / .oil_capacitynumber or NoneHeli oil (fraction / tons / max tons); None for electric drones
.is_being_rescuedbooleanRescue active at snapshot time
.rescue_statusstring"none" / "outbound" / "charging" / "carrying" / "returning"

Re-query fleet.drones() for fresh values, or get_component(ref.id) for the live drone API.