Skip to content

Maps Service Overview#

The Maps module provides a visual representation of the current flight path to passengers via periodically updated images. These map visuals are broadcast by the IFE system and are accessible to PED (Passenger Electronic Device) applications during the flight. The service is designed to enhance the passenger experience by offering a real-time view of the aircraft’s position in the air.

Service Objective#

This module allows applications to:

  • Access up-to-date map visuals representing the aircraft's flight progress.

  • Choose the most appropriate image resolution based on device layout or performance needs.

  • Dynamically update the UI with new images as the flight progresses.

Image Resolution Handling#

Before displaying map images, applications can retrieve the list of supported resolutions. This allows them to select and apply the image size best suited for their UI. Developers can also define a custom resolution when needed. If no resolution is set, the system will default to the first available one. Developers can query the current resolution at any time and also monitor for changes in available resolutions during flight. This is helpful in cases where the IFE system may update or adjust available image options.

Receiving Map Updates#

After selecting a resolution, the service allows the app to begin receiving updated map images at regular intervals. These updates reflect real-time flight status and are broadcast throughout the duration of the flight. To update the displayed image, the application listens for change events and sets the latest map image in the UI accordingly.

Stopping Image Updates#

Developers can stop receiving map updates when the feature is no longer needed, such as when the user navigates away from the map screen. It’s also important to handle cases where multiple services might compete for updates; only one instance can receive image broadcasts at a time. If another instance starts, the current one will stop automatically, and a notification will be dispatched to handle this gracefully.

Error Handling#

The system notifies the app when errors occur while retrieving map data. If the connection is interrupted, the service automatically attempts recovery when it reconnects to the server. Apps should observe and respond to these notifications to ensure a smooth user experience.

Version 1.0