Live Flight Viewer URL Configuration

1. URL Customization: Understanding the Components & Syntax

The Live Flight Viewer's functionality and display are controlled by specific URL parameters. These dictate what data is shown and how the map initially appears.

Base URL Structure:

https://flysafe.airspacelink.com/?mode=live-flight&apiKey={YOUR_API_KEY}&orgId={YOUR_ORG_ID}&loc={LATITUDE},{LONGITUDE},{ZOOM_LEVEL}z&programId={YOUR_PROGRAM_ID}

• mode: mode=live-flight

  • Function: Specifies the viewer's operational mode. For the Live Flight Viewer, this will always be live-flight, ensuring real-time drone activity is displayed.

  • Value: live-flight

• apiKey: apiKey={YOUR_API_KEY}

  • Function: A unique identifier for authentication, allowing access to Airspace Link services.

• orgId: orgId={YOUR_ORG_ID}

  • Function: Your organization's unique identifier within the Airspace Link platform. This ensures the map displays data specific to the organization.

• loc (Location): loc={LATITUDE},{LONGITUDE},{ZOOM_LEVEL}z

  • Function: Sets the initial geographic center and zoom level of the map. The z suffix for the zoom level is critical. A value of 15 (streets level) is recommended.

  • Example Syntax: loc=42.32718,-83.03792,13z

• programId: programId={YOUR_PROGRAM_ID}

  • Function: Filters data relevant to a specific program. This parameter is required only if multiple organizations belong to a specific program.

2. Retrieving Required Information for Configuration

To configure the custom embed URL, the following details are needed:

• API Key (apiKey) and Organization ID (orgId):

  • Retrieval: Obtain both the unique apiKey and orgId from the Obelix team.

• Map Centering Location (loc):

  • Retrieval: Get the Latitude and Longitude for the initial map location from AirHub Portal's b4ufly widget., the coordinates are displayed with each click on the map.

• Program ID (programId):

  • Retrieval: If applicable (i.e., if multiple organizations belong to a program), the Obelix team will create the specificprogramId.

3. Assemble <iframe> HTML

To configure the <iframe> syntax for embedding, update the src URL with that constructed from the prior steps, adjust the name, height, and width as necessary.

<iframe src="https://flysafe.airspacelink.com/?mode=live-flight&apiKey=???&orgId=org_???&loc=42.32718%2C-83.03792%2C15z&programId=???" 
style="border:0px #ffffff none;" name="Live Flight Viewer" scrolling="no" 
frameborder="1" marginheight="0px" marginwidth="0px" height=600px width="1000px" 
allowfullscreen></iframe>