# 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.&#x20;
* Program ID (`programId`):
  * Retrieval: If applicable (i.e., if multiple organizations belong to a program), the Obelix team will create the specific`programId`.

### 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.

{% code overflow="wrap" %}

```html
<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>
```

{% endcode %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.airspacelink.com/integrations-setup-and-customizations/live-flight-viewer-url-configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.