AeroModel

AeroModel

Documentation

pitch

Nose-up or nose-down inclination, composed on the fly.

Values

pitch is a number in degrees between -45 and 45.

ValueDescriptionTypical case
0 (default)No rotationStandard view
> 0 (up to 45)Nose-upTakeoff, climb
< 0 (down to -45)Nose-downFinal approach, descent

Legacy aliases still accepted: none → 0, up45 → 45, down45 → -45, up → 25, down → -25.

The rotation is applied around the fuselage center. The image stays framed within the requested canvas (the aircraft is shrunk if rotation makes it overflow).

API examples

GET https://api.aeromodel.dash-systems.fr/v1/images/plane?api-key=YOUR_KEY&plane=A320&airline=AF&angle=90&pitch=0
GET https://api.aeromodel.dash-systems.fr/v1/images/plane?api-key=YOUR_KEY&plane=A320&airline=AF&angle=90&pitch=15
GET https://api.aeromodel.dash-systems.fr/v1/images/plane?api-key=YOUR_KEY&plane=A320&airline=AF&angle=90&pitch=45
GET https://api.aeromodel.dash-systems.fr/v1/images/plane?api-key=YOUR_KEY&plane=A320&airline=AF&angle=90&pitch=-30
GET https://api.aeromodel.dash-systems.fr/v1/images/plane?api-key=YOUR_KEY&plane=A320&airline=AF&angle=90&pitch=-45

Visual examples

pitch=0 (none)pitch=15pitch=45pitch=-30pitch=-45
pitch=0pitch=15pitch=45pitch=-30pitch=-45

On-the-fly composition

  • The Worker decodes the source PNG, applies bilinear 2D rotation, re-encodes to PNG.
  • Cost: +50-150 ms on the first hit, then edge cache HIT.
  • Response header: x-compose-pitch: 20.
  • If filetype=jpg or webp is requested together with pitch, the output is forced to PNG (header x-format-coerced: png).

Recommended combinations

ScenarioCombo
Marketing takeoffangle=90&gear=up&pitch=15
Final approachangle=90&gear=down&pitch=-10
"In flight" heroangle=345&gear=up&pitch=10

Limits

  • pitch has no effect on angle=top (top-down view).
  • At angles 0 and 180 (front/rear), the effect is subtle because the perspective doesn't show the profile.

Errors

GET https://api.aeromodel.dash-systems.fr/v1/images/plane?api-key=YOUR_KEY&plane=A320&pitch=120&format=json
→ 400 { "error": "invalid compose options", "details": ["pitch must be a number between -45 and 45"] }

See also