AeroModel
Documentation
gear
Landing gear position.
Values
| Value | Description |
|---|---|
down (default) | Gear extended (aircraft on ground or final approach) |
up | Gear retracted (aircraft in cruise) |
Accepted aliases for up: false, 0, without, retracted. Anything else → down.
API examples
GET https://api.aeromodel.dash-systems.fr/v1/images/plane?api-key=YOUR_KEY&plane=A320&airline=AF&gear=down
GET https://api.aeromodel.dash-systems.fr/v1/images/plane?api-key=YOUR_KEY&plane=A320&airline=AF&gear=up
Visuals (A320 profile 90°)
gear=down | gear=up |
|---|---|
 |  |
Behavior
- Not all angles support all
gearvalues. Ifgear=upis unavailable for the combination, the API automatically falls back togear=down(and vice versa). - The actually applied gear is exposed in the
x-effective-gearheader. - When a fallback occurs, header
x-fallback-reason: gear-<requested>-unavailable-used-<applied>is returned.
Use cases
| Context | gear |
|---|---|
| Aircraft in flight (sky, cruise) | up |
| Aircraft on ground, taxi, ready for takeoff | down |
| Marketing / product card | down (more recognizable) |
| Takeoff / landing animation | mix per frame |